Konfigurowanie projektu w Google Cloud Console

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

  1. Skonfiguruj projekt programistyczny.
  2. Dodaj do aplikacji pakiet Consumer SDK.
  3. Dodaj klucz interfejsu API do aplikacji.
  4. 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 przewodniku na temat tworzenia 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 Fleet Engine.

Dodaj do aplikacji pakiet SDK dla klientów indywidualnych

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

W tych przykładach zastąp VERSION_NUMBER wymaganą wersją pakietu Consumer SDK:

Gradle

Dodaj do build.gradle:

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 do aplikacji pakietu Consumer SDK 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.

Ta sekcja opisuje, jak przechowywać klucz interfejsu API, aby aplikacja mogła lepiej się do niego odwoływać. Więcej informacji o sprawdzonych metodach zabezpieczania klucza interfejsu API znajdziesz w artykule na temat sprawdzonych metod zapewniania bezpieczeństwa interfejsów API na Google Maps Platform.

Aby usprawnić to zadanie, możesz użyć w dokumentacji GitHub wtyczki do Gradle obiektów tajnych dla Androida.

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

  1. Otwórz plik build.gradle na poziomie katalogu głównego i dodaj pod kodem buildscript element 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 podany niżej 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 swój projekt z Gradle. Szczegółowe informacje znajdziesz w artykule Synchronizowanie projektu za pomocą Gradle w dokumentacji Androida.

  4. Otwórz local.properties w katalogu na poziomie projektu, a następnie dodaj poniższy 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ż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 swojej aplikacji używasz pakietu SDK dla klientów indywidualnych, musisz umieścić w sekcji Informacje prawne dotyczące aplikacji tekst informacji o pochodzeniu danych i licencje open source. Warto dodać informacje o źródłach jako niezależne pozycje menu lub jako część pozycji menu Informacje.

Informacje o licencji znajdziesz w pliku „third_party_licenses.txt” w przywróconym pliku AAR.

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

Co dalej?

Uzyskiwanie tokenów uwierzytelniania