Артём Мáлков

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

20 мая1 комм

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Рекомендуем к просмотру
Как продлить (увеличить) время жизни базового (API Instagram Basic Display) ключа доступа (access_token) для API «Instagram»
Социальные сети и мессенджеры
Как подключить «Яндекс.Метрику» к сайту в WordPress?
Статьи и советы
Подробная инструкция по добавлению Яндекс.Карты на свой сайт
Статьи и советы
1
комментарий
Форма комментирования этого поста скрыта. Авторизуйтесь, чтобы расширить привилегии гостевого посещения и получить необходимую помощь от сообщества Pandoge.
    • 7
    1066
      •  Команда Pandoge
    22 мая в 10:52

    Я не стал уделять особого внимания функции статистики, но вы не забывайте о том, что она есть.

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

Подняться наверх
«Pandoge» - помощник вебмастера