JavaScript API и Геокодер

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

до 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 рублей

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

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

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

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

Расширенная лицензия позволяет сохранять и изменять данные, полученные с помощью 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 руб.

Свыше 100 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=<идентификатор языка>&<дополнительные параметры>