Google Cloud Console projesi yapılandırma

Android için Driver SDK'yı kullanmak üzere bir Google Cloud Console projesi oluşturup 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 atıfları ekleyin.

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

Mobil uygulama projenizi oluşturma

Bu bölümde, mobil uygulama projenizi Sürücü 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 Google Cloud Console geliştirme projeniz ve API anahtarınız yoksa bunları 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 ve Android için Haritalar SDK'sını arayıp etkinleştirin.

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

Driver SDK'yı Google Maven deposundan indirebilirsiniz. Depo, SDK'nın Proje Nesne Modeli (.pom) dosyalarını ve Javadoc'larını içerir.

Driver SDK'yı uygulamanıza eklemek için Gradle veya Maven yapılandırmanıza Driver SDK ve Navigation SDK bağımlılıklarını 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 oluştururken aldığınız proje API anahtarını kullanmanız gerekir. Daha fazla bilgi için Mobil uygulama projenizi oluşturma başlıklı makaleyi inceleyin.

Bu bölümde, API anahtarınızın uygulamanız tarafından daha güvenli bir şekilde referans alınabilmesi için nasıl saklanacağı 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 makalesini inceleyin.

Bu görevi kolaylaştırmak için Android İçin Secrets Gradle Plugin başlıklı GitHub dokümanlarından yararlanabilirsiniz.

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 aşağıdaki kodu buildscript altındaki dependencies öğesine 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 aşağıdaki kodu ekleyin. YOUR_API_KEY kısmını API anahtarınızla değiştirin.

    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 şu şekilde 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 tam 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 atıfları ekleme

Uygulamanızda Driver SDK'yı kullanıyorsanız uygulamanızın yasal uyarılar bölümüne atıf metni ve açık kaynak lisansları eklemeniz gerekir. Atıfları bağımsız bir menü öğesi olarak veya Hakkında menü öğesinin bir parçası olarak eklemeniz önerilir.

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

Açık kaynak bildirimlerinin nasıl ekleneceği hakkında bilgi edinmek için Açık kaynak bildirimlerini ekleme bölümüne bakın.

Sırada ne var?

Bağımlılıkları bildirme