JavaScript API и Геокодер

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Максимальное количество Запросов в течение Срока действия лицензии Минимальный платеж Цена ста Запросов при превышении лимита Запросов по минимальному платежу Цена одной тысячи Запросов при превышении лимита Запросов по минимальному платежу
Стандартная лицензия Расширенная лицензия
10 000 8 000 рублей 500 рублей
Максимальное количество Запросов в течение Срока действия лицензии Минимальный платеж Цена ста Запросов при превышении лимита Запросов по минимальному платежу Цена одной тысячи Запросов при превышении лимита Запросов по минимальному платежу
Стандартная лицензия Расширенная лицензия
10 000 8 000 рублей 500 рублей

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

Лимит запросов в сутки Стоимость в год Стоимость каждых ста запросов сверх лимита Стоимость каждой тысячи запросов сверх лимита
до 300 запросов* 36 000 рублей 100 рублей
до 600 запросов* 72 000 рублей 100 рублей
до 1 000 запросов 120 000 рублей 240 рублей
до 10 000 запросов 360 000 рублей 120 рублей
до 25 000 запросов 680 000 рублей 90 рублей
до 50 000 запросов 1 000 000 рублей 90 рублей
до 100 000 запросов 1 200 000 рублей 90 рублей
до 200 000 запросов 1 700 000 рублей 60 рублей
до 300 000 запросов 2 300 000 рублей 60 рублей
до 500 000 запросов 3 450 000 рублей 60 рублей
до 1 000 000 запросов 6 430 000 рублей 30 рублей
Свыше 1 000 000 запросов Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.
Лимит запросов в сутки Стоимость в год Стоимость каждых ста запросов сверх лимита Стоимость каждой тысячи запросов сверх лимита
до 300 запросов* 36 000 рублей 100 рублей
до 600 запросов* 72 000 рублей 100 рублей
до 1 000 запросов 120 000 рублей 240 рублей
до 10 000 запросов 360 000 рублей 120 рублей
до 25 000 запросов 680 000 рублей 90 рублей
до 50 000 запросов 1 000 000 рублей 90 рублей
до 100 000 запросов 1 200 000 рублей 90 рублей
до 200 000 запросов 1 700 000 рублей 60 рублей
до 300 000 запросов 2 300 000 рублей 60 рублей
до 500 000 запросов 3 450 000 рублей 60 рублей
до 1 000 000 запросов 6 430 000 рублей 30 рублей
Свыше 1 000 000 запросов Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов.

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

Максимальное количество Запросов в сутки Минимальный платеж Цена ста Запросов при превышении лимита Запросов по минимальному платежу
1 000 14 000 рублей 240 рублей
10 000 38 000 рублей 120 рублей
Максимальное количество Запросов в сутки Минимальный платеж Цена ста Запросов при превышении лимита Запросов по минимальному платежу
1 000 14 000 рублей 240 рублей
10 000 38 000 рублей 120 рублей

* Лицензиат имеет право выбрать тариф только в случае наличия у него оплаченного тарифа для программного обеспечения «API Построение и оптимизация маршрутов» и/или «Яндекс.Курьер». В ином случае Лицензиар вправе приостановить предоставление права использования ПО до перехода Лицензиата на применимый тариф (1000 (одна тысяча) Запросов в сутки или более) и/или досрочно отказаться от исполнения Договора.

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

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

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

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

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

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

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

620 000 рублей

240 рублей

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

860 000 рублей

120 рублей

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

1 180 000 рублей

90 рублей

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

1 500 000 рублей

90 рублей

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

1 700 000 рублей

90 рублей

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

2 200 000 рублей

60 рублей

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

2 800 000 рублей

60 рублей

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

3 950 000 рублей

60 рублей

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

6 930 000 рублей

30 рублей

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

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

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

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

620 000 рублей

240 рублей

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

860 000 рублей

120 рублей

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

1 180 000 рублей

90 рублей

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

1 500 000 рублей

90 рублей

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

1 700 000 рублей

90 рублей

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

2 200 000 рублей

60 рублей

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

2 800 000 рублей

60 рублей

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

3 950 000 рублей

60 рублей

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

6 930 000 рублей

30 рублей

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

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