JavaScript API и Геокодер

Общие сведения

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

API Геокодера — HTTP API, который позволяет по запросу определять координаты объектов по их адресу (и наоборот).

Ограничения платной версии

В платной версии JavaScript API доступна только подложка «схема». Это связано с тем, что лицензионные ограничения провайдеров данных не позволяют использовать спутниковые подложки в сторонних коммерческих проектах.

Как выглядит подложка «схема»

Лицензии и тарифы

Для продукта «JavaScript API и Геокодер» доступны два вида лицензии: стандартная и расширенная. Разница между ними заключается в следующем: в стандартной лицензии запрещается сохранять или изменять данные, полученные через API. В расширенной лицензии это ограничение снято.

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

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

Для получения доступа к расширенной лицензии, напишите нам с информацией о вашем проекте.

Стандартная лицензия

В стандартной лицензии запрещено сохранять или изменять данные, полученные с помощью API. Если вам необходима эта возможность, следует приобрести расширенную лицензию.

Ниже приведены доступные тарифы:

Лимит запросов в сутки Стоимость в год Стоимость каждых ста запросов сверх лимита Стоимость каждой тысячи запросов сверх лимита
до 300 запросов 18 000 рублей 100 рублей
до 600 запросов 36 000 рублей 100 рублей
до 1 000 запросов 120 000 рублей ­– 120 рублей
до 10 000 запросов 360 000 рублей ­– 36 рублей
до 25 000 запросов 600 000 рублей ­– 24 рубля
до 50 000 запросов 850 000 рублей ­– 17 рублей
до 100 000 запросов 1 000 000 рублей ­– 11 рублей
до 200 000 запросов 1 396 000 рублей ­– 9,5 рублей
до 300 000 запросов 1 792 000 рублей ­– 8 рублей
до 500 000 запросов 2 584 000 рублей ­– 5,2 рублей
до 1 000 000 запросов 4 564 000 рублей ­– 4,5 рублей
Свыше 1 000 000 запросов Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.
Лимит запросов в сутки Стоимость в год Стоимость каждых ста запросов сверх лимита Стоимость каждой тысячи запросов сверх лимита
до 300 запросов 18 000 рублей 100 рублей
до 600 запросов 36 000 рублей 100 рублей
до 1 000 запросов 120 000 рублей ­– 120 рублей
до 10 000 запросов 360 000 рублей ­– 36 рублей
до 25 000 запросов 600 000 рублей ­– 24 рубля
до 50 000 запросов 850 000 рублей ­– 17 рублей
до 100 000 запросов 1 000 000 рублей ­– 11 рублей
до 200 000 запросов 1 396 000 рублей ­– 9,5 рублей
до 300 000 запросов 1 792 000 рублей ­– 8 рублей
до 500 000 запросов 2 584 000 рублей ­– 5,2 рублей
до 1 000 000 запросов 4 564 000 рублей ­– 4,5 рублей
Свыше 1 000 000 запросов Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.
Примечание. Количество запросов сверх лимита округляется до ста или тысячи в большую сторону в зависимости от выбранного тарифа. Например, на тарифе до 300 запросов в сутки 40 запросов сверх лимита будут округлены до 100. А на тарифе до 1 000 запросов в сутки 400 запросов сверх лимита будут округлены до 1000. Если вы превысили лимит несколько раз за месяц, стоимость превышения считается отдельно за каждые сутки.

Как купить стандартную лицензию

Расширенная лицензия

Расширенная лицензия позволяет сохранять и изменять данные, полученные с помощью API.

Ниже приведены тарифы и стоимость лицензии:

Лимит запросов в сутки Стоимость в год Стоимость каждой тысячи запросов сверх лимита ?

до 1 000 запросов

620 000 рублей

120 рублей

до 10 000 запросов

860 000 рублей

36 рублей

до 25 000 запросов

1 100 000 рублей

24 рублей

до 50 000 запросов

1 350 000 рублей

17 рублей

до 100 000 запросов

1 500 000 рублей

11 рублей

до 200 000 запросов

1 896 000 рублей

9,5 рублей

до 300 000 запросов

2 292 000 рублей

8 рублей

до 500 000 запросов

3 084 000 рублей

5,2 рублей

до 1 000 000 запросов

