Из Google Maps убрали DrawingManager: как восстановить редактор зон доставки

Редактор зон доставки на карте: сохранённые границы, новая схема рисования и серверная проверка

Карта на сайте открывается, сохранённые зоны видны, а кнопка «Нарисовать зону» перестала работать. Разбираем, что именно отключил Google, как отличить поломку отображения от поломки редактора и как заменить компонент, не потеряв координаты, тарифы и правила распределения заявок.

Статья носит информационный характер и не является юридической, налоговой или иной профессиональной консультацией. Сведения актуальны на дату публикации (октябрь 2026 года): условия работы сервисов и требования законодательства могут измениться. Перед принятием решений сверяйтесь с первоисточниками и при необходимости обращайтесь к профильным специалистам.

Коротко

  • В Maps JavaScript API библиотека Drawing (класс google.maps.drawing.DrawingManager) объявлена устаревшей в августе 2025 года и недоступна с мая 2026 года. Google прямо предлагает перейти на альтернативы, например на Terra Draw [1]. В журнале изменений удаление зафиксировано в сборке 3.65.3b от 4 июня 2026 года [2].
  • Сама карта, полигоны google.maps.Polygon, их редактирование мышью (editable: true) и библиотека Geometry продолжают работать [3][4]. Сломался конкретный инструмент рисования новых фигур.
  • Временный обходной путь — зафиксировать версию 3.64, где Drawing ещё был. Но номерные версии удаляются по квартальному графику, а при запросе недоступной версии API молча отдаёт канал по умолчанию [5]. Это отсрочка, а не решение.
  • Надёжная замена — отдельный слой рисования (Google сам показывает пример на Terra Draw [6]) плюс собственная проверка геометрии на сервере: замкнутость колец, порядок координат, отсутствие самопересечений, корректные дыры, конфликты между зонами и детерминированное правило для адресов на границе.
  • Для российских компаний отдельный вопрос — сам доступ к Google Maps Platform и трансграничная передача персональных данных. Об этом и о российских альтернативах — в разделе «Российская специфика».
  • Ниже — модуль проверки и 10 автотестов на Node.js и Turf.js, которые можно встроить в CI.

Что произошло и почему это касается именно бизнес-интерфейса

Многие службы доставки, рестораны, интернет-магазины и сервисные компании годами держали в админке одну и ту же схему: менеджер открывает карту Google, выбирает инструмент «многоугольник», обводит район, указывает тариф и сохраняет. Под капотом часто стоял DrawingManager — готовый графический интерфейс, позволявший рисовать на карте многоугольники, прямоугольники, линии, круги и маркеры [7]. После завершения фигуры он генерировал события вроде polygoncomplete и overlaycomplete, из которых код забирал координаты [7].

Google предупреждал заранее. На странице библиотеки Drawing указано, что функциональность объявлена устаревшей в августе 2025 года и будет убрана в версии Maps JavaScript API, выходящей в мае 2026 года [7]. В разделе устаревших возможностей Drawing теперь перенесён в список завершённых: библиотека больше не поддерживается и недоступна с мая 2026 года, а приложениям, которые на неё опираются, нужно перейти на альтернативы [1].

Хронология по журналу изменений:

  • 28 августа 2025, версия 3.62.2c — Drawing Library объявлена устаревшей [2].
  • 20 мая 2026, версия 3.65.1c — выход ветки 3.65; в ней же выведены из эксплуатации Heatmap Layer и 45° снимки для растровых карт [2].
  • 4 июня 2026, версия 3.65.3b — функциональность DrawingManager больше недоступна [2].

Обратите внимание: в той же квартальной волне Google убрал тепловые карты и наклонные снимки [1][2], а с апреля 2026 года объявлен устаревшим KmlLayer [1]. Если в вашем продукте есть что-то из этого списка, проверяйте сразу всё.

Как отличить «карта не работает» от «не работает редактор»

Перед тем как что-то переписывать, нужно понять масштаб проблемы. Признаки разные.

Признаки, что сломан только редактор

  1. Карта загружается, подложка и элементы управления на месте.
  2. Сохранённые зоны отображаются: они рисуются классом google.maps.Polygon, для которого библиотека Drawing не нужна [3].
  3. Панель с инструментами рисования не появляется или появляется пустой.
  4. В консоли браузера — ошибка, например Cannot read properties of undefined (reading 'DrawingManager') (точная формулировка зависит от браузера и кода): пространство имён google.maps.drawing больше не создаётся.
  5. Если в загрузчике указан параметр libraries=drawing [7], это прямой индикатор зависимости.

