Когда метка после сохранения оказывается в другом городе, сравните широту и долготу до записи и после чтения. Значения могут быть корректными числами, но стоять в обратном порядке. Выберите точку с известным местом, запишите поля lat и lon по именам и проведите её через геокодер, серверный объект, базу и карту.
Проверка диапазонов обнаруживает только часть ошибок. Оба числа могут укладываться и в диапазон широты, и в диапазон долготы, поэтому перестановка останется формально допустимой. Нужен контроль ожидаемой области и явный договор о порядке осей на каждой границе. У разных API порядок массива может различаться.
Условная точка проходит через именованные поля
// условная контрольная точка
{"lat": 55.75, "lon": 37.62}
// GeoJSON: сначала долгота, затем широта
{"type":"Point","coordinates":[37.62,55.75]}
-- PostGIS: X = longitude, Y = latitude
SELECT ST_SetSRID(ST_MakePoint(37.62,55.75),4326);RFC 7946 определяет порядок GeoJSON как longitude, latitude и использует WGS 84 с десятичными градусами. PostGIS ST_MakePoint принимает X и Y; для географических координат X соответствует долготе, Y — широте. Пример показывает согласование двух интерфейсов. Порядок другого картографического SDK нужно взять из его документации, а не переносить из GeoJSON автоматически.
Находим первую границу с изменением
| Граница | Что сравнить | Признак ошибки |
|---|---|---|
| геокодер → DTO | имена полей и исходный ответ | lat присвоено из longitude |
| DTO → SQL | параметры подготовленного запроса | аргументы поменяли местами |
| SQL → API | SRID и единицы | метры выданы за градусы |
| API → карта | порядок массива SDK | frontend повторно перевернул оси |
| повторное сохранение | точность и тип поля | числа округлились или стали строкой |
Лог для теста должен содержать технический ID и координаты выбранной публичной точки. Не записывайте точные адреса клиентов ради отладки. Сравнивайте исходные числа, а не округлённую подпись в интерфейсе. Если в базе всё верно, а карта рисует неверно, дальнейший импорт адресов только увеличит число корректных записей с неправильным отображением.
SRID описывает систему, преобразование меняет числа
ST_SetSRID назначает геометрии метаданные системы координат и не преобразует сами координаты. Если исходные значения выражены в метрах другой проекции, установка 4326 не превратит их в широту и долготу. Для преобразования используется подходящая операция трансформации с правильно указанной исходной системой. Сначала установите происхождение данных, затем выбирайте преобразование.
- широта находится в диапазоне от −90 до 90 градусов;
- долгота находится в диапазоне от −180 до 180 градусов;
- оба значения должны быть конечными числами;
- пустое поле не заменяется молча на ноль;
- единицы и система координат фиксируются в контракте;
- точность хранения выбирается под задачу и проверяется после round trip.
Исправление парсера и старых точек — две операции
Сначала исправьте источник новой ошибки и добавьте тест на известную точку. Затем найдите повреждённые записи по версии импорта, времени и доказанному маршруту данных. Массовый swap всех lat/lon опасен: часть записей могла прийти через другой путь и быть правильной. До изменения сохраните исходные значения и сформируйте пробный diff.
Для спорной записи повторное геокодирование может помочь, но результат зависит от качества адреса и выбранного кандидата. Не подменяйте координаты только потому, что новая точка выглядит ближе. Сохраните качество совпадения, источник и причину изменения; неоднозначные адреса отправьте на ручную проверку.
Контрольный набор выходит за пределы одного города
- Выбрать несколько публичных точек с разными знаками координат.
- Добавить точку, у которой перестановка осей остаётся в допустимых диапазонах.
- Проверить сериализацию GeoJSON и адаптер выбранного SDK.
- Сохранить и прочитать числа, сравнив допустимую точность.
- Повторить импорт и убедиться, что оси не переставляются второй раз.
Версия адаптера и источник координат помогают отличить новые данные от старых при исправлении. Откат возвращает сохранённые исходные значения только затронутой выборке. Для расследования достаточно одного обезличенного ответа геокодера, схемы DTO, SQL-параметров, сохранённой геометрии с SRID и объекта, переданного карте. Эта цепочка показывает точное место перестановки или неверного преобразования.