Konfigurowanie projektu w Google Cloud Console

Aby skonfigurować konsolę Google Cloud do korzystania z Consumer SDK na Androida, wykonaj te czynności.

  1. Skonfiguruj projekt programistyczny.
  2. Dodaj pakiet Consumer SDK do aplikacji.
  3. Dodaj klucz interfejsu API do aplikacji.
  4. Uwzględnij w aplikacji wymagane informacje o przypisaniu.

Więcej informacji o każdej z tych czynności znajdziesz w następnych sekcjach.

Konfigurowanie projektu programistycznego

Jeśli nie masz projektu deweloperskiego w konsoli Google Cloud ani klucza interfejsu API dla projektu mobilności, musisz je utworzyć. Więcej informacji znajdziesz w sekcji Tworzenie projektu w przewodniku Fleet Engine.

Podczas wybierania projektu deweloperskiego dla Consumer SDK wybierz ten sam projekt konsoli Google Cloud i ten sam klucz API, których używasz w przypadku Fleet Engine.

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ą zestawu 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 zapewniania bezpieczeństwa kluczy interfejsu API znajdziesz w artykule o sprawdzonych metodach zapewniania bezpieczeństwa interfejsu 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:

  1. Otwórz plik build.gradle na poziomie katalogu głównego i dodaj pod elementem buildscript kod: dependencies.

    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")
    }
}

  2. Otwórz plik build.gradle na poziomie aplikacji i dodaj do elementu plugins podany niżej kod.

    Zakręcony

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Jeśli używasz Android Studio, zsynchronizuj projekt z Gradle. Więcej informacji znajdziesz w artykule Synchronizowanie projektu z Gradle w dokumentacji na temat Androida.

  4. Otwórz folder local.properties w katalogu na poziomie projektu, a potem dodaj ten kod. Zastąp YOUR_API_KEY swoim kluczem API.

    MAPS_API_KEY=YOUR_API_KEY

  5. W pliku AndroidManifest.xml otwórz com.google.android.geo.API_KEY i zaktualizuj atrybut android:value w ten sposób:

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

Przykład poniżej zawiera pełny plik manifestu 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 w aplikacji

Jeśli w aplikacji używasz pakietu SDK dla konsumentów, musisz w sekcji powiadomień prawnych aplikacji umieścić tekst informujący o źródle oraz licencje na oprogramowanie open source. Najlepiej jest uwzględnić informacje o przypisywaniu w ramach samodzielnego elementu menu lub w ramach elementu menu Informacje.

Informacje o licencjach znajdziesz w pliku „third_party_licenses.txt” w niezaarchiwizowanym pliku AAR.

Informacje o tym, jak dodać powiadomienia o programach open source, znajdziesz na stronie https://developers.google.com/android/guides/opensource.

Co dalej?

Uzyskiwanie tokenów uwierzytelniania