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

Общие вопросы
Технические вопросы
Платная версия API Карт

Общие вопросы

Как мне добавить карту на свой сайт?

Ниже перечислены инструменты, с помощью которых вы можете добавить карту Яндекса на свой сайт:

Инструмент Описание

Конструктор карт

Позволяет создавать в визуальном редакторе интерактивные и статические карты. На карте можно отмечать объекты — метки, линии, многоугольники. Стили объектов можно настраивать, например менять иконки меток или задавать цвет линий.

Инструмент не требует навыка программирования.

Виджет Карт

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

Инструмент не требует навыка программирования.

Геоссылка

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

Инструмент не требует навыка программирования.

JavaScript API

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

Ознакомьтесь с документацией и примерами. Напишите и разместите JavaScript-код на страницах своего сайта. Этого достаточно, чтобы ваши пользователи увидели карту на странице.

MapKit SDK

Кроссплатформенная библиотека, которая позволяет использовать возможности Яндекс.Карт в мобильных приложениях. С помощью MapKit на карте можно прокладывать маршруты, искать организации, отображать панорамы и др.

Static API

HTTP API, который в ответ на запрос возвращает статическое изображение карты.

Модули для CMS

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

Могу ли я бесплатно использовать API Карт на своем сайте?

API Карт можно использовать бесплатно, если соблюдать все условия, перечисленные в разделе Условия использования API Яндекс.Карт. Если хотя бы одно из условий не выполняется, необходимо приобрести платную версию API. Для использования API нужно получить ключ в Кабинете разработчика.

Какие есть лимиты в API Карт?

В бесплатной версии API установлены следующие лимиты:

  • Общее число обращений к сервисам геокодирования, маршрутизации и панорам Яндекса не должно превышать 25 000 запросов в сутки. Учитывайте этот лимит, если вы используете JavaScript API или HTTP API Геокодера. Подробнее о лимитах.
  • Число обращений к API Поиска по организациям не должно превышать 500 запросов в сутки.

Если вам необходимо изменить установленные лимиты, следует приобрести платную версию API.

Как получить ключ для бесплатной версии JavaScript API Карт?

Ключ для бесплатной версии JavaScript API можно получить в Кабинете разработчика.

Нужен ли ключ для бесплатной версии HTTP API Геокодера?

HTTP API Геокодера доступен только при использовании ключа. Получить ключ можно в Кабинете разработчика.

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

  • Ссылка для доступа к бесплатной версии JavaScript API:

    https://api-maps.yandex.ru/<номер версии>/?lang=<идентификатор языка>&apikey=<API-ключ>&<дополнительные параметры>
  • Ссылка для доступа к платной версии JavaScript API:

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

Нужен ли ключ для бесплатной версии Static API?

Нет, для работы с бесплатной версией Static API ключи не нужны.

Какие браузеры поддерживает API Карт?

Список поддерживаемых браузеров опубликован в документации (список регулярно обновляется). Полная работоспособность всей функциональности JavaScript API гарантируется только в последних версиях поддерживаемых браузеров.

Обратите внимание, Платная версия JavaScript API не поддерживает браузер Internet Explorer 8.

Можно ли с помощью API получить данные и не показывать их на карте?

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

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

Можно ли использовать API Яндекс.Карт для отображения своих карт?

Да, с помощью API Яндекс.Карт вы можете отображать собственные карты, а также карты сторонних сервисов.

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

Можно ли отображать карты Яндекса через сторонние API?

Нет, это запрещено.

Можно ли сохранять ответ Геокодера?

Нет, ответ Геокодера сохранять нельзя (см. пункт 4 в условиях использования). Однако разрешается кэшировать ответ на срок до 30 дней.

Если по каким-то причинам вам необходимо сохранять результат геокодирования, напишите нам.

Что делать, если на карте нет нужного объекта (здания/парка/улицы)?

Вы можете нарисовать его сами в Народной карте. После проверки модераторами, правки появятся на основной карте Яндекса и будут доступны через API. Также вы можете предложить дополнить карту посетителям вашего сайта.

