Ключ Яндекс Карт
Как получить ключ, защитить его адресом магазина и сколько стоит работа карты.
Ключ нужен модулю Зоны доставки на карте: по нему работают карта зон, подсказки адреса и цена доставки по адресу.
Сколько стоит#
Бесплатный режим есть, но с суточными лимитами на весь магазин. Цифры со страниц Яндекса на 17.10.2026.
| Что | Бесплатно в сутки | Платно |
|---|---|---|
| Поиск адреса и расчёт цены (Геокодер) | 1 000 запросов | от 226 200 ₽ в год |
| Подсказки адреса (Геосаджест) | 1 000 запросов | от 208 800 ₽ в год |
| Сама карта (JavaScript API) | 500 запросов | от 195 000 ₽ в год |
- Один покупатель, пока вводит адрес, тратит несколько подсказок.
- Когда лимит кончился, подсказки пропадают, а вместо цены доставки покупатель видит «Стоимость уточним» — цену назовёте при подтверждении.
- В бесплатном режиме на карте показывается реклама. Без рекламы — тариф «Базовый (без рекламы)»: 20 000 ₽ в год за один домен.
- Условия бесплатного режима запрещают использовать его «в проектах, требующих оплаты». Подходит ли под это магазин, из текста не ясно. Вопросы по условиям: maps-api@support.yandex.ru — лучше спросить письменно до запуска.
Получить ключ#
Нужен аккаунт Яндекса (Яндекс ID).
- Откройте кабинет разработчика Яндекса и войдите.
- Нажмите «Подключить API» и отметьте три продукта: «JavaScript API», «API Геокодера», «API Геосаджеста».
- Заполните анкету с адресом сайта, примите условия и отправьте.
- Если ключа в списке нет, откройте API и нажмите «Новый ключ».
- Скопируйте ключ. Если он привязан не ко всем трём API: «Ключи» → выберите ключ → «Привязать к API» → выберите API → «Выбрать». Нужен один ключ на все три.
Защитить ключ#
Ключ карты виден в коде сайта. Без ограничения им может пользоваться кто угодно — ваш лимит закончится, а на платном тарифе придёт счёт и за чужие запросы.
- Откройте ключ в кабинете и нажмите «Изменить».
- В поле «Ограничение по HTTP Referer» впишите адрес магазина из адресной строки, без
https://и без пути. Например:myshop.ru. - Сохраните.
Подключили свой домен — впишите его в это поле вместе с прежним адресом. Адрес с www вписывать не нужно.
Куда вставить#
«Доставка» → «Способы получения», блок «Карта и адреса».
- Вставьте ключ в поле «Ключ Яндекс Карт».
- Нажмите «Сохранить» вверху страницы.
Если на странице есть блок «Отдельные ключи», там сохранены ключи старого вида. Они работают вместо основного для своего сервиса — вставьте основной ключ и туда.
Как проверить#
Ключ и ограничение начинают работать через 15 минут.
- Откройте «Доставка» → «Карта доставки» — карта должна загрузиться.
- На сайте положите товар в корзину, выберите доставку и начните вводить адрес — после трёх букв появятся подсказки.
- Выберите адрес из подсказок — посчитается цена доставки.
Частые ошибки#
| Что видно | Причина | Что сделать |
|---|---|---|
| Карта серая или «Карта не загрузилась» | Ключ ещё не заработал или не привязан к «JavaScript API» | Подождите 15 минут, проверьте привязку |
| «Не указан ключ Яндекс Карт» | Поле пустое | Вставьте ключ в «Способах получения» |
| Карта есть, подсказок нет | Ключ не привязан к «API Геосаджеста» | Привяжите ключ |
| Цена доставки «уточним» | Ключ не привязан к «API Геокодера» или кончился лимит | Привяжите ключ, проверьте «Статистику» в кабинете |
| Всё работало и перестало | Кончился суточный лимит | Подождите до следующих суток или перейдите на платный тариф |
| Сменили адрес магазина — карта пропала | В ограничении старый адрес | Впишите новый адрес в «Ограничение по HTTP Referer» |
Подробнее — если карта не работает.
Источники#
Не нашли ответ?
Напишите нам — ответим и поможем настроить.