Misea Начать бесплатно

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

Регистрация на developer.tech.yandex.ru, получение ключа, привязка к домену, вставка в Misea.

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

Ключ JavaScript API нужен:

  • Для блока Карта в конструкторе витрины — адрес ресторана с пином.
  • Для полигональных зон доставки — рисование/отображение.
  • Для автоопределения адреса гостя (геокодер).

Без ключа карты подгружаются с водяным знаком «Без коммерческого использования», а полигоны могут вообще не работать.

Ключ — бесплатный при обычном ресторанном трафике (лимит 25 000 запросов в сутки).

Шаг 1. Регистрация в Яндекс.Технологии

  1. Откройте developer.tech.yandex.ru.
  2. Войдите под вашим Яндекс-аккаунтом (тот же, что для Почты / Метрики).
  3. Если кабинета разработчика ещё не было — согласитесь с условиями и создайте профиль.

Шаг 2. Создать ключ для JavaScript API

  1. В кабинете → Мои ключи → Подключить API.
  2. В списке найдите «API Яндекс Карт (JavaScript API и HTTP Геокодер)».
  3. Нажмите «Подключить».
  4. Заполните форму:
    • Название: «Misea Site» (любое).
    • URL сайтов:
      • https://<ваш-домен>.ru
      • https://<tenant>.misea.site
      • https://misea.ru
      • http://localhost:3000 (для тестов, опционально).
    • Описание: «Ресторанный сайт, показ карты и полигональные зоны доставки».
  5. Отправьте на модерацию.

Модерация 1–3 рабочих дня. На случай выходных — подайте в будний день.

Шаг 3. Получить ключ

После одобрения:

  1. Вернитесь в Мои ключи → нажмите на ваш.
  2. В карточке ключа — поле «Ключ» (строка вида a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6).
  3. Скопируйте.

Шаг 4. Вставить в Misea

  1. /settings/integrations → Яндекс.Карты → поле JS API ключ.
  2. Вставьте и нажмите Сохранить.

Misea проверит ключ, подгрузив тестовую карту — если 🟢, ключ валиден.

Шаг 5. Использование

После сохранения:

  • В конструкторе → блок Карта → автодополнение адреса начинает работать.
  • В /delivery → переключите на Карта (полигоны) → сможете рисовать зоны.

Шаг 6. Привязка доменов

Важно: ключ работает только на доменах, указанных в форме заявки. Если вы потом добавите новый домен (например, cafe-misea.ru), отредактируйте ключ:

  1. developer.tech.yandex.ru → Мои ключи → выберите ваш.
  2. «Редактировать» → добавьте новый URL → сохранить.

Применяется через 10–30 минут.

Лимиты

Бесплатный ключ: 25 000 запросов / сутки.

Для обычного ресторана это запас x100 — реальные 50–200 гостей в день без проблем.

Если Misea показывает «Превышен лимит запросов» — проверьте, не подцепил ли кто-то ваш ключ на чужой сайт. В настройках ключа → Статистика запросов.

Тарифный план

Для очень крупных заведений (>25k запросов/день) — платный тариф в том же кабинете. Старт от 3000 ₽/мес.

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

  • Ключ был отозван модерацией (нарушение условий) — посмотрите в кабинете уведомления.
  • Ключ истёк (редко, обычно бессрочный) — пересоздайте.
  • Вы добавили домен, но не дождались распространения — подождите 30 минут.

Полный API Key (серверный)

Для отправки гео-запросов с сервера Misea (геокодирование, маршрутизация) Misea использует свой серверный ключ. Вам не нужен отдельный — ваш только JS-ключ для клиента.

Альтернатива

Если по каким-то причинам вы не хотите заводить ключ:

  • Блок Карта можно заменить статической картинкой-скриншотом + ссылкой в Яндекс.Карты.
  • Доставка — режим Список зон вместо полигонов.

Но для нормального UX гостя рекомендуется завести ключ — это 10 минут работы.

Следующие шаги