Прежде чем начать
Прежде чем начать использовать Places SDK для Android, вам нужен проект с платежной учетной записью и включенным Places SDK для Android. Чтобы узнать больше, см. Настройка в консоли Cloud .
Создание 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, вы должны предоставить отпечаток сертификата SHA-1 ключа подписи, который использовался для подписи приложения. Существует два типа сертификатов:
- Сертификат отладки : используйте этот тип сертификата только с приложениями, которые вы тестируете, и другим непроизводственным кодом. Не пытайтесь опубликовать приложение, подписанное сертификатом отладки. Инструменты Android SDK автоматически генерируют этот сертификат при запуске отладочной сборки.
- Сертификат выпуска : используйте этот сертификат, когда вы готовы выпустить свое приложение в магазине приложений. Инструменты Android SDK генерируют этот сертификат при запуске сборки выпуска.
Дополнительную информацию о подписи и сертификатах приложений Android см. в руководстве «Подпишите свое приложение» .
Инструкции по поиску отпечатка вашего сертификата подписи см. по ссылкам ниже:
- Если вы используете Play App Signing , см. раздел Работа с поставщиками API .
- Если вы управляете собственным ключом подписи, см. раздел Самостоятельное подписание приложения или обратитесь к инструкциям для вашей среды сборки.
Чтобы ограничить ключ API:
Консоль
Перейдите на страницу «Платформа Google Карт» > «Учетные данные» .
- Выберите ключ API, на который вы хотите установить ограничение. Появится страница свойств ключа API.
- В разделе «Ограничения ключа» установите следующие ограничения:
- Ограничения по применению:
- Выберите приложения Android .
- Нажмите + Добавить имя пакета и отпечаток пальца .
- Введите имя вашего пакета и отпечаток сертификата SHA-1. Например:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- Ограничения API:
- Нажмите Ограничить ключ .
- Выберите Places API или Places API (New) из раскрывающегося списка Select APIs , но не оба. Если Places API отсутствует в списке, вам необходимо включить его.
- Чтобы завершить изменения, нажмите «Сохранить» .
Облачный SDK
Places SDK для Android (новый)
Перечислите существующие ключи.
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=places.googleapis.com --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Место SDK для Android
Перечислите существующие ключи.
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=places-backend.googleapis.com --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Узнайте больше о Google Cloud SDK , установке Cloud SDK и следующих командах:
Что дальше?
Теперь, когда у вас есть ключ API, создайте и настройте проект, как описано в разделе Настройка проекта Android Studio .