5 064 000 рублей

4,5 рублей

Свыше 1 000 000 запросов

Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.

Лимит запросов в сутки Стоимость в год Стоимость каждой тысячи запросов сверх лимита ?

до 1 000 запросов

620 000 рублей

120 рублей

до 10 000 запросов

860 000 рублей

36 рублей

до 25 000 запросов

1 100 000 рублей

24 рублей

до 50 000 запросов

1 350 000 рублей

17 рублей

до 100 000 запросов

1 500 000 рублей

11 рублей

до 200 000 запросов

1 896 000 рублей

9,5 рублей

до 300 000 запросов

2 292 000 рублей

8 рублей

до 500 000 запросов

3 084 000 рублей

5,2 рублей

до 1 000 000 запросов

5 064 000 рублей

4,5 рублей

Свыше 1 000 000 запросов

Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.

Примечание. Опубликованные условия не являются офертой.

Как купить расширенную лицензию

Лимиты в API

Для продукта «JavaScript API и Геокодер» установлен суточный лимит на использование сервисов:

Геокодирование
Тарифицируются операции:
  • — обращение к HTTP API Геокодера;
  • — вызов функции geocode();
  • — получение местоположения пользователя через функцию geolocation.get(), при условии, что включено обратное геокодирование (опция 'autoReverseGeocode' выставлена в true);
  • — построение маршрута, при условии, что его точки задаются адресом, как в примере. Каждый адрес инициирует отдельный запрос в геокодер;
  • — поиск по карте через элемент управления control.SearchControl (с любым провайдером поиска).
Не тарифицируются операции:
  • — геолокация с отключенным обратным геокодированием (опция 'autoReverseGeocode' выставлена в false);
Маршрутизация

Тарифицируются все операции, отправляющие запрос к Маршрутизатору:

— вызов функции route();

— создание экземпляра класса multiRouter.MultiRoute;

— построение маршрута через элемент управления control.RouteEditor;

— изменение опций маршрутизатора, приводящее к перестроению маршрута. Например, включение учета пробок или смена типа маршрутизации.

— редактирование построенного маршрута: добавление, удаление и перетаскивание его точек*.

* При перетаскивании точек маршрута запросы к маршрутизатору отправляются в среднем каждые 3с при достаточной скорости ответа сервера. Для мультимаршрутизатора этот интервал можно увеличить опцией dragUpdateInterval. При необходимости можно полностью отключить перестроение маршрута во время его редактирования через опцию preventDragUpdate.

Поиск панорам

Тарифицируются операции:

  • — вызов функции panorama.locate() для поиска панорам в окрестностях заданной точки;
  • — вызов функции panorama.createPlayer() для создания плеера на странице;
  • — вызов метода panorama.Manager.openPlayer() для отображения плеера с панорамой Яндекса.
Не тарифицируются следующие операции:
  • — переходы между связанными панорамами внутри открытого плеера, например переходы по стрелкам;
  • — создание плеера с собственной панорамой;
  • — добавление слоя панорам на карту.

Какой лимит запросов будет установлен — зависит от выбранного тарифа. Например, в тарифе "до 1 000 запросов" вы сможете отправить не более тысячи запросов к сервисам геокодирования, маршрутизации и поиска панорам. За все последующие запросы сверх лимита будет выставлен отдельный счет согласно тарифу. Этот счет будет виден в Кабинете разработчика в разделе «Финансы».

  • Как считаются запросы

Число запросов к API считается по следующей формуле:

число запросов в Геокодер + число запросов в Маршрутизатор + 5 × число запросов к Панорамам

Внимание. Один запрос к сервису Панорам равен пяти запросам в счетчике. Например, если при тарифе "до 1 000 запросов" вы отправили 200 запросов к Панорамам, то за все последующие запросы будет выставлен отдельный счет согласно тарифу.

Как начать использовать JavaScript API и Геокодер

Для использования платной версии API:

  1. Приобретите лицензию. Как купить лицензию
  2. Ознакомьтесь с документацией к JavaScript API и Геокодеру.
  3. Подключите API по ссылке:
    https://enterprise.api-maps.yandex.ru/<номер версии>/?apikey=<API-ключ>&lang=<идентификатор языка>&<дополнительные параметры>