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 programistycznego w konsoli Google Cloud ani klucza interfejsu API do projektu związanego z mobilnością, musisz je skonfigurować. Szczegółowe informacje znajdziesz w sekcji Tworzenie projektu w przewodniku po Fleet Engine.

Wybierając projekt programistyczny dla pakietu Consumer SDK, wybierz ten sam projekt w konsoli Google Cloud i klucz interfejsu API, których używasz w przypadku Fleet Engine.

Dodawanie pakietu Consumer SDK do aplikacji

Pakiet SDK dla konsumenta 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 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 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 odwoływać w bezpieczniejszy sposób. Więcej informacji o sprawdzonych metodach dotyczących bezpieczeństwa kluczy interfejsu API znajdziesz w artykule Google Maps Platform na temat sprawdzonych metod dotyczących bezpieczeństwa interfejsu API.

Aby usprawnić to zadanie, możesz skorzystać z dokumentacji GitHub dotyczącej wtyczki Secrets Gradle do Androida.

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.

    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 ten 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. 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 następnie dodaj podany niżej kod. Zastąp YOUR_API_KEY swoim kluczem interfejsu 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}" />

Poniższy przykład pokazuje 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>

Uwzględnianie wymaganych informacji o autorze w aplikacji

Jeśli używasz w aplikacji pakietu Consumer SDK, w sekcji informacji prawnych musisz umieścić tekst informacji o pochodzeniu danych i licencje open source. Najlepiej jest umieścić informacje o autorach 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 dołączyć informacje o oprogramowaniu open source, znajdziesz na stronie https://developers.google.com/android/guides/opensource.

Co dalej?

Uzyskiwanie tokenów uwierzytelniania