ключ для maps api что это яндекс карт
Как получить API-ключ для подключения Яндекс.Карт?
Компания Яндекс обновила политику использования карт. Теперь, чтобы добавить карту на сайт, нужно получить API ключ и указать его в настройках виджета «Карты».
Перейдите на страницу Кабинета разработчика Яндекс и нажмите на кнопку «Подключить API».
Во всплывающем окне вам нужно выбрать тип ключа «JavaScript API и HTTP Геокодер».
На следующем шаге заполните поля формы Яндекс, указав ФИО, email для связи, телефон и название вашей компании. Далее выберите настройки для бесплатного использования API Яндекс.Карт: использование «в открытой» системе, «в бесплатном» проекте и с «отображением данных на карте». Укажите адрес вашего сайта в uKit и краткое описание сервиса, а также поставьте подтверждение, что вы согласны с условиями использования API Яндекс.Карт, и введите капчу. Нажмите «Продолжить».
Примечание
Все сайты uKit соответствуют условиям использования бесплатной версии API Яндекс.Карт, с которыми вы можете ознакомиться здесь.
На последнем этапе создания API ключа вам нужно указать для него любое желаемое название.
На открывшейся странице отобразится созданный вами API ключ.
Скопируйте ключ, сформированный Яндексом, перейдите в конструктор вашего сайта и вставьте ключ в настройках виджета «Карты», выбрав Яндекс.Карты.
После проделанных действий карта Яндекс успешно подключится на вашем сайте.
Часто задаваемые вопросы
Ответы
В чем отличия платной версии API Карт от бесплатной?
Отличия заключаются в следующем:
Какие сервисы доступны в платном API Карт?
API Яндекс.Карт включает в себя несколько отдельных сервисов и программных библиотек. Для удобства подсчета запросов сервисы объединены в 4 пакета:
Запросы, сделанные к API из разных пакетов, не суммируются и тарифицируются отдельно. Это означает, что если вы собираетесь использовать Геокодер и Поиск по организациям, то вам необходимо выбрать свой тариф для каждого из соответствующих пакетов.
Как мне понять, подходит ли мне бесплатная версия API или нужно приобрести платную?
Внимательно ознакомьтесь с условиями использования бесплатной версии. Если ваш проект предполагает нарушение хотя бы одного из условий (например, вы будете использовать API Карт во внутренней сети компании), следует приобрести платную версию API.
Какие операции тарифицируются в JavaScript API?
В JavaScript API тарифицируются все операции, в которых отправляются запросы к сервисам геокодирования, маршрутизации и поиска панорам. Например, если на карту нужно добавить метку по какому-нибудь адресу (то есть будет использоваться Геокодер), такое действие будет тарифицироваться. Если на карту нужно просто добавить метку по географическим координатам, то эта операция тарифицироваться не будет. Подробнее о том, как считаются запросы.
Как считаются запросы при подсчете суточного использования сервиса?
Для JavaScript API и Геокодер и MapKit суммарное число запросов рассчитывается по формуле:
Суточный лимит запросов для каждого сервиса устанавливается выбранным тарифом. Запросы, сделанные к API из разных пакетов, не суммируются и тарифицируются отдельно. Это означает, что если вы собираетесь использовать Геокодер и Поиск по организациям, то вам необходимо выбрать свой тариф для каждого из пакетов.
Я хочу купить платную версию API Карт. Что мне нужно сделать?
Подробная инструкция доступна в разделе Как купить лицензию.
Как правильно указать ключ в коде?
Ссылка для доступа к JavaScript API:
Для доступа к бесплатной версии Static API ключ не нужен. Ссылка для доступа к платной версии Static API:
Я использую один ключ для разных сервисов. Суммируются ли запросы к этим сервисам или считаются отдельно?
Запросы, сделанные к сервисам из разных пакетов, не суммируются и тарифицируются отдельно. Например, если вы используете один и тот же ключ при обращении к Геокодеру и Поиску по организациям, запросы все равно будут считаться отдельно в соответствии с тарифом, выбранным для каждого из двух пакетов.
Что произойдет в случае превышения купленного лимита?
При достижении суточного лимита сервис блокируется до конца дня. Как оплатить превышения заранее написано в разделе Расчет стоимости превышений.
Где можно посмотреть информацию о тарифах и стоимости превышений?
Информацию о тарифах вы можете посмотреть в описаниях сервисов, либо в разделе «Финансы» в Кабинете разработчика.
Можно ли получить тестовый ключ к платной версии JavaScript API?
Платная версия JavaScript API включает в себя ту же функциональность, что и бесплатная версия. Чтобы ознакомиться с возможностями API, используйте бесплатную версию.
Если вам необходимо протестировать JavaScript API, выходя за рамки ограничений (например, в закрытых системах), — напишите нам. В письме укажите: для какого проекта необходим ключ и на какой период. Также укажите ожидаемое количество запросов к сервисам геокодирования, маршрутизации и панорам. После обработки заявки с вами свяжется менеджер.
Можно ли получить тестовый ключ к платной версии API Поиска по организациям?
Если вам необходимо использовать тестовый ключ в одном из условий (например, в закрытой системе), — напишите нам. В письме укажите описание вашего проекта и на какой период вам нужен тестовый ключ. Также укажите ожидаемое количество запросов к API. После обработки заявки с вами свяжется менеджер.
У вас указана стоимость тарифа только за год, можно ли оплачивать помесячно?
При покупке тарифа возможен только вариант оплаты за год.
Где следить за статистикой запросов? Как часто она обновляется?
JavaScript API и Геокодер
Общие сведения
JavaScript API — это программная библиотека для работы с картами в браузерах. Поможет встроить на сайт карту с поиском по топонимам и организациям, с возможностью строить маршруты и смотреть панорамы, а также с другими функциями, доступными на Яндекс.Картах.
API Геокодера — HTTP API, который позволяет по запросу определять координаты объектов по их адресу (и наоборот).
Ограничения платной версии
Лицензии и тарифы
Для продукта «JavaScript API и Геокодер» доступны два вида лицензии: стандартная и расширенная. Разница между ними заключается в следующем: в стандартной лицензии запрещается сохранять или изменять данные, полученные через API. В расширенной лицензии это ограничение снято.
Стоимость лицензий зависит от количества запросов, которые сайт будет отправлять к API. Какие запросы тарифицируются
Для получения доступа к расширенной лицензии, напишите нам с информацией о вашем проекте.
Стандартная лицензия
В стандартной лицензии запрещено сохранять или изменять данные, полученные с помощью API. Если вам необходима эта возможность, следует приобрести расширенную лицензию.
Ниже приведены доступные тарифы:
| Лимит запросов в сутки | Стоимость в год | Стоимость каждых ста запросов сверх лимита | Стоимость каждой тысячи запросов сверх лимита |
|---|---|---|---|
| до 300 запросов* | 36 000 рублей | 100 рублей | – |
| до 600 запросов* | 72 000 рублей | 100 рублей | – |
| до 1 000 запросов | 120 000 рублей | – | 120 рублей |
| до 10 000 запросов | 360 000 рублей | – | 60 рублей |
| до 25 000 запросов | 600 000 рублей | – | 40 рублей |
| до 50 000 запросов | 850 000 рублей | – | 17 рублей |
| до 100 000 запросов | 1 000 000 рублей | – | 17 рублей |
| до 200 000 запросов | 1 396 000 рублей | – | 15 рублей |
| до 300 000 запросов | 1 792 000 рублей | – | 15 рублей |
| до 500 000 запросов | 2 584 000 рублей | – | 15 рублей |
| до 1 000 000 запросов | 4 564 000 рублей | – | 15 рублей |
| Свыше 1 000 000 запросов | Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов. |
| Лимит запросов в сутки | Стоимость в год | Стоимость каждых ста запросов сверх лимита | Стоимость каждой тысячи запросов сверх лимита |
|---|---|---|---|
| до 300 запросов* | 36 000 рублей | 100 рублей | – |
| до 600 запросов* | 72 000 рублей | 100 рублей | – |
| до 1 000 запросов | 120 000 рублей | – | 120 рублей |
| до 10 000 запросов | 360 000 рублей | – | 60 рублей |
| до 25 000 запросов | 600 000 рублей | – | 40 рублей |
| до 50 000 запросов | 850 000 рублей | – | 17 рублей |
| до 100 000 запросов | 1 000 000 рублей | – | 17 рублей |
| до 200 000 запросов | 1 396 000 рублей | – | 15 рублей |
| до 300 000 запросов | 1 792 000 рублей | – | 15 рублей |
| до 500 000 запросов | 2 584 000 рублей | – | 15 рублей |
| до 1 000 000 запросов | 4 564 000 рублей | – | 15 рублей |
| Свыше 1 000 000 запросов | Для расчета стоимости направьте запрос на paid-api-maps@yandex-team.ru, указав предполагаемое количество запросов. |
Расширенная лицензия
Расширенная лицензия позволяет сохранять и изменять данные, полученные с помощью API.
Ниже приведены тарифы и стоимость лицензии:
| Лимит запросов в сутки | Стоимость в год | Стоимость каждой тысячи запросов сверх лимита \\n |
|---|
Количество запросов сверх лимита округляется до тысячи в большую сторону. Например,\\n 400 запросов сверх лимита будут округлены до 1000.
Если вы превысили лимит несколько раз за месяц, сначала считается отдельная стоимость\\n превышения за каждые сутки, а по окончании месяца эта стоимость суммируется.
API Конструктора карт
Конструктор карт — простой в использовании веб-инструмент, позволяющий создавать схемы проезда и отмечать нужные объекты на карте. Данную карту затем можно разместить на своем сайте или в блоге, в том числе в рамках платного API.
Чтобы разместить карту на странице, достаточно вставить на эту страницу код виджета, сформированный конструктором.
API Конструктора карт позволяет изменять настройки карты, передавая в коде виджета нужные параметры. Например, можно задать ширину и высоту карты, а также ее язык.
Интерактивная карта
um — идентификатор карты (обязательный параметр).
Если один и тот же код с одинаковым id вставлен на страницу несколько раз, то в DOM-элемент с указанным id будут вставлены все карты.
Ниже рассмотрены различные примеры размещения на странице интерактивной карты.
Пример 3. Вставка интерактивной карты в контейнер с заданными размерами
Статическая карта
um — идентификатор карты (обязательный параметр).
Ниже рассмотрены примеры размещения статической карты на странице.
Использование платной версии API
Платный API предназначен для использования в коммерческих целях. Его можно использовать в закрытых системах, приложениях и программных модулях. В платной версии нет ограничений стандартной лицензии.
Платная версия распространяется как на интерактивные, так и на статические карты.
Для использования платной версии API со статической картой необходимо в коде элемента указать параметр apikey — API-ключ, полученный в кабинете разработчика. Например:
Новые правила доступа к API Карт
API Карт переходит на идентификацию пользователей по ключам. Это касается и бесплатной, и коммерческой версий JavaScript API и HTTP API Геокодера.
Теперь при подключении JS API и в запросах к HTTP API Геокодера нужно передавать специальный API-ключ. Ключи позволят точно идентифицировать сервисы пользователей и подсчитывать количество запросов в сутки.
Что изменится
Вы можете использовать бесплатную версию API как и раньше, если соблюдаете условия использования. Но теперь статистика запросов к API будет отображаться в Кабинете разработчика (пока доступна только статистика геокодирований) — вы сможете контролировать количество запросов в сутки и заранее узнать, если ваш проект растет и приближается к лимитам бесплатной версии.
Мы понимаем, что получение ключа и обновление вашего проекта может занять некоторое время. Тем не менее в ближайшем будущем мы откажемся от поддержки API для анонимных сервисов. Поддержка новых функций и корректная работа API Карт гарантируются только для сервисов, которые передают API-ключ.
Как получить API-ключ
Получить API-ключ можно в Кабинете разработчика. Нажмите «Получить ключ», затем выберите сервис «JavaScript API и HTTP Геокодер» и заполните анкету — ваш API-ключ будет сразу готов к использованию.
Подключение JS API с ключом:
Запросы к HTTP API Геокодера:
Команда API Яндекс.Карт