Некоторые модули PrestaShop используют Яндекс Карты для отображения пунктов выдачи, выбора адреса доставки, работы с картой или определения координат. Для корректной работы таких функций может потребоваться API-ключ Яндекс Карт.
Интерфейс Кабинета разработчика Яндекса и порядок подключения API изменились. Раньше в инструкциях часто предлагалось выбрать единый сервис «JavaScript API и HTTP Геокодер». Сейчас API Яндекс Карт разделены на отдельные продукты, поэтому процесс получения ключа выглядит немного иначе.
Ниже приведена актуальная последовательность действий.
Шаг 1. Войдите в Кабинет разработчика Яндекса
Перейдите в Кабинет разработчика Яндекс Карт и авторизуйтесь с помощью своего Яндекс ID.
Перейти >
В кабинете находятся подключённые API, API-ключи, статистика использования и настройки ограничений.
После входа перейдите в раздел Консоль.
Перейти >
Шаг 2. Нажмите «Подключить API»
Откроется список доступных продуктов Яндекс Карт.
Для большинства модулей PrestaShop, которым необходимо отображать интерактивную карту, требуется:
JavaScript API
Поэтому не нужно подключать все API подряд.
Шаг 3. Выберите условия использования
После выбора JavaScript API Яндекс предложит указать информацию о проекте и выбрать подходящий вариант использования.
Для проектов, соответствующих условиям бесплатного использования API Яндекс Карт, доступно бесплатное использование. Для коммерческих сценариев, которые не соответствуют этим условиям, необходимо выбрать подходящий платный тариф.
Ознакомьтесь с условиями Яндекса и завершите подключение JavaScript API.
После этого API должен появиться среди подключённых продуктов в Кабинете разработчика.
Шаг 4. Создайте API-ключ
После подключения необходимого API перейдите в раздел «Ключи».
Нажмите:
«Новый ключ»
Создайте новый API-ключ для своего интернет-магазина.
Для удобства можно использовать понятное название, например:
shop-example-ru
или
PrestaShop — example.ru
После создания ключ появится в списке ключей Кабинета разработчика.
Официальная инструкция Яндекса >
Шаг 5. Проверьте привязку ключа к JavaScript API
Убедитесь, что созданный ключ связан именно с тем API, который требуется модулю.
Для обычной интерактивной карты это:
JavaScript API
Шаг 6. Настройте ограничение по домену
Это один из самых важных этапов.
Откройте созданный ключ и перейдите к его редактированию.
В настройках ограничения использования ключа укажите домен интернет-магазина в поле «Ограничение по HTTP Referer».
Например, для магазина:
example.ru
необходимо разрешить использование ключа с этого сайта.
Ограничение по домену защищает ключ от использования на посторонних сайтах. Яндекс также рекомендует для JavaScript API использовать именно ограничение по домену, а не по IP-адресу пользователя.
Для JavaScript API 3.0 заполненное ограничение по HTTP Referer является обязательным.
Если магазин работает на основном домене и поддоменах, внимательно проверьте правила ограничения в Кабинете разработчика.
Шаг 7. Сохраните настройки и подождите активации
API-ключ может активироваться не мгновенно. Яндекс указывает, что активация нового ключа может занять до 15 минут. Изменения ограничений ключа также могут применяться не сразу.
Поэтому если сразу после создания ключа карта в PrestaShop ещё не появилась, подождите несколько минут и повторно проверьте страницу.
Если ключ уже был создан раньше
Если у вас есть старый API-ключ, созданный для продукта «JavaScript API и HTTP Геокодер», не обязательно сразу создавать новый ключ.
Яндекс разделил старый продукт на несколько отдельных API. Для старых ключей может потребоваться подключить новые продукты и привязать существующий ключ к необходимому API через раздел «Ключи».
Что делать, если Яндекс Карты в модуле не работают
Если ключ добавлен, но карта не отображается, проверьте:
-
подключён ли JavaScript API;
-
привязан ли созданный ключ к этому API;
-
правильно ли указан домен в ограничении по HTTP Referer;
-
используется ли именно тот домен, на котором открыт магазин;
-
прошло ли до 15 минут после создания ключа или изменения ограничений;
- нет ли ошибок Яндекс Карт в консоли браузера.
Особенно внимательно проверяйте домен, если магазин сначала настраивается на тестовом адресе, а затем переносится на основной домен.
Например, ключ, разрешённый только для рабочего домена, может не работать на тестовом домене магазина.
Официальная инструкция Яндекса >
