Google Cloud Console projesi yapılandırma

Drive SDK'sının kullanıldığı bir Google Cloud Console projesi oluşturmak ve Android kullanıyorsanız bu 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. Zorunlu ilişkilendirmeleri uygulamanıza dahil edin.

Her adımla ilgili daha fazla ayrıntı 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 bunları oluşturmanız gerekir. 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ını Google Maven deposundan indirebilirsiniz. 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 cihazınıza şunları 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. 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, daha güvenli olması için API anahtarınızı nasıl depolayacağınız açıklanmaktadır. veya üçüncü taraf uygulamadır. API anahtarı güvenliğiyle ilgili en iyi uygulamalar hakkında daha fazla bilgi için API güvenliği ile ilgili en iyi uygulamalar hakkındaki Google Haritalar Platformu makalesini inceleyin.

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 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 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ı kullanıyorsanız ilişkilendirme metni ve açık kaynak lisanslarını uygulamanızın yasal uyarılar bölümünde bulabilirsiniz. En iyisi İlişkilendirmeleri, bağımsız bir menü öğesi veya bir Hakkında menü seçeneği.

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