Яндекс Карты и DaData
Обновлено
Яндекс Карты
- Получите ключ в кабинете разработчика Яндекса.
- Обеспечьте доступ ключа к JavaScript API для отображения карт и к API Геокодера для определения координат по адресу. В Премиум построение дорожного маршрута выполняется средствами
ymaps.multiRouterJavaScript API. - Укажите ключ в «Общие настройки → API ключ Яндекс Карт» и сохраните способ.
- Откройте редактор зон и проверьте карту. Затем проверьте определение полного адреса при оформлении; для Премиум — построение маршрута от сохранённого склада.
Без ключа расчёт способа отключён. Доступность и лимиты внешнего API определяются вашим подключением у провайдера; числовые квоты не являются настройкой плагина.
Какие данные передаются
| Операция | Данные | Откуда отправляются |
|---|---|---|
| Загрузка карты | API-ключ в запросе к api-maps.yandex.ru |
Браузер |
| Определение адреса | Город и улица, ключ, при наличии — границы области поиска по зонам | Браузер и при необходимости сервер, к geocode-maps.yandex.ru/1.x/ |
| Поиск склада | Введённый адрес склада | Браузер, через геокодер Яндекс Карт |
| Дорожный маршрут | Координаты склада и адреса назначения | Браузер, через JavaScript API Яндекс Карт |
Ключ используется в браузере и не является исключительно серверным секретом. Подбирайте ограничения ключа с учётом того, что геокодирование выполняется также с сервера магазина.
Серверное определение адреса
Когда данных зоны из браузера ещё нет, сервер пытается определить координаты сам. Для этого используется waNet, в том числе настройки прокси Webasyst из wa-config/net.php. Серверный таймаут — 2 секунды. Успешные ответы кешируются на сутки, неудачная попытка — на минуту.
При расчёте без браузера плагин не строит дорожный маршрут на сервере: в Премиум при известных координатах используется прямая с коэффициентом. Это относится и к вызовам расчёта через API магазина.
DaData
- Получите API-ключ подсказок адреса DaData.
- В «Общих настройках» выберите «Подсказки адресов → DaData».
- Заполните «API-ключ DaData» и сохраните настройки.
- При оформлении начните вводить адрес: запрос подсказок отправляется при длине ввода от трёх символов. Выберите подходящий вариант из списка.
DaData получает введённый текст адреса и дополнительные параметры ограничения поиска, которые формирует виджет. Запрос отправляется из браузера на suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/address, ключ передаётся в заголовке Authorization: Token …. Секретный ключ DaData плагин не запрашивает.
Подсказки необязательны. Если их уже добавляет другой плагин, оставьте встроенные выключенными, чтобы два списка не работали на одном поле.
Автоматизация
Собственных cron/CLI-команд, webhooks и MCP-инструментов в плагине нет. Зоны и транспорт настраиваются через интерфейс способа доставки; пересчёт выполняет Shop-Script при работе с заказом.