Продукты платформы Google Maps защищены от несанкционированного использования путем ограничения вызовов API теми, которые предоставляют надлежащие учетные данные аутентификации. Эти учетные данные имеют форму ключа API — уникальной буквенно-цифровой строки, которая связывает ваш платежный аккаунт Google с вашим проектом и с конкретным API или SDK.
В этом руководстве показано, как создать, ограничить и использовать ваш ключ API для платформы Google Карт.
Создание API-ключей
API-ключ — это уникальный идентификатор, который аутентифицирует запросы, связанные с вашим проектом, для целей использования и выставления счетов. У вас должен быть хотя бы один API-ключ, связанный с вашим проектом.
Чтобы создать ключ API:
Консоль
Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .
- На странице «Учетные данные» нажмите «Создать учетные данные» > «Ключ API» .
В диалоговом окне создания ключа API отображается только что созданный ключ API. - Нажмите Закрыть.
Новый ключ API указан на странице «Учетные данные» в разделе «Ключи API» .
(Не забудьте ограничить ключ API перед его использованием в производстве.)
Облачный SDK
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Ограничение ключей API
Google настоятельно рекомендует вам ограничить ваши ключи API, ограничив их использование только теми API, которые необходимы для вашего приложения. Ограничение ключей API повышает безопасность вашего приложения, защищая его от необоснованных запросов. Вы несете финансовую ответственность за расходы, вызванные злоупотреблением неограниченными ключами API. Для получения дополнительной информации см. раздел Рекомендации по безопасности API .
Чтобы ограничить ключ API:
Консоль
Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .
- Выберите ключ API, на который вы хотите установить ограничение. Появится страница свойств ключа API.
- В разделе «Ограничения ключа» установите следующие ограничения:
- Ограничения по применению:
- Чтобы принимать запросы из списка IP-адресов веб-серверов, которые вы предоставляете, выберите IP-адреса (веб-серверов, заданий cron и т. д.) из списка ограничений приложений . Укажите один или несколько адресов IPv4 или IPv6 или подсеть с использованием нотации CIDR. IP-адреса должны соответствовать исходному адресу, который наблюдают серверы платформы Google Карт. Если вы используете преобразование сетевых адресов (NAT) , это обычно соответствует публичному IP-адресу вашего компьютера.
- Ограничения API:
- Нажмите Ограничить ключ .
- Выберите Map Tiles API из раскрывающегося списка Select APIs . Если Map Tiles API отсутствует в списке, вам необходимо включить его.
- Чтобы завершить изменения, нажмите «Сохранить» .
Облачный SDK
Перечислите существующие ключи.
gcloud services api-keys list --project="PROJECT"
Снимите существующие ограничения для существующего ключа.
gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Установите новые ограничения для существующего ключа.
gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \ --api-target=service=tile.googleapis.com --allowed-ips="IP_ADDRESS"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Добавление ключа API к вашему запросу
Вы должны включать ключ API в каждый запрос API Map Tiles. В следующем примере замените YOUR_API_KEY на свой ключ API.
https://tile.googleapis.com/v1/createSession?key= YOUR_API_KEYДля запросов, использующих ключ API, требуется HTTPS.
Что дальше?
Получить 2D-плитки
После получения ключа API вы используете его для создания токена сеанса. Затем вы будете использовать как ключ API, так и токен сеанса в своих запросах на 2D-плитки карты и плитки Street View.
Получить 3D-плитки
Получив ключ API, вы сможете использовать его для получения 3D-плиток.