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

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

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

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

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

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

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

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

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

Хочу следить за лимитом запросов. Есть ли в бесплатной версии API специальный инструмент?

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

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

Как я узнаю о превышении в бесплатной версии API Карт?

В случае превышения суточного лимита запросов Геокодер и Маршрутизатор будут возвращать статус 429. При обращении к Геокодеру, Маршрутизатору и панорамам через JavaScript API вы получите сообщение об ошибке.

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

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

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

Мой сайт не работает или работает некорректно в браузере IE.

Из всех браузеров Microsoft IE в API Карт полностью поддерживается только IE11. Версии IE8, IE9 и IE10 поддерживаются в API частично. В этих браузерах доступна та функциональность API, которую технически возможно реализовать на данной платформе. Например, в IE8 не поддерживается задание произвольных цветов меток, так как в этом браузере отсутствует поддержка SVG.

Для пользователей, которые работают в браузерах IE8, IE9 и IE10, будет подключаться версия 2.1.oldie.1 (даже если в ссылке подключения указана другая версия API). Версия 2.1.oldie.1 функционально соответствует версии 2.1.59 и не содержит более поздних обновлений.

Если необходимо поддерживать браузеры IE8, IE9 и IE10, при написании кода ориентируйтесь на справочник версии 2.1.59 (скачать справочник ). Использование функциональности более поздних версий может привести к некорректной работе API в IE8, IE9 и IE10.

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

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

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

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

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

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

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

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

Можно ли с помощью 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?

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

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

Если ваш блогохостинг запрещает использование скриптов, то вставить интерактивную карту с помощью 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, но карта не отображается. Что я делаю не так?

    Убедитесь, что при создании экземпляра карты вы указали верный идентификатор DOM-элемента. Проверьте, заданы ли размеры контейнера, в котором размещается карта (они должны быть ненулевыми). Карта не отобразится, если на момент ее создания код 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.

Почему при обращении к HTTP геокодеру в ответе периодически появляется 429 ошибка?

Это означает, что вы превышаете суточный лимит запросов к бесплатной версии API. Общее число обращений к сервисам геокодирования, маршрутизации и панорам Яндекса не должно превышать 25 000 запросов в сутки (см. Лимиты запросов к API ). Вам необходимо оптимизировать количество запросов к API либо увеличить суточный лимит, используя платную версию API .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    <число запросов в Геокодер> + <число запросов в Маршрутизатор> + 5 × <число запросов к панорамам>.

Для API Поиска по организациям и Static API запросы рассчитываются стандартным образом:

    одно обращение к сервису по HTTP равно одному запросу в счетчике лимитов.

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

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

    Определите, какие сервисы вы будете использовать в своем проекте: JavaScript API, HTTP API Геокодера, API Поиска по организациям или Static API. Выберите пакеты, которые необходимо подключить:

      JavaScript API и HTTP API Геокодера , API Поиска по организациям , Static API .

    Для нужного пакета ознакомьтесь с условиями использования, лимитами и тарифами. Оцените нагрузку вашего проекта и выберите подходящий тариф.

Авторизауйтесь на Яндексе и зайдите в Кабинет разработчика. Нажмите «Получить ключ». В появившемся окне задайте имя ключа (например, название проекта) и выберите нужный пакет:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Бесплатная версия API не предоставляет инструмента для отслеживания количества обращений к сервисам. Рекомендуем самостоятельно настроить логирование запросов и считать их количество по логам на вашей стороне. О запросах, которые тарифицируются, см. в разделе Лимиты запросов к API .

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

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

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

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