Признаки более серьёзной проблемы

  • Карта не загружается вовсе или показывает служебное сообщение об ошибке — это ключ, биллинг, ограничения домена или CSP, а не Drawing.
  • Не отображаются уже сохранённые зоны — проблема в коде загрузки данных или в формате координат.

Быстрая самодиагностика

Откройте админку, консоль разработчика и выполните:

Диагностика редактора зон: карта работает, DrawingManager недоступен, данные зон сохранены
Сначала разделите три вопроса: отображается ли карта, доступен ли старый редактор и сохранились ли зоны с тарифами.
console.log(google.maps.version);          // какая версия реально загружена
console.log(typeof google.maps.drawing);   // 'undefined' — библиотеки нет
console.log(typeof google.maps.Polygon);   // 'function' — полигоны живы

Свойство google.maps.version Google рекомендует использовать для отладки, чтобы узнать фактически загруженную версию [5].

Что продолжает работать и можно использовать уже сегодня

Хорошая новость: редактировать существующие зоны можно без Drawing. Любой полигон становится редактируемым при editable: true — на нём появляются маркеры вершин, которые можно двигать мышью [3]. Изменения отслеживаются событиями insert_at, remove_at и set_at, которые нужно повесить на каждый путь полигона [3]. Важно помнить, что правки пользователя не сохраняются сами — их нужно забрать и записать в базу [3].

Поэтому иногда разумный первый шаг — быстро вернуть менеджерам возможность двигать границы существующих зон, а создание новых временно делать копированием и редактированием шаблона. Это даёт время спокойно выбрать полноценную замену.

Временный откат на версию 3.64: когда допустим и чем опасен

Политика Google такая: устаревшая функция остаётся доступной, пока доступна последняя поддерживающая её версия SDK, а для перехода на следующую мажорную версию функцию нужно убрать из кода [1]. Drawing удалён в ветке 3.65 [2], значит, в 3.64 он должен присутствовать. На момент подготовки статьи по номеру можно запросить версии 3.66, 3.65, 3.64 и 3.63; после середины ноября 2026 года останутся 3.67–3.64, а 3.63 будет удалена [5].

Риски отката:

  • Срок. По графику Google номерные версии удаляются каждый квартал [5]. Значит, и версия 3.64 будет удалена при одной из ближайших ротаций; точную дату нужно отслеживать на странице версий.
  • Молчаливая подмена. При запросе недоступной версии вы получаете канал по умолчанию, без явной ошибки [5]. В день удаления 3.64 редактор снова сломается — без предупреждения.
  • Без исправлений. Старые номерные версии не получают еженедельных обновлений с исправлениями ошибок, только возможные исправления безопасности [5].
  • Отставание остального кода. Вы теряете исправления и новые возможности, которые приходят в актуальные ветки.

Сама Google описывает откат на старую версию как временную меру, которая даёт обычно три–шесть месяцев на доработку приложения [5].

Если вы всё же откатываетесь, проверьте на тестовом стенде, что google.maps.drawing действительно определён в загруженной версии, и поставьте задачу на полноценную замену с конкретным сроком.

Из чего на самом деле состоит «редактор зон»

DrawingManager закрывал только рисование. Вокруг него в любой рабочей системе есть ещё несколько слоёв, и при замене важно не потерять ни один.

[Менеджер в админке]
      │  рисует / правит границу
      ▼
[Слой рисования]  ← здесь был DrawingManager
      │  координаты
      ▼
[Проверка геометрии]  замкнутость, порядок, самопересечения, дыры, конфликты
      │
      ▼
[Хранилище зон]  геометрия + тариф + приоритет + активность + версия
      │
      ▼
[Определение зоны по адресу]  геокодирование → точка → зона → тариф / склад / курьер
      │
      ▼
[Заказ, CRM, курьерское приложение, отчёты]

Частое слабое место старых реализаций — проверка геометрии. Среди опций DrawingManager нет средств проверки корректности нарисованной фигуры [7], поэтому её приходилось делать самостоятельно, а нередко её не было вовсе. Миграция — хороший повод закрыть эту дыру.

Варианты замены

Вариант 1. Terra Draw поверх Google Maps

Google опубликовал официальный пример: слой рисования на базе Terra Draw, который работает через OverlayView и позволяет рисовать, редактировать и выбирать полигоны, линии и точки, отдавая результат в виде стандартного GeoJSON [6]. Google отдельно оговаривает, что Terra Draw — сторонний продукт, который компания не поддерживает [6].

Выбор замены DrawingManager: Terra Draw или собственный редактор полигонов
Terra Draw даёт готовые режимы рисования; собственный редактор требует отдельно сделать отмену, проверку и работу на телефоне.

