Яндекс.Карты
Карта парка и работа с адресами через Яндекс.Карты. Серверное геокодирование и карта в браузере используют разные ключи.
Откройте Интеграции → Добавить интеграцию → Яндекс.Карты. Для уже установленного подключения используйте Настроить.
Подготовка
- В кабинете разработчика Yandex создайте ключ JavaScript API и ключ нужного серверного API.
- Браузерный ключ ограничьте доменами/Referer, а серверный — IP-сетями, если тариф и API это поддерживают.
- Укажите язык карты в формате language_REGION, регион по умолчанию и дневной лимит.
- Сохраните ключи и проверьте карту и серверный поиск адреса отдельно.
Параметры
| Поле | Вид | Назначение и правила заполнения |
|---|---|---|
| Регион по умолчанию | Настройка | Код региона, используемый интерфейсом для приоритета результатов, например MD. |
| Язык карты | Настройка | Язык и регион в формате language_REGION, например ru_RU или en_US, поддерживаемый Yandex Maps API. |
| Дневной лимит | Настройка | Предел запросов в сутки: целое число от 1 до 100000, не выше квоты вашего тарифа Yandex. |
| Разрешённые IP-сети сервера | Настройка | Введите каждую сеть с новой строки в CIDR-формате, например 8.8.8.8/32. Публичные адреса сервера узнайте у администратора инфраструктуры. |
| Разрешённые адреса админки | Настройка | Введите каждый адрес с новой строки, например https://admin.example.com, без пути и параметров; они должны совпадать с ограничением по Referer. |
| Серверный API-ключ | Секрет | Секретный ключ серверного Yandex API, например Geocoder API; не используйте его в браузере. |
| Браузерный API-ключ | Секрет | Ключ Yandex Maps JavaScript API с ограничением по доменам/Referer. |
Сохранение и изменение
Заполните параметры и нажмите «Сохранить». При повторном открытии секреты не показываются: индикатор наличия секрета не является его значением. Пустое поле существующего секрета сохраняет прежнее значение; новое значение заменяет его. После изменения проверьте подключение заново.
Тип Яндекс.Карты доступен в полном каталоге интеграций.
Проверка результата
- Проверьте отображение карты в карточке устройства.
- Отдельно проверьте поиск адреса: успешная карта не доказывает работу Geocoder API.
- Сопоставьте домены/Referer браузерного ключа и публичные исходящие сети серверного ключа с параметрами кабинета Яндекса.
Статус «Настроено» означает сохранённые настройки. Результат проверки соединения и результат целевой операции оценивайте отдельно. Подробности проверки доступны в карточке подключения.
Ограничения и зависимости
Дневной лимит в форме — целое число 1–100000. Он действует в пределах квоты провайдера. Список адресов и CIDR вводится по одному значению на строку. Для языка доступны ru_RU, en_US, en_RU, uk_UA, be_BY и tr_TR.
Если не работает
| Симптом | Что проверить |
|---|---|
| Пустая подложка карты | Проверьте браузерный ключ, доступ к JavaScript API и ограничения Referer. |
| Ошибка поиска адреса | Проверьте серверный ключ, доступ к Geocoder API, CIDR и квоты. |
| После переезда админки перестало работать | Обновите разрешённые адреса в MDM и у провайдера; путь страницы не является origin. |