Konfigurowanie projektu w Google Cloud Console

Aby skonfigurować konsolę Google Cloud do używania pakietu SDK dla klientów indywidualnych Android, wykonaj te czynności.

  1. Skonfiguruj projekt programistyczny.
  2. Dodaj do aplikacji pakiet SDK dla klientów indywidualnych.
  3. Dodaj klucz interfejsu API do aplikacji.
  4. Dodaj wymagane informacje o źródłach w swojej aplikacji.

Więcej informacji o poszczególnych krokach znajdziesz w kolejnych sekcjach.

Konfigurowanie projektu programistycznego

Jeśli nie masz projektu programistycznego konsoli Google Cloud ani klucza interfejsu API projektu mobilnego, musisz go skonfigurować. Więcej informacji: Utwórz projekt w przewodniku Fleet Engine.

Wybierając projekt programistyczny z pakietem SDK dla klientów indywidualnych, ten sam projekt konsoli Google Cloud i klucz interfejsu API, których używasz we Fleet Engine.

Dodaj do aplikacji pakiet SDK dla klientów indywidualnych

Pakiet SDK dla klientów indywidualnych jest dostępny z prywatnego repozytorium Maven. Repozytorium zawiera pliki .pom (Project Object Model) pakietu SDK i dokumenty Javadocs. Aby dodać z pakietem SDK dla klientów indywidualnych aplikacji, wykonaj te czynności:

  1. Skonfiguruj środowisko, aby uzyskać dostęp do repozytorium Maven hosta zgodnie z opisem w sekcji Kroku 2 w tym przewodniku.

  2. Dodaj zależności pakietów SDK Consumer SDK i Maps SDK do narzędzia Gradle lub Maven konfiguracji.

    W tych przykładach zastąp VERSION_NUMBER wymaganymi wartościami pakietu SDK dla klientów indywidualnych:

    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:VERSION_NUMBER"
    }
    

    Maven

    Dodaj do pom.xml:

    <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ć klucz interfejsu API projektu uzyskany podczas konfigurowania projektu programistycznego. Dla: Więcej informacji znajdziesz w sekcji Konfigurowanie projektu programistycznego w kroku 3 tego przewodnika.

W tej sekcji opisano, jak przechowywać klucz interfejsu API w celu zwiększenia jego bezpieczeństwa przywoływanych przez aplikację. Aby dowiedzieć się więcej o sprawdzonych metodach zapewniania bezpieczeństwa klucza interfejsu API, przeczytaj artykuł Google Maps Platform dotyczący sprawdzonych metod zapewniania bezpieczeństwa interfejsów API.

Aby usprawnić to zadanie, możesz skorzystać z dokumentacji GitHub Gradle obiektów tajnych Wtyczka na Androida.

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

  1. Otwórz plik build.gradle na poziomie głównym i dodaj ten kod do sekcji dependencies w kolumnie 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 sekcji 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. Więcej informacji: Zsynchronizuj projekt przy użyciu Gradle w dokumentacji Androida.

  4. Otwórz plik local.properties w katalogu na poziomie projektu i dodaj następujący kod. Zastąp YOUR_API_KEY swoim kluczem interfejsu API.

    MAPS_API_KEY=YOUR_API_KEY

  5. W pliku AndroidManifest.xml przejdź do sekcji com.google.android.geo.API_KEY i zaktualizuj atrybut android:value w następujący sposób:

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

Ten przykład 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>

Umieść w aplikacji wymagane informacje o źródłach

Jeśli w swojej aplikacji używasz pakietu SDK Consumer SDK, musisz dodać tekst atrybucji i licencji open source. Najlepiej umieścić informacje o źródłach jako niezależne pozycje menu lub w sekcji Informacje. .

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

Instrukcje znajdziesz na https://developers.google.com/android/guides/opensource. zawierać powiadomienia o otwartym kodzie źródłowym.

Co dalej?

Uzyskiwanie tokenów uwierzytelniania