JavaScript 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:
-
Приобретите лицензию. Как купить лицензию
-
Ознакомьтесь с документацией к JavaScript API и Геокодеру.
-
Подключите API по ссылке:
JavaScript API:Геокодер:https://enterprise.api-maps.yandex.ru/<номер версии>/?apikey=<API-ключ>&lang=<идентификатор языка>&<дополнительные параметры>https://geocode-maps.yandex.ru/1.x/?apikey=<API-ключ>&lang=<идентификатор языка>&<дополнительные параметры>
При перетаскивании точек маршрута запросы к маршрутизатору отправляются в среднем каждые 3с при достаточной скорости ответа сервера. Для мультимаршрутизатора этот интервал можно увеличить опцией dragUpdateInterval. При необходимости можно полностью отключить перестроение маршрута во время его редактирования через опцию preventDragUpdate.