Konfigurowanie projektu w Google Cloud Console

Aby skonfigurować i 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 Consumer SDK.
  3. Dodaj do aplikacji klucz interfejsu API.
  4. Dodaj do aplikacji wymagane informacje o autorze.

Więcej informacji o każdym kroku znajdziesz w kolejnych sekcjach.

Skonfiguruj projekt programistyczny

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

Gdy wybierasz projekt programistyczny na potrzeby pakietu Consumer SDK, wybierz ten sam projekt w konsoli Google Cloud i klucz interfejsu API, których używasz w Fleet Engine.

Dodaj do aplikacji pakiet Consumer SDK

Pakiet Consumer SDK jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki Project Object Model (.pom) pakietu SDK oraz Javadocs. Aby dodać do aplikacji pakiet Consumer SDK, 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 Consumer SDK:

Gradle

Dodaj do pliku build.gradle ten kod:

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 ten kod:

<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>

Dodaj do aplikacji klucz interfejsu API

Gdy dodasz do aplikacji pakiet Consumer SDK, 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 klucza interfejsu API znajdziesz w artykule Google Maps Platform o sprawdzonych metodach zabezpieczania interfejsu API.

Aby uprościć to zadanie, możesz użyć wtyczki Secrets Gradle Plugin for Android opisanej w dokumentacji GitHub.

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

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

    Groovy

    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.

    Groovy

    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. Więcej informacji znajdziesz w artykule Synchronizowanie projektu z Gradle w dokumentacji Androida.

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

    MAPS_API_KEY=YOUR_API_KEY

  5. W pliku AndroidManifest.xml otwórz element 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 przedstawia kompletny manifest 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 do aplikacji wymagane informacje o autorze

Jeśli używasz w aplikacji pakietu Consumer SDK, musisz dodać tekst informacji o pochodzeniu danych i licencje open source w sekcji informacji prawnych aplikacji. Najlepiej jest dodać informacje o autorze jako niezależną pozycję menu lub jako część pozycji menu Informacje.

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

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

Co dalej?

Pobieranie tokenów uwierzytelniania