Геокодирование
Здесь заведение подключает свой ключ Яндекс Карт. Один ключ на весь логин (сеть): им пользуются все точки, колл-центр, курьеры, касса, Telegram-бот и сайт заведения.
Где находится
Внешние сервисы → Геокодирование
Для чего нужен ключ
Без ключа карта и поиск адреса работают не везде. Ключ заведения используется в таких местах:
| Где | Что делает ключ |
|---|---|
| Кабинет — создание заказа доставки, карта заказов | Карта, поиск адреса по тексту и определение адреса по точке на карте |
| Касса — адрес доставки в заказе | Подсказки адреса и выбор точки на карте. Без ключа у поля висит подсказка «Не подключён ключ карт — обратитесь в поддержку» |
| Telegram-бот, сайт и приложение заведения | Карта при выборе адреса, поиск адреса гостем, карта филиалов |
| Кабинет — зоны доставки | Карта для рисования зон |
Поле «Координаты Yandex» в карточке торговой точки и карта при регистрации работают на общем ключе Mison — для них свой ключ не нужен. Всё, что связано с заказами и гостями, работает только на ключе заведения.
Какой ключ получать в Яндексе
В кабинете разработчика Яндекса при создании ключа открывается окно «Выберите продукт». Нужен только один продукт — JavaScript API (первая карточка в колонке «Карты»).
| Продукт в окне Яндекса | Нужен? | Почему |
|---|---|---|
| JavaScript API | Да | На нём работают все карты Mison и поиск адреса (геокодер). В тарифах Яндекса этот ключ называется «JavaScript API и HTTP Геокодер» |
| API Геокодера | Нет | Отдельно не нужен: поиск адреса идёт через ключ JavaScript API |
| API Геосаджеста | Нет | Mison подсказки адреса Геосаджестом не делает, они строятся через геокодер |
| Static API, Tiles API, MapKit SDK | Нет | Не используются |
| Маршруты, Isochrone, Матрица расстояний, Поиск по организациям, Локатор | Нет | Не используются |
В поле Тип в кабинете Mison в ыбирайте только Yandex. Пункты Google, 2GIS и OpenStreetMap в списке есть, но карты и поиск адреса во всех приложениях Mison работают только через Яндекс — с ключом другого сервиса карта не загрузится.
Как получить ключ — пошагово
Делает владелец заведения или оператор вместе с ним: ключ оформляется на Яндекс-аккаунт заведения, а не на личный аккаунт оператора.
- Откройте developer.tech.yandex.ru и войдите в Яндекс-аккаунт заведения.
- Перейдите в раздел Ключи и нажмите создание нового ключа.
- В окне «Выберите продукт» нажмите карточку JavaScript API.
- Заполните анкету Яндекса (имя, почта, телефон, название ключа — например, название заведения) и подтвердите создание.
- Если Яндекс предлагает ограничить ключ по доменам (HTTP Referer) — оставьте ограничение пустым. Ключ используется в кабинете, кассе, боте и на сайте, а также с сервера Mison; при ограничении по доменам поиск адреса в боте и на сайте перестанет работать.
- Скопируйте ключ — строка вида
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. - Подождите до 15 минут: столько Яндекс активирует новый ключ. До активации карта может не загружаться — это нормально.
Количество запросов по ключу видно в кабинете Яндекса в разделе Статистика, условия и лимиты — в разделе Тарифы. Если карта внезапно перестала искать адреса у заведения, которое работало, первым делом смотрите там, не исчерпан ли лимит.
Как вставить ключ в Mison
Форма раздела состоит из трёх элементов:
| Элемент | Что делает |
|---|---|
| Тип | Сервис карт. Выберите Yandex. Очистка поля и сохранение отключают геокодирование — настройка удаляется целиком |
| Веб-сайт | Ссылка на кабинет разработчика выбранного сервиса, для Yandex — developer.tech.yandex.ru. Только для перехода, не редактируется |
| TOKEN | Сам ключ из кабинета Яндекса |
- Откройте Внешние сервисы → Геокодирование.
- В поле Тип выберите Yandex.
- Вставьте ключ в поле TOKEN — без пробелов в начале и в конце.
- Нажмите Сохранить.
Когда ключ начнёт работать
| Где | Когда подхватывается ключ |
|---|---|
| Telegram-бот, сайт, приложение | Сразу после сохранения — ключ читается с сервера при каждом запросе |
| Кабинет (заказы доставки, колл-центр, курьеры) | После повторного входа в кабинет: ключ выдаётся при авторизации. Выйдите и войдите заново |
| Касса | После синхронизации настроек кассы с облаком |
Частые вопросы
Оператор прислал скриншот окна «Выберите продукт» — что нажимать? Карточку JavaScript API. Больше ничего выбирать не нужно.
На кассе у поля адреса написано «Не подключён ключ карт — обратитесь в поддержку». В разделе Геокодирование не сохранён ключ, либо касса ещё не получила его. Проверьте, что поле TOKEN заполнено и Тип — Yandex, затем выполните синхронизацию на кассе.
Бот или сайт пишет «Настройте геокодирование». У логина заведения нет сохранённого ключа. Заполните раздел и сохраните — бот подхватит ключ без перезапуска.
Ключ вставили, но карта серая или адреса не находятся. Проверьте по порядку: прошло ли 15 минут с создания клю ча; в кабинете Яндекса выбран продукт JavaScript API, а не Геосаджест или Static API; у ключа нет ограничения по доменам; не исчерпан лимит в разделе Статистика; в кабинете Mison после сохранения выполнен повторный вход.