Konfigurowanie projektu w Google Cloud Console

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

  1. Skonfiguruj projekt programistyczny.
  2. Dodaj do aplikacji pakiet SDK dla konsumentów.
  3. Dodaj klucz interfejsu API do aplikacji.
  4. Umieść w aplikacji wymagane informacje o autorze.

Więcej informacji o poszczególnych krokach znajdziesz w sekcjach poniżej.

Konfigurowanie projektu programistycznego

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

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

Dodawanie pakietu SDK dla konsumentów do aplikacji

Pakiet SDK dla konsumentów jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki Project Object Model (.pom) pakietu SDK i dokumentację Javadoc. Aby dodać pakiet Consumer SDK do aplikacji, dodaj zależności pakietu Consumer SDK i pakietu Maps SDK do konfiguracji Gradle lub Maven.

W poniższych przykładach zastąp VERSION_NUMBER wymaganą wersją pakietu SDK dla konsumentów:

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 SDK dla konsumentów do aplikacji dodaj klucz interfejsu API. Musisz użyć klucza interfejsu API projektu, który został uzyskany podczas konfigurowania projektu programistycznego. Więcej informacji znajdziesz w sekcji Konfigurowanie projektu programistycznego w kroku 3 tego przewodnika.

W tej sekcji opisujemy, jak przechowywać klucz interfejsu API, aby aplikacja mogła się do niego odwoływać w bezpieczniejszy sposób. Więcej informacji o sprawdzonych metodach zabezpieczania kluczy interfejsu API znajdziesz w artykule Google Maps Platform na temat sprawdzonych metod zabezpieczania interfejsów API.

Aby uprościć to zadanie, możesz skorzystać z dokumentacji GitHub Secrets Gradle Plugin for Android (Wtyczka Gradle obiektów tajnych na Androida).

Aby zainstalować wtyczkę i zapisać klucz interfejsu API:

  1. Otwórz plik build.gradle w katalogu głównym i dodaj ten kod do elementu dependencies w sekcji buildscript.

    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 ten kod do elementu plugins.

    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 Androida Studio, zsynchronizuj projekt z Gradle. Szczegółowe informacje znajdziesz w artykule Synchronizowanie projektu z Gradle w dokumentacji Androida.

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

    MAPS_API_KEY=YOUR_API_KEY

  5. W pliku AndroidManifest.xml przejdź do 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}" />

Poniższy przykład pokazuje kompletny 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 w aplikacji wymagane informacje o autorze

Jeśli w aplikacji używasz pakietu SDK dla konsumentów, musisz umieścić tekst atrybucji i licencje open source w sekcji informacji prawnych aplikacji. Najlepiej jest umieścić informacje o autorach jako osobną pozycję menu lub w ramach pozycji menu O aplikacji.

Informacje o licencji znajdziesz w pliku „third_party_licenses.txt” w rozpakowanym pliku AAR.

Informacje o tym, jak uwzględniać informacje o oprogramowaniu open source, znajdziesz na stronie https://developers.google.com/android/guides/opensource.

Co dalej?

Uzyskiwanie tokenów uwierzytelniania