Google Cloud Console projesi yapılandırma

Android için Driver SDK'yı kullanacak bir Google Cloud Console projesi oluşturmak ve yapılandırmak üzere aşağıdaki adımları uygulayın.

  1. Mobil uygulama projenizi oluşturun.
  2. Sürücü SDK'sını uygulamanıza ekleyin.
  3. API anahtarını uygulamanıza ekleyin.
  4. Uygulamanıza gerekli ilişkilendirmeleri ekleyin.

Her adımla ilgili daha fazla bilgi için aşağıdaki bölümlere bakın.

Mobil uygulama projenizi oluşturma

Bu bölümde, mobil uygulama projenizi Driver SDK'sı için nasıl yapılandıracağınız açıklanmaktadır.

Mobil uygulama projenizi yapılandırmak için aşağıdaki adımları uygulayın:

  1. Mobilite projeniz için bir Google Cloud Console geliştirme projeniz ve API anahtarınız yoksa bir tane oluşturmanız gerekir. Daha fazla bilgi için Fleet Engine projenizi oluşturma başlıklı makaleyi inceleyin.
  2. Google Cloud Console'da, Fleet Engine için kullandığınız Google Cloud Console projesini ve API anahtarını seçin.
  3. API'ler ve Hizmetler'i seçin, Android için Haritalar SDK'sını arayıp etkinleştirin.

Sürücü SDK'sını uygulamanıza ekleme

Sürücü SDK'sını Google Maven deposundan indirebilirsiniz. Depo, SDK'nın Proje Nesnesi Modeli (.pom) dosyalarını ve Javadoc'larını içerir.

Sürücü SDK'sını uygulamanıza eklemek için Sürücü SDK'sı ve Navigasyon SDK'sı bağımlılıkları Gradle veya Maven yapılandırmanıza ekleyin.

Aşağıdaki örnekte, VERSION_NUMBER yerine Sürücü SDK'sının seçili sürümünü yazın.

Gradle

build.gradle dosyanıza aşağıdakileri ekleyin:

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

Maven

pom.xml dosyanıza aşağıdakileri ekleyin:

<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>

API anahtarını uygulamanıza ekleme

Sürücü SDK'sını uygulamanıza ekledikten sonra API anahtarını ekleyin. Geliştirme projenizi ayarlarken aldığınız proje API anahtarını kullanmanız gerekir. Ayrıntılı bilgi için Mobil uygulama projenizi ayarlama başlıklı makaleyi inceleyin.

Bu bölümde, API anahtarınızı uygulamanız tarafından daha güvenli bir şekilde referans verilebilmesi için nasıl saklamanız gerektiği açıklanmaktadır. API anahtarı güvenliğiyle ilgili en iyi uygulamalar hakkında daha fazla bilgi için API güvenliğiyle ilgili en iyi uygulamalar başlıklı Google Haritalar Platformu makalesine bakın.

Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin GitHub dokümanlarını kullanabilirsiniz.

Eklentiyi yüklemek ve API anahtarınızı depolamak için aşağıdaki adımları uygulayın:

  1. Kök düzeyindeki build.gradle dosyanızı açın ve buildscript altındaki dependencies öğesine aşağıdaki kodu ekleyin.

    Modern

    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. Uygulama düzeyindeki build.gradle dosyanızı açın ve aşağıdaki kodu plugins öğesine ekleyin.

    Modern

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Android Studio kullanıyorsanız projenizi Gradle ile senkronize edin. Ayrıntılar için Projenizi Gradle ile senkronize etme başlıklı makaleyi inceleyin.

  4. Proje düzeyindeki dizininizde local.properties dosyasını açın ve ardından aşağıdaki kodu ekleyin. YOUR_API_KEY yerine API anahtarınızı girin.

    MAPS_API_KEY=YOUR_API_KEY

  5. AndroidManifest.xml dosyanızda com.google.android.geo.API_KEY bölümüne gidin ve android:value özelliğini aşağıdaki gibi güncelleyin:

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

Aşağıdaki örnekte, örnek bir uygulamanın eksiksiz manifesti gösterilmektedir:

    <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>

Uygulamanıza gerekli ilişkilendirmeleri ekleme

Uygulamanızda Driver SDK'sını kullanıyorsanız uygulamanızın yasal uyarılar bölümüne ilişkilendirme metnini ve açık kaynak lisanslarını eklemeniz gerekir. İlişkilendirmeleri bağımsız bir menü öğesi olarak veya Hakkında menü öğesinin bir parçası olarak eklemek en iyisidir.

Lisans bilgilerini, arşivden çıkarılmamış AAR dosyasında "third_party_licenses.txt" dosyasında bulabilirsiniz.

Açık kaynak bildirimlerini ekleme hakkında bilgi edinmek için Açık kaynak bildirimlerini ekleme başlıklı makaleyi inceleyin.

Sırada ne var?

Bağımlılıklarını beyan etme