Konfigurowanie projektu w Google Cloud Console

Aby skonfigurować projekt w konsoli Google Cloud pod kątem korzystania z pakietu Driver SDK na Androida, wykonaj te czynności.

1. Skonfiguruj projekt aplikacji mobilnej.
2. Dodaj do aplikacji pakiet Driver SDK.
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 aplikacji mobilnej

W tej sekcji opisano, jak skonfigurować projekt aplikacji mobilnej pod kątem pakietu Driver SDK.

Aby skonfigurować projekt aplikacji mobilnej, wykonaj te czynności:

1. Jeśli nie masz projektu programistycznego w konsoli Google Cloud ani klucza interfejsu API do projektu związanego z mobilnością, musisz je skonfigurować. Więcej informacji znajdziesz w artykule Tworzenie projektu Fleet Engine.
2. W konsoli Google Cloud wybierz ten sam projekt i klucz interfejsu API, których używasz w Fleet Engine.
3. Wybierz Interfejsy API i usługi, a następnie wyszukaj i włącz pakiet Maps SDK na Androida.

Dodawanie pakietu Driver SDK do aplikacji

Pakiet Driver SDK jest dostępny w repozytorium Google Maven. Repozytorium zawiera pliki Project Object Model (.pom) pakietu SDK i dokumentację Javadoc.

Aby dodać pakiet Driver SDK do aplikacji, dodaj zależności pakietów Driver SDK i Navigation SDK do konfiguracji Gradle lub Maven.

W poniższym przykładzie zastąp VERSION_NUMBER wybraną wersją pakietu Driver SDK.

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

Dodawanie klucza interfejsu API do aplikacji

Po dodaniu pakietu Driver SDK do aplikacji dodaj klucz interfejsu API. Musisz użyć klucza interfejsu API projektu uzyskanego podczas konfigurowania projektu programistycznego. Więcej informacji znajdziesz w artykule Konfigurowanie projektu aplikacji mobilnej.

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 dotyczących bezpieczeństwa kluczy interfejsu API znajdziesz w artykule Google Maps Platform na temat sprawdzonych metod dotyczących bezpieczeństwa interfejsu API.

Aby uprościć to zadanie, możesz skorzystać z dokumentacji dotyczącej wtyczki Secrets Gradle do Androida na GitHubie.

Aby zainstalować wtyczkę i zapisać klucz interfejsu API, wykonaj te czynności:

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.

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 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 pełny plik manifestu przykładowej aplikacji:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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 pakietu Driver SDK w swojej aplikacji, musisz dołączyć tekst informacji o pochodzeniu danych i licencje open source w sekcji informacji prawnych aplikacji. 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 w artykule Dołączanie informacji o oprogramowaniu open source.

Co dalej?

Deklarowanie zależności