Google Cloud Console projesi yapılandırma

Android için Consumer SDK'yı kullanmak üzere bir Google Cloud Console'u ayarlamak ve yapılandırmak istiyorsanız aşağıdaki adımları uygulayın.

  1. Geliştirme projenizi oluşturun.
  2. Tüketici 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 bilgi için aşağıdaki bölümlere bakın.

Geliştirme projenizi oluşturma

Mobilite projeniz için Google Cloud Console geliştirme projeniz ve API anahtarınız yoksa bir tane oluşturmanız gerekir. Ayrıntılar için Fleet Engine kılavuzundaki Projenizi oluşturma bölümüne bakın.

Tüketici SDK'sı için geliştirme projenizi seçerken Fleet Engine için kullandığınız Google Cloud Console projesini ve API anahtarını seçin.

Tüketici SDK'sını uygulamanıza ekleyin

Tüketici SDK'sı, Google Maven deposundan edinilebilir. Depo, SDK'nın Proje Nesne Modeli (.pom) dosyalarını ve Javadocs'u içerir. Tüketici SDK'sını uygulamanıza eklemek için Tüketici SDK'sını ve Haritalar SDK'sı bağımlılıklarını Gradle veya Maven yapılandırmanıza ekleyin.

Aşağıdaki örneklerde VERSION_NUMBER, Tüketici SDK'sının gerekli sürümüyle değiştirilmelidir:

Gradle

build.gradle cihazınıza şunları ekleyin:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

pom.xml cihazınıza şunları ekleyin:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

API anahtarını uygulamanıza ekleyin

Tüketici 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. Daha ayrıntılı bilgi için bu kılavuzun 3. Adımında Geliştirme projenizi oluşturma bölümüne 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 depolayacağınız açıklanmaktadır. API anahtarı güvenlikle 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 belgelerini kullanabilirsiniz.

Eklentiyi yüklemek ve API anahtarınızı depolamak için:

  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ılı bilgi için Android dokümanlarında Projenizi Gradle ile senkronize etme bölümüne bakın.

  4. Proje düzeyindeki dizinde local.properties dosyasını açın ve ardından 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 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.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_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 dahil edin

Uygulamanızda Tüketici SDK'sı kullanıyorsanız uygulamanızın yasal uyarılar bölümünün bir parçası olarak ilişkilendirme metni ve açık kaynak lisansları 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ılmış AAR dosyasındaki "third_party_LICENSEs.txt" dosyasında bulabilirsiniz.

Açık kaynak bildirimlerini nasıl ekleyeceğinizi öğrenmek için https://developers.google.com/android/guides/opensource adresine bakın.

Sırada ne var?

Kimlik doğrulama jetonları alma