Что важно знать о библиотеке:

  • Лицензия MIT, адаптеры для Leaflet, OpenLayers, MapLibre GL JS, Google Maps JS API, Mapbox GL JS и ArcGIS [8].
  • Режим выбора позволяет перетаскивать вершины, добавлять промежуточные точки и удалять вершины [9]. Для лёгких правок без переключения режима у режима многоугольника есть собственная опция editable [9].
  • Есть встроенные проверки: запрет самопересечений (ValidateNotSelfIntersecting), минимальная и максимальная площадь [9]. Их можно подключить к режиму рисования, чтобы пользователь физически не мог завершить некорректный полигон [9].
  • Есть привязка к вершинам и сторонам соседних фигур того же режима [9] — полезно, чтобы зоны стыковались без щелей.
  • Функция проверки запускается и при программной загрузке через addFeatures, а результат возвращается для каждого объекта [9]. Это удобно для импорта старых зон.

Минимальное подключение по примеру Google [6]:

import { TerraDraw, TerraDrawPolygonMode, TerraDrawSelectMode,
         ValidateNotSelfIntersecting } from "terra-draw";
import { TerraDrawGoogleMapsAdapter } from "terra-draw-google-maps-adapter";

map.addListener("projection_changed", () => {
  const draw = new TerraDraw({
    adapter: new TerraDrawGoogleMapsAdapter({ map, lib: google.maps, coordinatePrecision: 9 }),
    modes: [
      new TerraDrawPolygonMode({
        validation: (feature, { updateType }) =>
          updateType === "finish" || updateType === "commit"
            ? ValidateNotSelfIntersecting(feature)
            : { valid: true },
        snapping: { toLine: true, toCoordinate: true },
      }),
      new TerraDrawSelectMode({
        flags: { polygon: { feature: { draggable: true,
          coordinates: { midpoints: true, draggable: true, deletable: true } } } },
      }),
    ],
  });
  draw.start();
  draw.on("ready", () => draw.setMode("polygon"));
  draw.on("change", () => {
    const features = draw.getSnapshot(); // GeoJSON — отправляем на сервер на проверку
  });
});

Плюсы: быстро, близко к прежнему поведению, готовые режимы и проверки. Минусы: новая внешняя зависимость, за обновлениями которой нужно следить.

Вариант 2. Собственный минимальный редактор на google.maps.Polygon

Если зоны — это только многоугольники, можно обойтись без сторонних библиотек: клик по карте добавляет вершину в путь полигона (Google показывает этот приём на примере полилинии [3]), после замыкания полигон получает editable: true, а изменения ловятся через события пути [3].

Плюсы: нет зависимостей, полный контроль. Минусы: придётся самим сделать отмену действий, удаление вершин, привязку, мобильную поддержку и проверки. Для админки, которой пользуются три человека, это может быть оправдано; для сложного продукта — обычно нет.

Вариант 3. Отвязать редактор от поставщика карт

Terra Draw работает с несколькими картографическими библиотеками через адаптеры [8]. Если зоны хранятся в нейтральном формате GeoJSON, слой рисования можно перенести на другую подложку без переделки данных и бизнес-логики. Для российских компаний это аргумент в пользу архитектуры, где карта — заменяемая деталь, а не ядро системы.

Как выбрать

  • Нужно срочно вернуть работу админки — временно editable для существующих зон, затем Terra Draw.
  • Только многоугольники, мало пользователей — свой редактор на google.maps.Polygon.
  • Несколько типов фигур, привязка, отмена действий — Terra Draw.
  • Возможна смена поставщика карт — Terra Draw + GeoJSON + серверная проверка.
  • Много зон, тысячи заказов в час — любой редактор + проверка и поиск зоны в БД.

Как сохранить координаты при миграции

Порядок координат — главная ловушка

Google Maps работает с объектами {lat, lng}, а GeoJSON хранит позицию как массив, где первым идёт долгота, вторым — широта [10]. Если при переносе перепутать порядок, Москва (55,75° с. ш., 37,6° в. д.) превращается в точку на севере Ирана (37,6° с. ш., 55,75° в. д.). Ошибка не выдаёт себя: полигон валиден, просто лежит не там.

Порядок координат Google Maps и GeoJSON: широта-долгота против долгота-широта
При обмене с GeoJSON проверяйте порядок координат на контрольной точке, а не только валидность полигона.

Защита: явная функция преобразования, автотест на неё и простая эвристика «координаты должны попадать в ожидаемую страну» — если пара выпадает из рамки, а после перестановки попадает, это почти наверняка перепутанный порядок.

Замыкание колец

В GeoJSON кольцо многоугольника — замкнутая линия минимум из четырёх позиций, первая и последняя совпадают [10]. В Google Maps замыкать путь не обязательно: API сам дорисует последнюю сторону [3]. Значит, при выгрузке из старого редактора последнюю точку часто приходится добавлять, а при обратной загрузке — убирать.

