Часто задаваемые вопросы

Ответы

В чем отличия платной версии API Карт от бесплатной?

Отличия заключаются в следующем:

  • В платной версии API Карт сняты ограничения бесплатной версии. Например, платную версию можно использовать в коммерческих проектах, в приложениях с ограниченным доступом или в системах мониторинга.
  • Подложки «Спутник» и «Гибрид» недоступны в платных версиях JavaScript API и Static API. Это связано с тем, что лицензионные ограничения провайдеров данных не позволяют использование спутниковых подложек в сторонних коммерческих проектах.
  • Для платной версии не поддерживается браузер Internet Explorer 8.

Какие сервисы доступны в платном API Карт?

API Яндекс.Карт включает в себя несколько отдельных сервисов и программных библиотек. Для удобства подсчета запросов сервисы объединены в 4 пакета:

Запросы, сделанные к API из разных пакетов, не суммируются и тарифицируются отдельно. Это означает, что если вы собираетесь использовать Геокодер и Поиск по организациям, то вам необходимо выбрать свой тариф для каждого из соответствующих пакетов.

Как мне понять, подходит ли мне бесплатная версия API или нужно приобрести платную?

Внимательно ознакомьтесь с условиями использования бесплатной версии. Если ваш проект предполагает нарушение хотя бы одного из условий (например, вы будете использовать API Карт во внутренней сети компании), следует приобрести платную версию API.

Какие операции тарифицируются в JavaScript API?

В JavaScript API тарифицируются все операции, в которых отправляются запросы к сервисам геокодирования, маршрутизации и поиска панорам. Например, если на карту нужно добавить метку по какому-нибудь адресу (то есть будет использоваться Геокодер), такое действие будет тарифицироваться. Если на карту нужно просто добавить метку по географическим координатам, то эта операция тарифицироваться не будет. Подробнее о том, как считаются запросы.

Как считаются запросы при подсчете суточного использования сервиса?

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

  • <число запросов в Геокодер> + <число запросов в Маршрутизатор> + 5 × <число запросов к панорамам>.
Для API Поиска по организациям и Static API запросы рассчитываются стандартным образом:
  • одно обращение к сервису по HTTP равно одному запросу в счетчике лимитов.

Суточный лимит запросов для каждого сервиса устанавливается выбранным тарифом. Запросы, сделанные к API из разных пакетов, не суммируются и тарифицируются отдельно. Это означает, что если вы собираетесь использовать Геокодер и Поиск по организациям, то вам необходимо выбрать свой тариф для каждого из пакетов.

Я хочу купить платную версию API Карт. Что мне нужно сделать?

Подробная инструкция доступна в разделе Как купить лицензию.

Как правильно указать ключ в коде?

  • Ссылка для доступа к JavaScript API:

    https://enterprise.api-maps.yandex.ru/<номер версии>/?lang=<идентификатор языка>&apikey=<API-ключ>&<дополнительные параметры>
  • Ссылка для доступа к HTTP API Геокодера:
    https://geocode-maps.yandex.ru/1.x/?lang=<идентификатор языка>&apikey=<API-ключ>&<дополнительные параметры> 
  • Ссылка для доступа к API Поиска по организациям:
    https://search-maps.yandex.ru/v1/?apikey=<ключ>&<дополнительные параметры> 
  • Для доступа к бесплатной версии Static API ключ не нужен. Ссылка для доступа к платной версии Static API:

    https://enterprise.static-maps.yandex.ru/1.x/?key=<API-ключ>&<дополнительные параметры>

Я использую один ключ для разных сервисов. Суммируются ли запросы к этим сервисам или считаются отдельно?

Запросы, сделанные к сервисам из разных пакетов, не суммируются и тарифицируются отдельно. Например, если вы используете один и тот же ключ при обращении к Геокодеру и Поиску по организациям, запросы все равно будут считаться отдельно в соответствии с тарифом, выбранным для каждого из двух пакетов.

Что произойдет в случае превышения купленного лимита?

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

Где можно посмотреть информацию о тарифах и стоимости превышений?

Информацию о тарифах вы можете посмотреть в описаниях сервисов, либо в разделе «Финансы» в Кабинете разработчика.

Можно ли получить тестовый ключ к платной версии JavaScript API?

Платная версия JavaScript API включает в себя ту же функциональность, что и бесплатная версия. Чтобы ознакомиться с возможностями API, используйте бесплатную версию.

Внимание. При использовании бесплатной версии JavaScript API необходимо учитывать ограничения.

Если вам необходимо протестировать JavaScript API, выходя за рамки ограничений (например, в закрытых системах), — напишите нам. В письме укажите: для какого проекта необходим ключ и на какой период. Также укажите ожидаемое количество запросов к сервисам геокодирования, маршрутизации и панорам. После обработки заявки с вами свяжется менеджер.

Можно ли получить тестовый ключ к платной версии API Поиска по организациям?

Вы можете ознакомиться с возможностями API Поиска по организациям, используя бесплатную версию. Чтобы получить ключ для бесплатной версии, перейдите в Кабинет разработчика и выберите «Получить ключ». Заполните необходимые поля, оставив пункт «Мне нужна платная версия» пустым. После того как заявка будет отправлена, будет сгенерирован ключ. Он активируется автоматически при получении, поэтому вы можете сразу начать его использовать в своем проекте. Чтобы в дальнейшем перейти на платную версию API, напишите нам, указав в письме полученный ключ.

Внимание. В бесплатной версии API Поиска по организациям установлен лимит в 500 запросов в сутки. Кроме того, необходимо соблюдать ряд ограничений.

Если вам необходимо использовать тестовый ключ в одном из условий (например, в закрытой системе), — напишите нам. В письме укажите описание вашего проекта и на какой период вам нужен тестовый ключ. Также укажите ожидаемое количество запросов к API. После обработки заявки с вами свяжется менеджер.

У вас указана стоимость тарифа только за год, можно ли оплачивать помесячно?

При покупке тарифа возможен только вариант оплаты за год.

Где следить за статистикой запросов? Как часто она обновляется?

Чтобы посмотреть статистику запросов:

  1. Зайдите в Личный кабинет.
  2. Выберите нужный ключ (в левом меню).
  3. В правой части страницы укажите день или период, за который вы хотите получить статистику, и нажмите «Показать».

В статистике показываются как суммарное число запросов к API, так и число запросов к отдельным сервисам (например, Геокодеру, Маршрутизатору, панорамам). Статистика обновляется с задержкой в час.

Можно ли перенести ключ на другой аккаунт? Например, в случае увольнения сотрудника.

Нет, перенести ключ на другой аккаунт нельзя. Мы рекомендуем получать ключи для общего корпоративного аккаунта.

Я забыл пароль от аккаунта, на который зарегистрирован ключ. Как мне быть?

Следуйте инструкциям по восстановлению пароля.

Я использую бесплатный API Карт, но у моего сайта/приложения возрастает объем трафика. Как мне отслеживать количество запросов к API, чтобы своевременно перейти на платную версию?

Статистика запросов к API доступна на странице Ключи в Кабинете разработчика.

Почему в платной версии не поддерживаются Спутник и Гибрид? В бесплатной версии они есть.

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

Мой проект не будет использовать сервисы геокодирования, маршрутизации и поиска панорам. Сколько будет стоить лицензия на JavaScript API?

В этом случае стоимость лицензии на JavaScript API составит 120 000 рублей в год.