Управление API-ключами Яндекс.Карт: добавление, ограничение использования, блокировка

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

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

Сделать это можно бесплатно (при соблюдении всех условий использования API Яндекс.Карт, подробнее с которыми можно ознакомиться в официальной справке) и как именно – рассмотрим в этом подробном посте.

Получаем первый бесплатный API-ключ для работы с Яндекс.Картами

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

1. Перейдите по этой ссылке (откроется в новом окне) и авторизуйтесь в кабинете разработчика.

2. Далее на открывшейся странице нажмите «Подключить API». Кнопка будет по центру. Справа вверху, если вы уже используете какой-то из сервисов Яндекса.

3. В открывшемся модальном окне в блоке «Карты» выберите «JavaScript API и HTTP Геокодер»

и нажмите «Подключить», где в следующем модальном окне заполните (и отправьте) форму со всеми обязательными полями (отмечены красной звёздочкой).

Если вы получаете бесплатный ключ (это мы и рассматриваем в данной статье), отмечаете в форме пункты: «В открытой» (для типа системы, в которой будет использоваться API), «В бесплатном» (для типа вашего проекта) и «Буду отображать данные на карте» (как будете использовать полученные данные).

После успешной отправки формы и появления нового окна с сообщением «API сервис подключён» жмёте на кнопку «Перейти к API».

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

Ключи становятся активированными в течение 15 минут после их получения. Каких-либо дополнительных действий с вашей стороны при этом не требуется.

Помимо первого ключа здесь (на момент написания поста) вам доступно: удаление API-интерфейса и общая (по всем ключам) статистика по использованию API с возможностью её выгрузки (скачки) в XLS и CSV,

добавление (выпуск) новых ключей API, а также управление существующими.

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

Ключ прописывается в адресе до JavaScript-файла, подключение которого выглядит примерно следующим образом:

<script src="https://api-maps.yandex.ru/2.1/?apikey=API-ключ&lang=ru_RU"></script>

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

Выпуск (добавление) дополнительных API-ключей для Яндекс.Карт

Если по какой-то из причин вам потребовался ещё один (или несколько) ключ для работы с картами, добавить новый вы можете в панели управления сервисом, в правом верхнем углу, нажатием на кнопку «Новый ключ».

В появившемся окне прописываете название ключа (необязательное действие) и жмёте «Добавить ключ»,

после чего тот появится в списке всех ключей в блоке «Ключи API».

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

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

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

Здесь нас интересуют два поля, это «Ограничение по IP-адресам» и «Ограничение по HTTP Referer» (домену). Заполняете необходимые (можно сразу оба) по примерам ниже их и сохраняете изменения нажатием на соответствующую кнопку (ОК).

Указанные ограничения начинают действовать через 15 минут после их добавления.

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

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

По необходимости действие ключа можно восстановить, нажав на сменившуюся в том же месте кнопку «Разблокировать».

Это, пожалуй, всё, что я хотел бы вам сегодня рассказать.