Если на карте нет нужной организации (кафе/ресторана/фитнес-клуба), то вы можете добавить ее в Справочник организаций.

Удаляются ли фиксированные версии JavaScript API Карт?

Да, со временем мы можем отключить устаревшую минорную версию JavaScript API. Если вы использовали эту версию в своем проекте, то у вас автоматически подключится последняя версия API. Обратите внимание, может оказаться, что при смене версий ваше приложение стало работать некорректно. Поэтому мы рекомендуем следить за обновлениями API и своевременно переключаться на более свежие версии. Подробнее о версиях API.

Доступен ли в JavaScript API поиск по организациям?

Чтобы подключить поиск по организациям в JavaScript API, настройте в качестве провайдера для поисковой строки 'yandex#search'. Открыть пример

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

Какие типы организаций представлены в API Поиска по организациям?

Доступные типы организаций можно посмотреть в файле (формат .xlsx).

Технические вопросы

Как подключить фиксированную версию JavaScript API?

Для этого в ссылке подключения необходимо указать номер этой версии, например:

<script src="https://api-maps.yandex.ru/2.1.40/?apikey=<API-ключ>&lang=ru_RU" type="text/javascript">
</script>
Примечание. Со временем мы можем отключить устаревшую минорную версию JavaScript API. Если вы использовали эту версию в своем проекте, то у вас автоматически подключится последняя версия API.

Как вставить карту в блог, если в нем запрещены скрипты?

Если ваш блогохостинг запрещает использование скриптов, то вставить интерактивную карту с помощью JavaScript API не получится. Для вставки интерактивной карты вы можете воспользоваться Виджетом Карт. При добавлении Виджета на сайт карта будет размещена в отдельном iframe.

Вы также можете использовать статическое изображение карты. Для получения изображения карты воспользуйтесь Конструктором карт либо Static API.

Я перешел с JavaScript API 2.0 на версию 2.1, но код перестал работать. Есть ли инструкции по переходу?

Версии 2.0 и 2.1 являются обратно несовместимыми. Ознакомьтесь с Руководством по переходу на JavaScript API 2.1.

Можно ли использовать API карт на сайте с CSP?

Можно. Подробнее читайте в документации в разделе Подключение API при использовании CSP.

Я размещаю на сайте карту с помощью JavaScript API, но карта не отображается. Что я делаю не так?

  1. Убедитесь, что при подключении АПИ вы передаете правильный ключ. Если у вас нет ключа, получите его в Кабинете разработчика.
  2. Убедитесь, что при создании экземпляра карты вы указали верный идентификатор DOM-элемента.
  3. Проверьте, заданы ли размеры контейнера, в котором размещается карта (они должны быть ненулевыми).
  4. Карта не отобразится, если на момент ее создания код API еще не был загружен. Чтобы при работе с картой код API был гарантированно загружен, его рекомендуется размещать в функции ymaps.ready(). Подробнее см. в разделе Готовность API.

Можно ли сохранить состояние карты в URL?

Можно, см. пример.

Как добавить на карту собственный слой?

См. пример.

Почему на моем сайте геолокация перестала работать или стала определять неточное положение?

Вероятнее всего ваш сервис расположен на http-домене. Google запретил определение местоположения средствами браузера на не https-доменах. В этом случае в консоли браузера выводится соответствующая информация: https://sites.google.com/a/chromium.org/dev/Home/chromium-security/deprecating-powerful-features-on-insecure-origins

Я задаю свойства/опции объектам карты, но они не применяются. В чем может быть проблема?

Возможно, вы неправильно используете систему префиксов при задании свойств или опций. Например, чтобы задать свойства для значка метки, нужно использовать префикс 'icon' (iconLayout), чтобы задать свойства для значка кластера, нужно использовать префикс 'clusterIcon' (clusterIconLayout). Кроме того, использование префиксов зависит от того, на каком уровне задаются свойства — через сам объект, через его коллекцию или на уровне карты. Подробнее см. Использование префиксов в названиях опций.