Направление обхода и отверстия

Здесь разные системы живут по разным правилам:

  • В Google Maps, чтобы получить дыру, внутренний путь должен идти в обратном направлении относительно внешнего [3]. Слой Data делает это за вас [3].
  • В GeoJSON действует правило правой руки: внешнее кольцо — против часовой стрелки, дыры — по часовой [10]. Однако из соображений совместимости парсерам не рекомендуется отвергать полигоны с другим обходом [10].

Практический вывод: нормализуйте обход при сохранении (в Turf.js для этого есть rewind) и не полагайтесь на то, что «чужие» данные его соблюдают.

Точность

Шесть знаков после запятой в градусах — это около 10 см, а увеличение точности до 15 знаков может почти вдвое раздуть размер данных [10]. Для зон доставки шести-семи знаков достаточно. Округлять лучше один раз при сохранении, а не при каждом отображении, иначе соседние зоны могут разойтись на сантиметры и образовать щель.

Чек-лист переноса данных

  1. Выгрузите все зоны из текущей БД вместе с тарифами, приоритетами, флагами активности и датами.
  2. Сохраните исходную выгрузку неизменной — это эталон для сверки.
  3. Преобразуйте в GeoJSON через одну функцию, покрытую тестами.
  4. Прогоните проверку геометрии по каждой зоне и по парам зон.
  5. Сверьте результат на выборке реальных адресов: старая логика и новая должны назначать одинаковые зоны.
  6. Расхождения разберите вручную — часто это реальные ошибки старых данных.

Тарифные зоны и правила распределения заявок

Геометрия — только половина зоны. Вторая половина — атрибуты, от которых зависят деньги и логистика:

  • идентификатор и человекочитаемое название;
  • тариф или ссылка на тарифный план, минимальная сумма заказа;
  • склад, филиал или пул курьеров;
  • приоритет (для вложенных зон, например «экспресс» внутри «города»);
  • флаг активности и период действия;
  • версия и автор изменения.

Храните геометрию и атрибуты вместе, но версионируйте изменения границ: если тариф заказа рассчитан по зоне, которую потом поменяли, через полгода вы не сможете объяснить клиенту или бухгалтерии, почему сумма была именно такой.

Правило для спорных адресов

Нужно заранее ответить на три вопроса:

  1. Точка на границе — внутри или снаружи? Функции разных библиотек ведут себя по-разному. В Google containsLocation возвращает true и для точки внутри, и для точки на ребре [4]. В Turf.js booleanPointInPolygon по умолчанию тоже учитывает границу, но это меняется опцией ignoreBoundary [11]. В PostGIS ST_Contains не считает границу частью полигона, а ST_Covers считает, и документация рекомендует в общем случае использовать именно ST_Covers [12].
  2. Точка в двух зонах сразу — какая побеждает? Решает приоритет; при равном приоритете — стабильное правило (например, меньший идентификатор), а не порядок загрузки из базы.
  3. Точка вне всех зон — отказ в доставке, ручная обработка или ближайшая зона?

Если на фронтенде одна библиотека, а на сервере другая, ответ на первый вопрос должен совпадать в обеих. Иначе клиент увидит на сайте один тариф, а в заказе окажется другой.

Где определять зону

Окончательное решение лучше принимать на сервере: туда приходит точка после геокодирования, там лежит актуальная версия зон, там же пишется журнал. Для больших объёмов удобно хранить зоны в PostgreSQL с PostGIS: функция ST_Covers автоматически использует пространственный индекс [12]. Важное предупреждение из документации: с невалидной геометрией результаты непредсказуемы [12] — ещё один аргумент за обязательную проверку при сохранении.

Серверная проверка зоны доставки: адрес, координаты, версия зоны, тариф и журнал решения
Сайт и сервер должны одинаково трактовать границу; цену заказа лучше фиксировать с версией зоны.

Автотесты: пересечения, отверстия, порядок координат, попадание адреса

Ниже — модуль, не зависящий от карты: он работает с GeoJSON и может использоваться и в браузере, и на сервере. Используются Turf.js 7 и встроенный в Node.js тест-раннер.

Модуль проверки zones.mjs

import * as turf from "@turf/turf";

/** Google Maps отдаёт пути как [{lat, lng}], GeoJSON хранит [lng, lat]. */
export function fromGooglePaths(paths) {
  const rings = paths.map((path) => {
    const ring = path.map((p) => [p.lng, p.lat]);
    const [f, l] = [ring[0], ring[ring.length - 1]];
    if (f[0] !== l[0] || f[1] !== l[1]) ring.push([...f]); // замыкаем кольцо
    return ring;
  });
  // Внешнее кольцо — против часовой, дыры — по часовой (RFC 7946)
  return turf.rewind(turf.polygon(rings), { reverse: false });
}

