Aby skonfigurować Google Cloud Console do korzystania z Consumer SDK na Androida, wykonaj te czynności.
- Skonfiguruj projekt programistyczny.
- Dodaj do aplikacji pakiet Consumer SDK.
- Dodaj klucz interfejsu API do aplikacji.
- Uwzględnij w aplikacji wymagane informacje o pochodzeniu.
Więcej informacji o każdym kroku znajdziesz w następnych sekcjach.
Konfigurowanie projektu programistycznego
Jeśli nie masz projektu deweloperskiego w Google Cloud Console ani klucza interfejsu API dla projektu mobilności, musisz je utworzyć. Szczegółowe informacje znajdziesz w sekcji Tworzenie projektu w przewodniku Fleet Engine.
Podczas wybierania projektu deweloperskiego dla pakietu Consumer SDK wybierz ten sam projekt konsoli Google Cloud i ten sam klucz API, którego używasz w przypadku silnika Fleet.
Dodawanie pakietu Consumer SDK do aplikacji
Pakiet SDK dla konsumentów jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki modelu obiektu projektu (.pom) i dokumentację Javadoc pakietu SDK. Aby dodać pakiet Consumer SDK do aplikacji, dodaj do konfiguracji Gradle lub Maven zależności pakietu Consumer SDK i pakietu Maps SDK.
W tych przykładach zastąp VERSION_NUMBER
wymaganą wersją pakietu Consumer SDK:
Gradle
Dodaj do pliku build.gradle
te informacje:
dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
implementation "com.google.android.gms:play-services-maps:18.1.0"
}
Maven
Dodaj do pliku pom.xml
te informacje:
<dependencies>
...
<dependency>
<groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
<artifactId>transportation-consumer</artifactId>
<version>VERSION_NUMBER</version>
</dependency>
<dependency>
<groupId>com.google.android.gms</groupId>
<artifactId>play-services-maps</artifactId>
<version>18.1.0</version>
</dependency>
</dependencies>
Dodawanie klucza interfejsu API do aplikacji
Po dodaniu pakietu Consumer SDK do aplikacji dodaj klucz interfejsu API. Musisz użyć klucza interfejsu API projektu uzyskanego podczas konfigurowania projektu programistycznego. Więcej informacji znajdziesz w sekcji Konfigurowanie projektu programistycznego w kroku 3 tego przewodnika.
W tej sekcji opisano, jak przechowywać klucz interfejsu API, aby aplikacja mogła się do niego bezpieczniej odwoływać. Więcej informacji o sprawdzonych metodach zabezpieczania klucza API znajdziesz w artykule o sprawdzonych metodach zabezpieczania klucza API na temat Google Maps Platform.
Aby usprawnić to zadanie, możesz skorzystać z dokumentacji GitHub Wtyczka Gradle obiektów tajnych na Androida.
Aby zainstalować wtyczkę i zapisać klucz interfejsu API:
Otwórz plik
build.gradle
na poziomie katalogu głównego i dodaj pod kodembuildscript
elementdependencies
.Zakręcony
buildscript { dependencies { // ... classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0" } }
Kotlin
buildscript { dependencies { // ... classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0") } }
Otwórz plik
build.gradle
na poziomie aplikacji i dodaj podany niżej kod do elementuplugins
.Zakręcony
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Jeśli używasz Android Studio, zsynchronizuj projekt z Gradle. Szczegółowe informacje znajdziesz w artykule Synchronizowanie projektu za pomocą Gradle w dokumentacji Androida.
Otwórz plik
local.properties
w katalogu na poziomie projektu, a potem dodaj ten kod. ZastąpYOUR_API_KEY
swoim kluczem API.MAPS_API_KEY=YOUR_API_KEY
W pliku
AndroidManifest.xml
otwórzcom.google.android.geo.API_KEY
i zaktualizuj atrybutandroid:value
w ten sposób:
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
Poniżej znajdziesz przykład pełnego pliku manifestu dla przykładowej aplikacji:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.consumerapidemo">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/_AppTheme">
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
Dodaj wymagane informacje o przypisaniu w aplikacji
Jeśli w aplikacji używasz pakietu SDK dla konsumentów, musisz w sekcji powiadomień prawnych aplikacji umieścić tekst atrybucji oraz licencje na oprogramowanie open source. Najlepiej jest uwzględnić atrybuty jako niezależną pozycję menu lub jako część pozycji menu Informacje.
Informacje o licencjach znajdziesz w pliku „third_party_licenses.txt” w niezaarchiwizowanym pliku AAR.
Informacje o tym, jak uwzględnić informacje o oprogramowaniu open source, znajdziesz na stronie https://developers.google.com/android/guides/opensource.