Можно ли изменить внешний вид точек маршрута?

Можно. Пример в песочнице: Настройка отображения мультимаршрута.

Почему при использовании кластеризации метки не отображаются на карте?

Возможно, вы добавляете на карту одновременно и кластер, и отдельные метки, входящие в этот кластер. Добавлять нужно только кластер. Подробнее см. Кластеры.

Я хочу рассчитать площадь полигона/прямоугольника/круга на геодезической поверхности. Есть ли в API специальный инструмент?

Для вычисления геодезической площади фигур можно воспользоваться внешним модулем: https://github.com/yandex/mapsapi-area. Модуль может использоваться совместно с API.

Геокодер возвращает пустой результат или не тот результат, который я хочу увидеть. Что делать в этом случае?

  1. Если вы используете обратное геокодирование, убедитесь, что в запросе указаны координаты в правильной последовательности. По умолчанию Геокодер принимает координаты в последовательности «долгота, широта». Изменить порядок координат можно в параметре sco.
  2. Убедитесь, что вы указали корректные границы поиска (параметры bbox или ll+spn). Возможно, искомый объект находится за пределами заданной области поиска.
  3. Если искомого объекта нет на самой карте Яндекса, вы можете нарисовать его на Народной карте или сообщить об ошибке на странице Яндекс.Карт.

При нажатии на кнопку «Открыть в Яндекс.Картах» открывается карта без части маркеров. Почему?

В такой ситуации на большую карту передается только 10 точек, ближайших к центру карты. Чтобы передать больше точек, используйте карту, созданную в Конструкторе карт.

Конструктор Карт

Можно ли редактировать карту, созданную в Конструкторе карт?

Можно. Обратите внимание, что редактировать карту может только ее автор.

Могут ли другие пользователи видеть список моих карт?

Список карт, созданных в Конструкторе, доступен только их автору.

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

На данный момент в Конструкторе карт нет режима совместного редактирования, т. е. карта привязана к аккаунту автора. При необходимости вы можете использовать общий аккаунт.

Кому видна моя карта?

Пока вы не разместите код карты на сайте и не поделитесь публичной ссылкой на нее ― карта будет видна только вам.

При открытии CSV-файла в Microsoft Excel возникает проблема с кодировкой. Что делать?

Проблемы с кодировкой связаны с особенностями работы Microsoft Excel. Для корректного отображения CSV-файла рекомендуем воспользоваться любым другим редактором.

Кроме того, для экспорта объектов карты вы можете использовать формат XSLX. Файлы этого формата будут корректно отображаться в Microsoft Excel. Подробнее об экспорте объектов карты.

Как перенести карту в другой аккаунт?

  1. Авторизуйтесь в Яндексе и затем выполните экспорт карты, которую хотите перенести на другой аккаунт. В качестве формата для экспорта мы рекомендуем использовать KML. Он позволяет сохранить больше свойств и данных по сравнению с другими форматами.
  2. Авторизуйтесь под аккаунтом, в который нужно перенести карту.
  3. Импортируйте нужную карту.

Платная версия API Карт

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Определите, какие сервисы вы будете использовать в своем проекте: JavaScript API, HTTP API Геокодера, API Поиска по организациям или Static API.
  2. Выберите пакеты, которые необходимо подключить: Для нужного пакета ознакомьтесь с условиями использования, лимитами и тарифами. Оцените нагрузку вашего проекта и выберите подходящий тариф.
  3. Авторизуйтесь на Яндексе и зайдите в Кабинет разработчика. Нажмите «Получить ключ». В появившемся окне задайте имя ключа (например, название проекта) и выберите нужный пакет:

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

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

Напомним, что сервисы в рамках API Яндекс.Карт объединены в 4 пакета:

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

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

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

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

Можно ли получить тестовый ключ к платной версии 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 рублей в год.

У меня другой вопрос

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