JavaScript API и Геокодер

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

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

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

Лимиты в API

Как начать использовать API

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

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

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

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

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

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

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

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

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

Внимание

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

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

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

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

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

Таблица 1. Тарифы с посуточной тарификацией и ежегодной оплатой

Лимит запросов в сутки Стоимость в год Стоимость каждой тысячи запросов сверх лимита
1000 запросов 150 000 рублей 300 рублей
10 000 запросов 450 000 рублей 150 рублей
25 000 запросов 850 000 рублей 125 рублей
50 000 запросов 1 400 000 рублей 125 рублей
100 000 запросов 1 680 000 рублей 125 рублей
200 000 запросов 2 380 000 рублей 90 рублей
300 000 запросов 3 330 000 рублей 90 рублей
500 000 запросов 4 850 000 рублей 90 рублей
1 000 000 запросов 8 500 000 рублей 45 рублей
Свыше 1 000 000 запросов Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов. Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.

Таблица 2. Тарифы с посуточной тарификацией и помесячной оплатой

Лимит запросов в сутки Стоимость в месяц Стоимость в месяц
1000 16 000 рублей 300 рублей
10 000 45 000 рублей 150 рублей

Примечание

Количество запросов сверх лимита округляется до тысячи в большую сторону в зависимости от выбранного тарифа. Например, на тарифе до 1 000 запросов в сутки 400 запросов сверх лимита будут округлены до 1 000. Если вы превысили лимит несколько раз за месяц, стоимость превышения считается отдельно за каждые сутки.

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

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

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

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

Лимит запросов в сутки Стоимость в год Стоимость каждой тысячи запросов сверх лимита
1000 запросов 174 000 рублей 300 рублей
10 000 запросов 522 000 рублей 150 рублей
25 000 запросов 986 000 рублей 125 рублей
50 000 запросов 1 700 000 рублей 125 рублей
100 000 запросов 2 040 000 рублей 125 рублей
200 000 запросов 2 890 000 рублей 90 рублей
300 000 запросов 4 020 000 рублей 90 рублей
500 000 запросов 5 860 000 рублей 90 рублей
1 000 000 запросов 10 370 000 рублей 45 рублей
Свыше 1 000 000 запросов Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов. Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.

Примечание

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

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

Лимиты в API

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

  • Количество запросов в секунду (RPS): до 50. Считается как сумма запросов со стороны клиента и со стороны сервера.

  • Общее число запросов в сутки. Лимит действует на использование сервисов:

    Геокодирование

    Тарифицируются операции:
    — обращение к 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=<идентификатор языка>&<дополнительные параметры>
    
    https://geocode-maps.yandex.ru/1.x/?apikey=<API-ключ>&lang=<идентификатор языка>&<дополнительные параметры>