/** Обратно — для отрисовки через google.maps.Polygon. */
export function toGooglePaths(feature) {
  return feature.geometry.coordinates.map((ring) =>
    ring.slice(0, -1).map(([lng, lat]) => ({ lat, lng }))
  );
}

/** Эвристика перепутанного порядка для проектов в РФ. */
export function looksSwapped([lng, lat], bbox = [19, 41, 191, 82]) {
  const inside = (x, y) => x >= bbox[0] && x <= bbox[2] && y >= bbox[1] && y <= bbox[3];
  return !inside(lng, lat) && inside(lat, lng);
}

export function validateZone(feature, { minAreaM2 = 1000 } = {}) {
  const errors = [];
  const rings = feature.geometry.coordinates;
  rings.forEach((ring, i) => {
    if (ring.length < 4) errors.push(`кольцо ${i}: меньше 4 позиций`);
    const [f, l] = [ring[0], ring[ring.length - 1]];
    if (f[0] !== l[0] || f[1] !== l[1]) errors.push(`кольцо ${i}: не замкнуто`);
    if (ring.some(([x, y]) => Math.abs(x) > 180 || Math.abs(y) > 90))
      errors.push(`кольцо ${i}: координаты вне диапазона`);
  });
  if (errors.length) return { valid: false, errors };

  if (turf.kinks(feature).features.length > 0) errors.push("самопересечение границы");

  const outer = turf.polygon([rings[0]]);
  const holes = rings.slice(1).map((r) => turf.polygon([r]));
  holes.forEach((h, i) => {
    if (!turf.booleanWithin(h, outer)) errors.push(`дыра ${i + 1} выходит за внешнюю границу`);
  });
  for (let i = 0; i < holes.length; i++)
    for (let j = i + 1; j < holes.length; j++)
      if (turf.booleanIntersects(holes[i], holes[j]))
        errors.push(`дыры ${i + 1} и ${j + 1} пересекаются`);

  if (turf.area(feature) < minAreaM2) errors.push("площадь меньше минимальной");
  return { valid: errors.length === 0, errors };
}

/** Пересечение с ненулевой площадью; касание по границе — не конфликт. */
export function overlapArea(a, b) {
  const x = turf.intersect(turf.featureCollection([a, b]));
  return x ? turf.area(x) : 0;
}

export function findConflicts(zones, { toleranceM2 = 1 } = {}) {
  const out = [];
  for (let i = 0; i < zones.length; i++)
    for (let j = i + 1; j < zones.length; j++) {
      const a = zones[i], b = zones[j];
      if (a.properties.priority === b.properties.priority) {
        const area = overlapArea(a, b);
        if (area > toleranceM2) out.push({ a: a.properties.id, b: b.properties.id, area });
      }
    }
  return out;
}

/** Граница — часть зоны; спор решает приоритет, затем id. */
export function resolveZone([lng, lat], zones) {
  const pt = turf.point([lng, lat]);
  const hits = zones
    .filter((z) => z.properties.active !== false)
    .filter((z) => turf.booleanPointInPolygon(pt, z, { ignoreBoundary: false }))
    .sort((a, b) =>
      b.properties.priority - a.properties.priority ||
      String(a.properties.id).localeCompare(String(b.properties.id))
    );
  return hits[0] ?? null;
}

Набор тестов zones.test.mjs

import { test } from "node:test";
import assert from "node:assert/strict";
import * as turf from "@turf/turf";
import { fromGooglePaths, toGooglePaths, looksSwapped,
         validateZone, findConflicts, resolveZone } from "./zones.mjs";

// Прямоугольник в центре Москвы; путь по часовой, как часто рисуют вручную
const square = [
  { lat: 55.750, lng: 37.600 }, { lat: 55.755, lng: 37.600 },
  { lat: 55.755, lng: 37.610 }, { lat: 55.750, lng: 37.610 },
];
const zone = (paths, props) => ({ ...fromGooglePaths(paths), properties: props });

test("порядок координат: {lat,lng} → [lng,lat]", () => {
  const f = fromGooglePaths([square]);
  assert.deepEqual(f.geometry.coordinates[0][0], [37.6, 55.75]);
  assert.equal(looksSwapped([37.6, 55.75]), false);
  assert.equal(looksSwapped([55.75, 37.6]), true);
});

test("кольцо замыкается, обход по правилу правой руки", () => {
  const ring = fromGooglePaths([square]).geometry.coordinates[0];
  assert.deepEqual(ring[0], ring[ring.length - 1]);
  assert.equal(ring.length, 5);
  assert.equal(turf.booleanClockwise(turf.lineString(ring)), false);
});

