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

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

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

  1. Google Cloud Console geliştirme projeniz ve API anahtarınız yoksa mobilite projeniz için bir tane ayarlamalısınız. Daha fazla bilgi için bkz. Fleet Engine projenizi oluşturun.
  2. Google Cloud Console'da aynı Google Cloud Console projesini seçin ve Fleet Engine için kullandığınız API anahtarı.
  3. API'ler ve Hizmetler'i tıklayın ve Android için Haritalar SDK'sı.

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

Sürücü SDK'sı, Google Maven deposundan edinilebilir. Depo SDK'nın Proje Nesne Modeli (.pom) dosyalarını ve Javadocs'u içerir.

Sürücü SDK'sını uygulamanıza eklemek için Sürücü SDK'sı ve Navigasyon SDK'sını ekleyin bağımlılıklarını görebilirsiniz.

Aşağıdaki örnekte, VERSION_NUMBER değerini seçilen sürümle değiştirin Sürücü SDK'sı.

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 cihazınıza şunları 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 ekleyin

Sürücü SDK'sını uygulamanıza ekledikten sonra API anahtarını ekleyin. Şunu kullanmanız gerekir: proje API'sı anahtarı ile karşılaştırın. Örneğin, daha fazla bilgi için Mobil uygulama projenizi oluşturma başlıklı makaleye bakın.

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 GitHub dokümanlarını kullanabilirsiniz Android için Secrets Gradle Plugin.

Eklentiyi yüklemek ve API anahtarınızı saklamak 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ında dependencies öğesi.

    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 öğesi.

    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 bkz. Projenizi Gradle ile senkronize edin.

  4. Proje düzeyindeki dizininizde local.properties dosyasını açın ve şunu ekleyin: şu kodu kullanabilirsiniz: 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 adresine 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 uygulama için eksiksiz bir manifest 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ı dahil edin

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 "third_party_licenses.txt" dosyasında bulabilirsiniz. şurada dosyala: arşivden çıkarılan AAR dosyasına dokunun.

Nasıl yapıldığını anlatan Açık kaynak bildirimlerini ekleme açık kaynak bildirimleri içerir.

Sırada ne var?

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