Yandex Maps API: подключение и решение ошибок ymaps/ymaps3 is not defined

[hannadev]

Yandex Maps API позволяет легко добавлять интерактивные карты на сайт. Эта статья разберёт, как правильно подключить API версий 2.1 и 3, получить ключ и избежать типичных ошибок вроде ymaps is not defined или ymaps3 is not defined.

Такие проблемы часто возникают из-за неправильного подключения скрипта, отсутствия API-ключа или блокировок. Мы пройдёмся по шагам настройки, разберём примеры кода и способы диагностики. Это поможет быстро запустить карту без лишних хлопот.

Получение API-ключа для Yandex Maps

API-ключи обязательны для всех версий Yandex Maps. Без них скрипт не загрузится, и вы увидите ошибку ymaps is not defined. Процесс получения простой, но требует внимания к деталям.

Сначала заходите в кабинет разработчика Яндекса. Там нажимайте «Подключить API» и выбирайте JavaScript API и HTTP Геокодер. Заполняйте форму: ФИО, email, цель использования вроде «конструктор карт». После создания ключа копируйте его — он активируется через 5–30 минут.

Важно настроить HTTP Referer: укажите домены сайтов, с которых будет запрос (например, yoursite.ru без протокола). Это предотвратит ошибки доступа. Для v3 ключ используется аналогично, но скрипт другой.

Вот базовые шаги:

• Зарегистрируйтесь или авторизуйтесь в кабинете.
• Выберите сервис JavaScript API и создайте ключ.
• Добавьте домены в поле HTTP Referer.
• Подождите активации и протестируйте.

Параметр	Описание	Пример
apikey	Ваш ключ	pro_abc123xyz
lang	Язык	ru_RU
load	Модули	package.full

Не забудьте: ключ для Geosuggest отдельный, если нужен поиск адресов.

Подключение Yandex Maps API 2.1

Версия 2.1 — проверенный вариант для большинства задач. Подключение идёт через