test("обратное преобразование без потерь", () => {
  const back = toGooglePaths(fromGooglePaths([square]));
  assert.equal(back[0].length, 4);
  for (const p of square) assert.ok(back[0].some((q) => q.lat === p.lat && q.lng === p.lng));
});

test("попадание не зависит от направления обхода", () => {
  const p = turf.point([37.605, 55.752]);
  assert.equal(turf.booleanPointInPolygon(p, fromGooglePaths([square])), true);
  assert.equal(turf.booleanPointInPolygon(p, fromGooglePaths([[...square].reverse()])), true);
});

test("самопересечение («бантик») отклоняется", () => {
  const bowtie = fromGooglePaths([[
    { lat: 55.750, lng: 37.600 }, { lat: 55.755, lng: 37.610 },
    { lat: 55.755, lng: 37.600 }, { lat: 55.750, lng: 37.610 },
  ]]);
  const r = validateZone(bowtie);
  assert.equal(r.valid, false);
  assert.ok(r.errors.includes("самопересечение границы"));
});

test("точка в дыре не принадлежит зоне", () => {
  const hole = [
    { lat: 55.7515, lng: 37.6030 }, { lat: 55.7535, lng: 37.6030 },
    { lat: 55.7535, lng: 37.6070 }, { lat: 55.7515, lng: 37.6070 },
  ];
  const z = zone([square, hole], { id: "center", priority: 1 });
  assert.equal(validateZone(z).valid, true);
  assert.equal(resolveZone([37.605, 55.7525], [z]), null);
  assert.equal(resolveZone([37.601, 55.7505], [z])?.properties.id, "center");
});

test("дыра за внешней границей — ошибка", () => {
  const badHole = [
    { lat: 55.760, lng: 37.620 }, { lat: 55.761, lng: 37.620 },
    { lat: 55.761, lng: 37.621 }, { lat: 55.760, lng: 37.621 },
  ];
  const r = validateZone(fromGooglePaths([square, badHole]));
  assert.equal(r.valid, false);
  assert.match(r.errors.join(), /выходит за внешнюю границу/);
});

test("пересечение зон — конфликт, касание по границе — нет", () => {
  const a = zone([square], { id: "A", priority: 1 });
  const touching = zone([[
    { lat: 55.750, lng: 37.610 }, { lat: 55.755, lng: 37.610 },
    { lat: 55.755, lng: 37.620 }, { lat: 55.750, lng: 37.620 },
  ]], { id: "B", priority: 1 });
  const overlapping = zone([[
    { lat: 55.750, lng: 37.605 }, { lat: 55.755, lng: 37.605 },
    { lat: 55.755, lng: 37.615 }, { lat: 55.750, lng: 37.615 },
  ]], { id: "C", priority: 1 });
  assert.deepEqual(findConflicts([a, touching]), []);
  const c = findConflicts([a, overlapping]);
  assert.equal(c.length, 1);
  assert.ok(c[0].area > 100_000);
});

test("адрес на общей границе получает зону детерминированно", () => {
  const a = zone([square], { id: "A", priority: 1 });
  const b = zone([[
    { lat: 55.750, lng: 37.610 }, { lat: 55.755, lng: 37.610 },
    { lat: 55.755, lng: 37.620 }, { lat: 55.750, lng: 37.620 },
  ]], { id: "B", priority: 1 });
  const onEdge = [37.610, 55.752];
  assert.equal(resolveZone(onEdge, [a, b]).properties.id, "A");
  assert.equal(resolveZone(onEdge, [b, a]).properties.id, "A");
});

test("приоритетная вложенная зона и неактивные зоны", () => {
  const base = zone([square], { id: "base", priority: 1, tariff: 300 });
  const express = zone([[
    { lat: 55.751, lng: 37.602 }, { lat: 55.754, lng: 37.602 },
    { lat: 55.754, lng: 37.606 }, { lat: 55.751, lng: 37.606 },
  ]], { id: "express", priority: 10, tariff: 500 });
  assert.equal(resolveZone([37.604, 55.752], [base, express]).properties.tariff, 500);
  express.properties.active = false;
  assert.equal(resolveZone([37.604, 55.752], [base, express]).properties.tariff, 300);
  assert.equal(resolveZone([37.700, 55.800], [base, express]), null);
});

Запуск:

npm i @turf/turf@7
node --test
# tests 10 · pass 10 · fail 0

