Все готово!

Прежде чем приступить к разработке, ознакомьтесь с документацией для разработчиков.

Активация Google Maps Android API

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активация Google Maps Android API
  3. Создание соответствующих ключей

Получение ключа API

Чтобы использовать Google Maps Android API, вам необходимо зарегистрировать свой проект приложения в Google API Console и получить ключ Google API, который вы можете добавить в свое приложение. Примечание. Существуют различные типы ограничений ключей API. Вам нужен ключ API с ограничением для приложений Android (а не ключ с ограничением для браузера).

Краткое руководство по получению ключа

Шаг 1. Получение ключа API из Google API Console

Нажмите кнопку ниже для помощи при выполнении процесса и автоматической активации Google Maps Android API.

Получение ключа

Примечания.

  • Для пользователей Google Maps APIs Premium Plan: При отображении раскрывающегося меню проектов вам необходимо выбрать проект, созданный для вас при покупке Google Maps APIs Premium Plan. Имя проекта начинается с Google Maps APIs for Business or Google Maps for Work or Google Maps.
  • Если вы хотите приобрести лицензию на Premium Plan, обратитесь в отдел продаж.
  • Для тестирования вы можете создать общий ключ API без ограничений, который работает на любой платформе. Чтобы защитить свой ключ перед переходом к промышленной эксплуатации, вам необходимо ограничить этот ключ, как описано ниже.

Шаг 2. Добавление ключа API в приложение

Выполните приведенные ниже действия, чтобы включить ключ API в манифест приложения, содержащийся в файле AndroidManifest.xml.

  1. В файле AndroidManifest.xml добавьте следующий дочерний элемент к элементу <application>, вставив его перед закрывающим тегом </application>:
        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
        

    Укажите свой ключ API для YOUR_API_KEY в атрибуте value. Данный элемент устанавливает для ключа com.google.android.geo.API_KEY значение ключа API.

  2. Сохраните AndroidManifest.xml и повторно выполните сборку приложения.

Примечание. Как показано выше, com.google.android.geo.API_KEY является рекомендуемым именем метаданных для ключа API. Ключ с таким именем может использоваться для аутентификации нескольких API-интерфейсов, созданных на основе Google Maps для платформы Android, включая Google Maps Android API. Для обеспечения обратной совместимости API также поддерживает имя com.google.android.maps.v2.API_KEY. Это устаревшее имя обеспечивает аутентификацию только для Android Maps API v2. Приложение позволяет указать только одно из имен в метаданных ключа API. Если указаны оба имени, API вызывает исключение.

И это все, что требуется. Если все шаги, описанные выше, выполнены успешно, тогда все готово. Если же у вас возникли какие-либо проблемы, ознакомьтесь с приведенными ниже подробными инструкциями для стандартного API и Premium Plan.

Подробные руководства по получению ключа API

Подробное руководство для пользователей стандартного Google Maps Android API

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

  1. Перейдите в Google API Console.
  2. Создайте или выберите проект.
  3. Нажмите Continue для активации Google Maps Android API.
  4. На странице Учетные данные выберите Ключ API.
    Примечание. Если у вас есть действующий ключ API с ограничениями для Android, можете использовать этот ключ.
  5. В окне с отображаемым ключом API выберите Restrict key, чтобы установить ограничение Android для ключа API.
  6. В разделе Restrictions выберите Android apps, а затем укажите контрольную сумму SHA-1 своего приложения и название пакета. Например:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
  7. См. дополнительную информацию об ограничениях для ключей API ниже.
  8. Нажмите Save.

Ваш новый ключ API, ограниченный для Android, отобразится в списке ключей API для вашего проекта. Ключ API представляет собой строку символов, которая выглядит примерно так:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Подробное руководство для пользователей с лицензией на Google Maps APIs Premium Plan

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

  1. Перейдите в Google API Console.
  2. В раскрывающемся меню Project выберите проект Google Maps Premium.*
  3. Нажмите Continue.
  4. На странице Учетные данные выберите Ключ API.
  5. В окне с отображаемым ключом API выберите Restrict key, чтобы установить ограничение Android для ключа API.
  6. В разделе Restrictions выберите Android apps, а затем укажите контрольную сумму SHA-1 своего приложения и название пакета. Например:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
    См. дополнительную информацию об ограничениях для ключей API ниже.
  7. Нажмите Save.

Ваш новый ключ API, ограниченный для Android, отобразится в списке ключей API для вашего проекта. Ключ API представляет собой строку символов, которая выглядит примерно так:

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Подробные сведения о консоли Google API Console

Также можно выполнить поиск существующего ключа в Google API Console.

Дополнительную информацию об использовании Google API Console см. в Справке API Console.

Дополнительная информация об ограничениях для ключей API

Интерфейсы Google Maps API доступны для приложений Android и iOS, веб-браузеров, а также применяются веб-службами HTTP. Интерфейсы API на любой платформе могут использовать общий (без ограничений) ключ API. При необходимости вы можете добавить ограничение. Для приложений Android ключ ограничивается контрольной суммой SHA-1 вашего приложения и названием пакета. Ключи с ограничениями будут работать только на платформах, которые поддерживают такой тип ограничений.

