Google Cloud Console projesi yapılandırma

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

  1. Geliştirme projenizi oluşturun.
  2. Consumer SDK'yı uygulamanıza ekleyin.
  3. API anahtarını uygulamanıza ekleyin.
  4. Gerekli ilişkilendirmeleri uygulamanıza ekleyin.

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 bunları oluşturmanız gerekir. Ayrıntılar için Fleet Engine kılavuzundaki Projenizi oluşturma bölümüne bakın.

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

Consumer SDK'yı uygulamanıza ekleme

Consumer SDK, Google Maven deposunda mevcuttur. Depoda, SDK'nın Proje Nesne Modeli (.pom) dosyaları ve Javadocs'lar bulunur. Consumer SDK'yı uygulamanıza eklemek için Consumer SDK ve Haritalar SDK'sı bağımlılıklarını Gradle veya Maven yapılandırmanıza ekleyin.

Aşağıdaki örneklerde VERSION_NUMBER yerine gerekli Consumer SDK sürümünü kullanın:

Gradle

build.gradle alanına aşağıdakileri 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 alanına aşağıdakileri 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 ekleme

Consumer SDK'yı uygulamanıza ekledikten sonra API anahtarını ekleyin. Geliştirme projenizi ayarlarken aldığınız proje API anahtarını kullanmanız gerekir. Daha fazla bilgi için bu kılavuzun 3. adımındaki 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 verilebilecek şekilde nasıl saklayacağınız 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 belgelerindeki Android İçin Secrets Gradle Plugin'i kullanabilirsiniz.

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

  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 Android dokümanlarındaki Projenizi Gradle ile senkronize etme başlıklı makaleye bakın.

  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 aşağıdaki ş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 tam bir manifest 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>

Gerekli atıf bilgilerini uygulamanıza ekleyin

Uygulamanızda Consumer SDK'yı kullanıyorsanız uygulamanızın yasal bildirimler bölümüne ilişkilendirme 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şivlenmemiş AAR dosyasındaki "third_party_licenses.txt" dosyasında bulabilirsiniz.

Açık kaynak bildirimlerinin nasıl ekleneceği hakkında bilgi edinmek için https://developers.google.com/android/guides/opensource adresini ziyaret edin.

Sırada ne var?

Kimlik doğrulama jetonları alma