Что ещё стоит покрыть тестами в реальном проекте

  • Регрессия по реальным адресам. Выгрузите 500–1000 адресов из исторических заказов с уже назначенными зонами и проверяйте, что новая логика даёт тот же результат. Это главный тест миграции.
  • Совпадение фронтенда и бэкенда. Один и тот же набор точек прогоняется через функцию в браузере и через SQL-запрос; результаты должны совпадать.
  • Щели между соседними зонами. Если зоны должны покрывать район без пропусков, проверяйте, что объединение зон совпадает с границей района (например, через turf.union и сравнение площадей).
  • Импорт старых данных. Прогон всех сохранённых зон через validateZone; невалидные — в отчёт, а не в молчаливое исправление.

Российская специфика

Для компаний из РФ вопрос стоит шире, чем замена одного компонента: под вопросом само подключение к Google Maps Platform.

Подключение и оплата

  • Новые клиенты. В марте 2022 года Google Cloud сообщил, что не принимает новых клиентов в России [13]. Публичного заявления, которое отдельно описывало бы условия для Google Maps Platform, найти не удалось.
  • Платёжный аккаунт обязателен для рабочего сайта. Бесплатный демонстрационный ключ Maps Demo Key подходит только для тестирования и прототипов; для промышленной эксплуатации нужен платёжный аккаунт или ключ с подключённой оплатой [14]. Если оформить оплату на российское юрлицо невозможно, вариант «просто переключиться на новый редактор в Google» для нового проекта фактически закрыт.
  • Аккаунты Google. С сентября 2024 года Google ограничил создание новых аккаунтов с российскими номерами телефонов; Минцифры рекомендовало сделать резервные копии данных и по возможности переходить на отечественные платформы [15]. Для бизнеса это риск потерять доступ к консоли, где настроены ключи и ограничения API.

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

Персональные данные

Если адрес доставки вместе с именем или телефоном клиента отправляется на зарубежные серверы (например, для геокодирования), это может квалифицироваться как трансграничная передача персональных данных. По 152-ФЗ оператор обязан уведомить Роскомнадзор о намерении осуществлять такую передачу до её начала, а ведомство вправе её запретить или ограничить [16].

Помимо этого, с 1 июля 2025 года действует ужесточённое требование о локализации: при сборе персональных данных граждан РФ их запись, накопление и хранение допускаются только в базах данных на территории России, а передача за рубеж возможна уже после сбора и с уведомлением Роскомнадзора [17]. Для системы доставки это значит, что основная база заказов с адресами и контактами клиентов должна находиться в России, а зарубежный картографический сервис может получать только то, что нужно для конкретной операции.

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

Российские картографические сервисы

Если вы решаете уйти с Google, логика из статьи переносится почти без изменений, потому что и российские сервисы работают с GeoJSON:

  • Яндекс Карты. В документации JavaScript API v3 есть официальный пример редактора геометрии полигонов и линий: добавление и перетаскивание вершин, удаление двойным кликом, загрузка и выгрузка GeoJSON. В примере для геометрических расчётов используется тот же Turf.js [18].
  • 2ГИС. MapGL JS API предлагает инструменты рисования через пакет @2gis/mapgl-terra-draw — адаптер к той же библиотеке Terra Draw, которую Google приводит в своём примере. Нарисованные фигуры выгружаются в GeoJSON [19].

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

Типичные ошибки при замене

  1. Откат на 3.64 без задачи на замену. При следующей ротации версий всё повторится, причём без ошибки в консоли — просто загрузится другая версия [5].
  2. Перепутанный порядок координат при переходе от {lat, lng} к GeoJSON [10].
  3. Проверка только на фронтенде. Валидация в редакторе [9] не защищает от импорта, API-запросов и прямых правок в базе.
  4. Разные правила границы на сайте и на сервере [4][11][12].
  5. Отсутствие истории изменений — нельзя восстановить, по какой зоне был рассчитан старый заказ.
  6. Тесты на синтетике без проверки на реальных адресах.

Пошаговый план

  1. Диагностика. Версия API, состояние google.maps.drawing, список затронутых экранов, другие удалённые функции из той же волны [1][2].
  2. Стабилизация. Включить editable для существующих зон [3]; при необходимости — временный откат на 3.64 с датой окончания [5].
  3. Выгрузка и проверка данных. Экспорт в GeoJSON, валидация, отчёт об ошибках.
  4. Новый слой рисования. Terra Draw по примеру Google [6] или собственный редактор на google.maps.Polygon.
  5. Серверная проверка и определение зоны. Одно правило для границы, приоритеты, версионирование.
  6. Регрессионные тесты на исторических адресах и автотесты в CI.
  7. Запуск с параллельной сверкой старой и новой логики в течение нескольких дней.

Сроки и стоимость зависят от числа зон, наличия дыр и вложенных зон, количества систем, которые используют результат (сайт, CRM, 1С, курьерское приложение), и от того, насколько чистые исторические данные.

