Wiki · Интеграции

API Яндекс Карт

4 мин чтенияАвтор: Дмитрий КолесниковСоавторы: Евгений Баев

API Яндекс Карт – это набор программных интерфейсов Яндекса для работы с картой на сайте и в приложении: интерактивная карта (JavaScript API), поиск координат по адресу (Геокодер), подсказки адресов (Геосаджест), статичные изображения карт и маршруты.

Не путайте его с карточкой организации в Яндекс Картах. Карточка нужна, чтобы вас нашли на картах Яндекса, про неё статья Яндекс.Карты. API решает обратную задачу: показывает карту и данные Яндекса у вас на сайте.

Какие задачи на сайте закрывает API

Задача	Чем решают
Схема проезда с одной меткой	Конструктор карт или JavaScript API
Карта филиалов с фильтром по городу и услугам	JavaScript API с метками из вашей базы
Зоны доставки и цена по адресу	Полигоны в JavaScript API и Геокодер
Подсказки адреса в форме заказа	Геосаджест
Картинка карты в письме или PDF	Static API

Для одной метки на странице «Контакты» программист не нужен: Конструктор карт выдаёт готовый код для вставки. API берут, когда точек много, они меняются из админки или карта должна что-то считать.

Как работает проверка зоны доставки

Это самый частый сценарий для интернет-магазина и службы еды. Покупатель вводит адрес, Геокодер превращает его в координаты, сайт проверяет, в какой полигон попала точка, и показывает цену и срок для этой зоны.

Схема проверки зоны доставки через API Яндекс Карт: адрес покупателя, координаты от Геокодера, попадание в полигон, цена и срок — Как сайт проверяет зону доставки

Зоны рисуют один раз и хранят у себя на сайте. А вот координаты, которые вернул Геокодер, на бесплатных условиях сохранять в базе нельзя: их запрашивают заново. Об условиях ниже.

Где получить ключ

Ключ выдают в Кабинете разработчика Яндекса. Там нажимают «Получить ключ», выбирают сервис «JavaScript API» и заполняют форму. По документации ключ начинает работать в течение 15 минут. Потом его подставляют в адрес подключения:

<script src="https://api-maps.yandex.ru/2.1/?apikey=ВАШ_КЛЮЧ&lang=ru_RU"></script>

Это подключение версии 2.1. У Яндекса есть и документация JavaScript API 3.0 с руководством по переходу со старой версии. На какой версии делать новый проект, решает разработчик, но при доработке старого сайта сначала посмотрите, какая подключена сейчас.

Когда хватает бесплатных условий, а когда нужна лицензия

На октябрь 2026 года Яндекс разрешает бесплатное использование, если выполнены все условия:

Сравнение: когда API Яндекс Карт можно использовать бесплатно и когда нужна платная лицензия по условиям Яндекса — Бесплатные условия или лицензия

Сайт открыт любому пользователю. Регистрация допустима, но без оплаты и без документов, удостоверяющих личность.
Логотип, копирайты и кнопка «Открыть в Картах» видны и не перекрыты.
Нельзя сохранять и изменять данные, полученные через API, например менять порядок результатов поиска.
Нельзя отслеживать транспорт и курьеров в реальном времени.
Нельзя регулярно превышать суточный лимит запросов, иначе доступ блокируют без права восстановления.

Если хоть одно условие не выполняется, Яндекс советует оформить платную лицензию. Типичные случаи: карта в личном кабинете за платной подпиской, курьеры на карте в CRM. Поиск по организациям, Матрица расстояний и Router API на странице тарифов вообще идут только платно. Лимиты и стоимость смотрите там же.

Карта и скорость страницы

JavaScript API загружает заметный объём скриптов. Если карта стоит внизу «Контактов», её грузят, когда посетитель докрутил до неё или нажал «Показать карту». Иначе страница теряет баллы в PageSpeed Insights, хотя карту видят единицы. Подробнее в статье Скорость сайта.

Если вы выбираете между картографическими сервисами, сравнение с 2ГИС есть в статье API 2ГИС.

Ключ, условия и зоны доставки в API Яндекс Карт

Как получить ключ API Яндекс Карт?

Ключ API Яндекс Карт получают в Кабинете разработчика Яндекса: выбирают сервис «JavaScript API», заполняют форму и принимают условия. По документации ключ активируется в течение 15 минут.

При каких условиях API Яндекс Карт можно использовать бесплатно?

API Яндекс Карт бесплатен для открытых сайтов, где видны логотип и копирайты, данные не сохраняются и не меняются, нет слежения за транспортом в реальном времени и не превышается суточный лимит. В остальных случаях нужна платная лицензия, условия на странице тарифов.

Как вставить Яндекс Карту на сайт без программиста?

Простую карту с метками собирают в Конструкторе карт Яндекса и вставляют готовый код на страницу. Для зон доставки, фильтров филиалов и подсказок адреса этого уже мало, там нужен JavaScript API.

Почему Яндекс Карта на сайте перестала показываться?

Если Яндекс Карта на сайте пропала, проверьте ключ в коде подключения и не заблокирован ли доступ. Блокировка бывает при регулярном превышении суточного лимита или нарушении условий бесплатного использования. Ошибку обычно видно в консоли браузера.

Что делает Геокодер в API Яндекс Карт?

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

Чем API Яндекс Карт отличается от карточки организации в Яндекс Картах?

Карточка организации показывает вашу компанию внутри Яндекс Карт и поиска. API Яндекс Карт, наоборот, приносит карту и данные Яндекса на ваш сайт: схему проезда, филиалы, зоны доставки. Это разные инструменты, и одно не заменяет другое.

Ставим карты на сайт при разработке сайта и доработке существующего: схема проезда, карта филиалов из админки, зоны доставки с расчётом цены в корзине.