Ключ Яндекс.Карт — где взять и куда вставить

Ключ — это длинная строка символов, которую Яндекс выдаёт вам лично. По ней он понимает, чьи карты показывать и кому выставлять счёт, если запросов станет очень много.

Нужен ли он вам вообще

Ключ нужен только для одного: чтобы рисовать зоны доставки прямо на карте.

Он не нужен для:

• QR-меню и заказов у столика;
• сайта заведения и его блоков;
• карты со всеми точками сети на сайте — она работает без вашего ключа;
• доставки, если вы описываете зоны списком, а не рисуете на карте.

Если доставки у вас нет — эту статью можно закрыть.

Шаг 1. Заведите ключ в кабинете Яндекса

1. Откройте developer.tech.yandex.ru.
2. Войдите под своим Яндекс-аккаунтом — подойдёт тот же, что для Яндекс.Почты.
3. Найдите тариф «JavaScript API и HTTP Геокодер» и подключите его.
4. Заполните короткую анкету: название («Сайт кафе»), адрес вашего сайта на Misea (вида https://ваш-адрес.misea.ru), описание («показ карты и зон доставки»).
5. Отправьте заявку.

Что вы увидите: заявка уйдёт на рассмотрение. Обычно ответ приходит за 1–3 рабочих дня, поэтому подавайте её заранее, а не в тот вечер, когда запускаете доставку.

После одобрения ключ появится в кабинете, в разделе с вашими ключами. Это строка вида a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6. Скопируйте её.

Шаг 2. Вставьте ключ в Misea

Ключ вводится на странице «Доставка», а не в «Интеграциях» — это частая ошибка.

1. В левом меню нажмите Управление, затем Доставка.
2. Откройте вкладку «Зоны» (она открыта по умолчанию; рядом — «Курьеры» и «В работе»).
3. В блоке «Общие настройки доставки» прокрутите вниз до строки «Ключи Яндекс.Карт (для режима «Карта»)» и нажмите на неё — раздел раскроется.
4. В поле «JS API ключ» вставьте ключ. Внутри поля серым написано «ключ для карты», под ним — подсказка «Получить в кабинете Яндекса, тариф „JavaScript API и HTTP Геокодер”».
5. Второе поле, «HTTP Geocoder (опционально)» (серым внутри — «для автоподсказок»), можно оставить пустым. Оно нужно, если вы хотите, чтобы Misea подсказывала гостю адрес при вводе; для этого в кабинете Яндекса берётся отдельный ключ геокодера. Misea поясняет: «Используется только сервером, не уходит в браузер».
6. Нажмите «Сохранить настройки» — кнопка внизу этого же блока, под полями ключей.

Что вы увидите: серая подсказка «Чтобы рисовать зоны на карте, введите ключ Яндекс.Карт ниже» пропадёт сразу, как только вы вставите ключ (ещё до сохранения), а в строке «Режим работы зон» рядом с вариантом «Список зон» появится второй вариант — «Карта (полигоны)». Нажмите на него, чтобы рисовать зоны.

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

Что делать, если не получилось

• Подсказка про ключ не пропала. Проверьте, что ключ вставлен целиком, без пробелов по краям, и что вы нажали «Сохранить».
• Карта показывается с водяным знаком или не грузится. Обычно это значит, что в анкете Яндекса не указан адрес вашего сайта. Зайдите в кабинет Яндекса, откройте ключ, добавьте адрес https://ваш-адрес.misea.ru и подождите 10–30 минут.
• «Превышен лимит запросов». Бесплатного объёма ресторану хватает с запасом, так что чаще всего это значит, что ключ попал на чужой сайт. Посмотрите статистику запросов в кабинете Яндекса и при необходимости пересоздайте ключ.
• Ждать одобрения некогда. Опишите зоны доставки списком — вариант «Список зон» в строке «Режим работы зон» на той же вкладке. Ключ тогда не нужен совсем.
• Ключ вставили, а гости всё равно не оформляют доставку. Ключ отвечает только за карту. Сама доставка включается переключателем «Принимать заказы с доставкой» в том же блоке «Общие настройки доставки» (когда он выключен, Misea пишет: «Когда выключено, блок „Доставка" на витрине скрывается»). И нужна хотя бы одна зона: пока их нет, внизу страницы висит «Зон пока нет. Добавьте хотя бы одну зону — иначе гости не смогут оформить доставку». Зона заводится кнопкой «+ Новая зона».
• Ищете «Доставку» в меню и не находите? Она всегда на месте: Управление → Доставка. Раздел не прячется, даже если приём заказов с доставкой выключен.