Вывод

Google не отключил карты — он убрал один инструмент, на котором держались админки многих логистических и сервисных проектов. Отображение зон, редактирование существующих полигонов и геометрические функции продолжают работать [3][4]. Чтобы вернуть создание зон, нужен новый слой рисования, а чтобы не повторять старые ошибки — явная проверка геометрии, единое правило для спорных адресов и тесты на реальных данных. При аккуратной миграции редактор зон может стать надёжнее, чем был.

Источники

[1] developers.google.com — Deprecations, Google Maps Platform — https://developers.google.com/maps/deprecations

[2] developers.google.com — Maps JavaScript API Release Notes — https://developers.google.com/maps/documentation/javascript/releases

[3] developers.google.com — Shapes and lines, Maps JavaScript API — https://developers.google.com/maps/documentation/javascript/shapes

[4] developers.google.com — Geometry Library, Maps JavaScript API — https://developers.google.com/maps/documentation/javascript/geometry

[5] developers.google.com — Versioning, Maps JavaScript API — https://developers.google.com/maps/documentation/javascript/versions

[6] developers.google.com — Draw on a map using Terra Draw — https://developers.google.com/maps/documentation/javascript/examples/map-drawing-terradraw

[7] developers.google.com — Drawing Layer (Library), Maps JavaScript API — https://developers.google.com/maps/documentation/javascript/drawinglayer

[8] github.com — JamesLMilner/terra-draw — https://github.com/JamesLMilner/terra-draw

[9] github.com — Terra Draw: Modes guide — https://github.com/JamesLMilner/terra-draw/blob/main/guides/4.MODES.md

[10] datatracker.ietf.org — RFC 7946: The GeoJSON Format — https://datatracker.ietf.org/doc/html/rfc7946

[11] turfjs.org — booleanPointInPolygon, Turf.js 7.4.0 — https://turfjs.org/docs/api/booleanPointInPolygon

[12] postgis.net — ST_Covers, PostGIS documentation — https://postgis.net/docs/ST_Covers.html

[13] techcrunch.com — Amazon, Microsoft and Google have suspended cloud sales in Russia (10.03.2022) — https://techcrunch.com/2022/03/10/amazon-microsoft-and-google-have-suspended-cloud-sales-in-russia

[14] developers.google.com — Get and use a Maps Demo Key, Maps JavaScript API — https://developers.google.com/maps/documentation/javascript/demo-key

[15] skillbox.ru — Google ограничил создание новых аккаунтов для российских пользователей (26.09.2024) — https://skillbox.ru/media/code/google-ogranichil-sozdanie-novykh-akkauntov-dlya-rossiyskikh-polzovateley/

[16] rulaws.ru — Федеральный закон от 27.07.2006 № 152-ФЗ «О персональных данных», статья 12 — https://rulaws.ru/laws/Federalnyy-zakon-ot-27.07.2006-N-152-FZ/Statya-12

[17] comnews.ru — Граница на замке: особенности работы с персональными данными в России (13.10.2025) — https://www.comnews.ru/digital-economy/content/241730/2025-10-13/2025-w42/1016/granica-zamke-osobennosti-raboty-personalnymi-dannymi-rossii

[18] yandex.ru — Редактор геометрии полигонов и линий, JavaScript API Яндекс Карт — https://yandex.ru/maps-api/docs/js-api/examples/cases/geometry-editor-polygon.html

[19] docs.2gis.com — Drawing tools, MapGL JS API — https://docs.2gis.com/en/mapgl/map/tools/drawing

Быстрые вопросы и ответы

Google Maps полностью отключил карты?

Нет. Из API убрали библиотеку Drawing и её DrawingManager; отображение карты и уже сохранённых полигонов — отдельные функции. Проверьте консоль и используемый код, прежде чем менять всю картографическую платформу.

Можно ли временно вернуть старый DrawingManager откатом версии?

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

Нужно ли переносить зоны, если они видны на карте?

Сначала сделайте резервную выгрузку не только координат, но и названий, тарифов, приоритетов, ограничений и связей с заказами. Видимый полигон не гарантирует, что вся бизнес-логика зоны сохранена для нового редактора.

Почему после экспорта в GeoJSON зона оказалась в другом месте?

Частая причина — обратный порядок координат. В Google Maps используют широту и долготу, а GeoJSON записывает долготу первой. Проверьте преобразование на известной точке и добавьте автотест до массового импорта.

Как проверить, что новый редактор не испортит расчёт доставки?

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

Нужно проверить ваш сайт или систему?
Расскажите, что хотите изменить или связать. Посмотрим вашу ситуацию и предложим понятный следующий шаг.