Где получить контрольную сумму SHA-1 приложения

Ограничение ключа API для Android представляет собой цифровой сертификат вашего приложения, только в сокращенной форме, которая называется контрольной суммой SHA-1.

Получение информации о сертификации из Android Studio

Если вы следовали руководству по началу работы для Google Maps Android API, Android Studio создаст полезный файл google_maps_api.xml, содержащий учетные данные вашего приложения.

Выберите один из следующих способов получить свой ключ API из Android Studio.

  • Самый быстрый и простой способ: Используйте ссылку в файле google_maps_api.xml, созданном Android Studio.
    1. Скопируйте ссылку из файла google_maps_api.xml и вставьте ее в адресную строку своего браузера. Эта ссылка перенаправит вас в Google API Console и предоставит в Google API Console необходимую информацию через параметры URL, тем самым сократив объем данных, которые требуется вводить вручную.
    2. Выполните инструкции, чтобы создать новый проект в Google API Console, или выберите существующий проект.
    3. Создайте ключ API, ограниченный для Android, для своего проекта.
    4. Скопируйте созданный ключ API, вернитесь в Android Studio и вставьте ключ API в элемент <string> в файле google_maps_api.xml.
  • Несколько менее быстрый способ: Используйте учетные данные в файле google_maps_api.xml, созданном Android Studio.
    1. Скопируйте учетные данные из файла google_maps_api.xml.
    2. Откройте Google API Console в браузере.
    3. Используйте скопированные учетные данные, чтобы добавить приложение в существующий ключ API или создать новый ключ API.

Самостоятельное получение информации о сертификации

Если при создании приложения вы не следовали руководству по началу работы, тогда вам необходимо будет самостоятельно получить контрольную сумму SHA-1 для своего сертификата. Прежде всего, убедитесь, что вы действительно используете соответствующий сертификат. У вас может быть два сертификата.

  • Сертификат для отладки: Этот сертификат создается автоматически при выполнении отладочной сборки приложения с помощью инструментов Android SDK. Его следует использовать исключительно при тестировании приложений. Не пытайтесь опубликовать приложение, подписанное с помощью сертификата для отладки. Подробные сведения о таких сертификатах см. на странице Добавление подписи в режиме отладки в документации для разработчиков Android.
  • Сертификат для выпуска: Этот сертификат создается с помощью инструментов Android SDK при выполнении сборки в процессе подготовки к выпуску. Его также можно создать с помощью программы keytool. Этот сертификат используется для добавления подписи в приложение, готовое к публикации.

Ниже показан порядок действий, которые необходимо выполнить, чтобы отобразить контрольную сумму SHA-1 сертификата в программе keytool с помощью параметра -v. Подробные сведения о программе Keytool см. в документации Oracle.

Сертификат для отладки

Отображение контрольной суммы сертификата для отладки

  1. Найдите ваш файл хранилища ключей для отладки. Этот файл, который называется debug.keystore, создается при выполнении первой сборки проекта. По умолчанию он хранится в том же каталоге, где и файлы Android Virtual Device (AVD):

    • macOS и Linux: ~/.android/
    • Windows Vista и Windows 7: C:\Users\your_user_name\.android\
  2. Откройте контрольную сумму SHA-1.

    • В Linux или macOS перейдите в окно терминала и введите следующую команду:

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • В Windows Vista и Windows 7 выполните следующую команду:

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Результат должен быть аналогичен следующему:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
Сертификат для выпуска

Отображение контрольной суммы сертификата для выпуска

  1. Найдите ваш файл хранилища ключей сертификата для выпуска. Этот файл может называться по-разному, и для него нет стандартного местоположения. Если не указать этот файл при создании сборки приложения для выпуска, ваш пакет .apk останется без подписи и его необходимо будет подписать, чтобы обеспечить возможность публикации. Кроме того, в случае с сертификатом для выпуска вам потребуется его псевдоним, а также пароли для хранилища ключей и самого сертификата. Чтобы получить список псевдонимов для всех ключей, имеющихся в хранилище, введите следующую команду:

    keytool -list -keystore your_keystore_name

    Замените your_keystore_name на полный путь и имя файла хранилища ключей, включая расширение .keystore. Потребуется ввести пароль для хранилища ключей. После этого в окне программы keytool появится список всех псевдонимов, имеющихся в хранилище.

  2. В окне терминала или в командной строке введите следующую команду:

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Замените your_keystore_name на полный путь и имя файла хранилища ключей, включая расширение .keystore. Замените your_alias_name на псевдоним, присвоенный сертификату при его создании.

Результат должен быть аналогичен следующему:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

В строке, которая начинается с элемента SHA1, указана контрольная сумма SHA-1 сертификата. Контрольная сумма представляет собой последовательность из 20 двузначных чисел в шестнадцатеричном формате, которые разделены двоеточиями.

Дополнительные сведения о цифровых сертификатах изложены в руководстве Android по добавлению подписи в приложениях.

Оставить отзыв о...

Текущей странице
Google Maps Android API
Google Maps Android API
Нужна помощь? Обратитесь в службу поддержки.