Загружайте филиалы сначала в отдельный проверяемый набор. Сопоставьте записи по постоянному ID, проверьте координаты и покажите отчёт изменений до переключения карты. Если импорт обрывается на середине, опубликованный набор должен остаться целым. Построчная замена действующих меток делает временную ошибку видимой посетителям.

Начните с согласования значения отсутствующей строки. Полный снимок справочника и файл изменений — разные форматы: в первом отсутствие филиала может означать закрытие, во втором оно ничего не означает. Не удаляйте действующие офисы только потому, что очередной файл оказался неполным.

Как выглядит договор на входной файл

ПолеПравило проверкиПочему нужно
branch_idНепустой уникальный IDСвязь с предыдущей версией
latitude / longitudeЧисла и согласованный порядокПравильная точка
addressПубличный адрес с проверенным входомСверка метки человеком
activeЯвное состояниеОтличие закрытия от пропуска

Переименование офиса не должно создавать новый ID. Не используйте номер строки: после сортировки он укажет на другой филиал. Если исходная система не выдаёт ключ, создайте таблицу соответствий и поддерживайте её отдельно. Совпадение координат само по себе не доказывает дубль — два подразделения могут работать в одном здании.

Одна точка, два порядка координат

В GeoJSON первые два числа позиции идут в порядке долгота, широта по RFC 7946. А отдельные API карт могут принимать другой порядок. Преобразование должно происходить в одном явно названном месте. Проверка диапазонов выявит часть ошибок, но перестановка двух допустимых значений может пройти её; дополнительно сверяйте точку с адресом на предварительной карте.

{
  "type": "Feature",
  "id": "demo-branch-a",
  "geometry": {
    "type": "Point",
    "coordinates": [30.0, 60.0]
  },
  "properties": {"name": "Условный филиал"}
}

Это демонстрационные координаты, не адрес настоящего офиса. Строки с пустой геометрией выделяйте в отчёте, а не переносите в нулевую точку. Если координаты получают геокодированием, сохраняйте статус проверки адреса: результат поиска по названию улицы ещё не подтверждает вход в нужное здание. Спорные адреса должен подтвердить ответственный за справочник.

Пробный прогон должен объяснять изменения

  1. Проверить структуру и обязательные поля без записи в рабочий набор.
  2. Посчитать новые, изменённые, неизменные и отклонённые ID.
  3. Отдельно вывести исчезнувшие ID для полного снимка.
  4. Сверить несколько перемещённых точек по адресам.
  5. Одобрить версию только после устранения блокирующих ошибок.

Счётчики должны сходиться с числом входных записей по заранее описанным категориям. Два одинаковых ID внутри файла — конфликт, который нельзя молча решить правилом «последняя строка победила». Повторная загрузка идентичного снимка не создаёт новые филиалы. Отчёт хранит номер версии и причину отклонения, без служебных секретов исходной системы.

Переключение и обратный путь

После проверки переключите указатель опубликованной версии как одну согласованную операцию. Способ зависит от хранилища; этот принцип не означает, что любой набор файлов можно заменить транзакцией базы. Запретите параллельным заданиям публиковать более старый снимок поверх нового и храните последнюю одобренную версию для возврата.

На тестовой карте сравните количество офисов в списке и уникальных ID в данных, откройте карточки новых и перемещённых точек. Прервите импорт до переключения: карта должна продолжить показывать прошлый набор. Затем повторите тот же файл и убедитесь, что появились только ожидаемые изменения, без новых дублей.

Для подготовки импорта достаточно обезличенного образца файла, описания ID и решения о полном снимке или изменениях. Добавьте перечень спорных адресов и критерий отклонения пакета. На этой основе можно сделать загрузку проверяемой и восстановимой, не используя посетителей сайта как тестировщиков нового справочника.

Проверенные источники