Главная Адреса Токены карт для геокодинга

Токены карт для геокодинга

Обновлено Oct 21, 2026

Включается по обращению в поддержку.

Возможности

Чей сервис ищет адрес

  • Организация подключает собственные ключи трёх сервисов: Яндекса, Google и 2ГИС. Ключей одного сервиса можно задать несколько — запросы распределяются между ними.
  • Подключённый сервис обслуживает и подсказки при вводе адреса, и превращение адреса в координаты, и обратное определение адреса по координатам. Одна и та же цепочка работает на витрине, в приложении гостя и в кабинете.
  • У Яндекса ключ геоподсказок подключается отдельно от ключа геокодера: подсказки при наборе можно перевести на него, не трогая остальное.
  • Порядок обхода фиксирован: геоподсказки Яндекса, геокодер Яндекса, 2ГИС, Google. Если ни один ключ не подключён или подключённый сервис ничего не нашёл, адрес ищет сервис по умолчанию — DaData.

Точность выдачи

  • Поиск у Яндекса приоритизируется по зонам доставки: рамка области строится по зонам того города, который распознан в начале запроса. Это подсказка ранжирования, а не фильтр — адреса за рамкой из выдачи не пропадают.
  • Улица без номера дома остаётся в подсказках, но адресом не считается: координаты берутся только у варианта с домом.
  • Язык выдачи подбирается под язык организации: русский, украинский, белорусский, английский, турецкий; у 2ГИС — ещё казахский, узбекский, азербайджанский, грузинский, чешский и итальянский.
  • Разбор адреса у Google учитывает турецкую адресную систему: район входит в название улицы, а не теряется.

Что ещё меняется от ключа

  • Сохранённый адрес гостя помнит, каким сервисом он был распознан. Сменился сервис — координаты адреса пересчитываются заново.
  • В кабинете по ключу организации может рисоваться карта заказов, а подсказки адреса в карточке заказа и в карточке точки — приходить прямо от Google.
  • Организация со своим справочником адресов — домики на территории, адресация без карт — либо отдаёт координаты из справочника, либо отправляет собранный адрес в подключённый сервис за координатами; см. Кастомная адресная система.

Как настроить

  1. Заведение регистрирует ключ у самого картографического сервиса. У Яндекса это анкета в кабинете разработчика: сайт заведения, цель — оформление заказов с адресом доставки, бесплатный тариф, затем создание ключа геокодера.
  2. Ключ передаётся менеджеру и заводится в настройках организации. Ключей можно передать несколько — нагрузка распределится между ними.
  3. Ключ геоподсказок Яндекса задаётся отдельным полем. Если он не нужен, поле остаётся пустым, и подсказки идут по общей цепочке.
  4. Ключ начинает работать не сразу: у Яндекса — в течение 15 минут после создания, проверять стоит через 15–30 минут после настройки.
  5. Проверка идёт на витрине или в приложении: ввод адреса, появление подсказок, подстановка координат, определение зоны доставки.

Что должно быть настроено и ограничения

  • Ключ выдаёт картографический сервис и на своих условиях: бесплатный тариф ограничен и по числу запросов, и по назначению использования. Исчерпание и блокировка ключа — вопрос к сервису, а не к платформе.
  • Ключ, который сервис отклонил, на час выводится из работы: запросы идут дальше по цепочке, адреса ищет следующий подключённый сервис или сервис по умолчанию. В кабинете при этом появляется уведомление о недоступном ключе Яндекса.
  • Приоритет области поиска строится по зонам доставки. Зон нет — рамки нет, и адрес ищется по всей стране: одноимённые улицы разных городов встают в выдаче вперемешку.
  • Адрес без номера дома координат не получает, поэтому гость должен выбрать вариант с домом, а не строку с одной улицей.
  • Ключ Google одним полем в цепочку не встаёт: без отдельного включения серверного распознавания адреса он остаётся ключом для карт в кабинете.
  • Ключ действует на организацию, а не на точку: сеть в двух городах получает один и тот же сервис в обоих.

Чего нет

  • Ключ не заводится и не виден в кабинете: своей формы у блока нет, ключ передаётся менеджеру и включается по обращению.
  • Выбрать сервис вручную нельзя: порядок обхода фиксирован, решает наличие ключа, а не предпочтение заведения.
  • Разные сервисы для разных точек, городов или брендов задать нельзя — ключ действует на всю организацию целиком.
  • Расход по ключу в кабинете не виден: ни счётчика запросов, ни остатка лимита, ни истории обращений к сервису.
  • Ключ не проверяется в момент сохранения. Неверный или ещё не активированный ключ обнаруживается только на первом живом запросе.
  • Подложка карты на витрине этим ключом не выбирается: она приходит из оформления витрины и от ключей не зависит.
  • Точка, которую гость ставит на карте витрины, превращается в адрес сервисом по умолчанию — подключённый ключ на этот шаг не влияет.

Примеры

Гость заказывает в новом районе

  1. Гость открывает панель адреса на витрине и набирает улицу.
  2. Подсказки приходят от подключённого сервиса — дом, которого нет в базе по умолчанию, в списке есть.
  3. Гость выбирает дом, координаты подставляются вместе с адресом.
  4. По координатам определяется зона доставки, и гость видит стоимость и время до оплаты.

Оператор принимает заказ по телефону

  1. Оператор открывает карточку заказа и вводит адрес в поле адреса.
  2. Подсказки приходят из той же цепочки, что и у гостя.
  3. Кнопка геокодирования проставляет заказу координаты по выбранному адресу.
  4. Дальше срабатывает определение зоны — заказ уходит на нужную точку.

Ключ перестал работать

  1. Сервис отклоняет запросы: ключ отозван, исчерпан или ещё не активирован.
  2. Ключ на час выводится из обхода. Адреса ищет следующий сервис цепочки или сервис по умолчанию: поиск продолжает работать, но точность падает до той, что была до подключения.
  3. В кабинете появляется уведомление о недоступном ключе.
  4. Заведение выпускает новый ключ и передаёт его; после замены качество подсказок возвращается.

Связанные статьи