Konfigurowanie projektu w Google Cloud Console

Aby skonfigurować projekt konsoli Google Cloud do korzystania z Driver SDK na Androida, wykonaj te czynności.

  1. Skonfiguruj projekt aplikacji mobilnej.
  2. Dodaj do aplikacji pakiet SDK Driver.
  3. Dodaj klucz interfejsu API do aplikacji.
  4. Uwzględnij w aplikacji wymagane informacje o przypisaniu.

Więcej informacji o każdej z tych czynności znajdziesz w następnych sekcjach.

Konfigurowanie projektu aplikacji mobilnej

Z tej sekcji dowiesz się, jak skonfigurować projekt aplikacji mobilnej pod kątem pakietu SDK Driver.

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

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

Dodawanie do aplikacji pakietu SDK Kierowcy

Pakiet Driver SDK jest dostępny w repozytorium Maven Google. Repozytorium zawiera pliki modelu obiektu projektu (.pom) i dokumentację Javadoc pakietu SDK.

Aby dodać pakiet SDK Kierowcy do aplikacji, dodaj do konfiguracji Gradle lub Maven zależności pakietu SDK Kierowcy i pakietu SDK Nawigacji.

W tym przykładzie zastąp VERSION_NUMBER wybraną wersją pakietu SDK Driver.

Gradle

Dodaj do pliku build.gradle te informacje:

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

Maven

Dodaj do pliku pom.xml te informacje:

<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 do aplikacji pakietu Driver SDK 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 opisano, jak przechowywać klucz interfejsu API, aby aplikacja mogła się do niego bezpieczniej odwoływać. Więcej informacji o sprawdzonych metodach zapewniania bezpieczeństwa kluczy interfejsu API znajdziesz w artykule o sprawdzonych metodach zapewniania bezpieczeństwa interfejsu API na temat Google Maps Platform.

Aby usprawnić to zadanie, możesz skorzystać z dokumentacji w GitHub Secrets Gradle Plugin for Android (w języku angielskim).

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

  1. Otwórz plik build.gradle na poziomie katalogu głównego i dodaj pod elementem buildscript kod: 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 do elementu plugins podany niżej 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 za pomocą Gradle.

  4. Otwórz folder local.properties w katalogu na poziomie projektu, a potem dodaj ten kod. Zastąp YOUR_API_KEY swoim kluczem 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}" />

Przykład poniżej zawiera 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>

Dodaj wymagane informacje w aplikacji

Jeśli w swojej aplikacji używasz pakietu SDK kierowcy, musisz w sekcji powiadomień prawnych aplikacji umieścić tekst informacyjny i licencja na oprogramowanie open source. Najlepiej jest uwzględnić informacje o przypisywaniu w ramach samodzielnego elementu menu lub w ramach elementu menu Informacje.

Informacje o licencjach znajdziesz w pliku „third_party_licenses.txt” w niezaarchiwizowanym pliku AAR.

Informacje o tym, jak dodawać powiadomienia o oprogramowaniu open source, znajdziesz w artykule Dodawanie powiadomień o oprogramowaniu open source.

Co dalej?

Deklarowanie zależności