Google Cloud Console projesi yapılandırma

Tüketici SDK'sının kullanıldığı bir Google Cloud Console'u kurmak ve yapılandırmak için: Android kullanıyorsanız bu 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 ayrıntı için aşağıdaki bölümlere bakın.

Geliştirme projenizi oluşturun

Bir Google Cloud Console geliştirme projeniz ve mobilite projeniz varsa bir tane ayarlamalısınız. Ayrıntılar için bkz. Fleet Engine kılavuzunda projenizi oluşturun.

Tüketici SDK'sı için geliştirme projenizi seçerken aynı Google Cloud Console projesi ve API anahtarı aracılığıyla Fleet Engine için kullanabilirsiniz.

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

Tüketici SDK'sı özel bir Maven deposundan kullanılabilir. Depo SDK'nın Proje Nesne Modeli (.pom) dosyalarını ve Javadocs'u içerir. Yeni bir Uygulamanıza tüketici SDK'sı eklemek için aşağıdaki adımları uygulayın:

  1. Ortamınızı, ana makine Maven deposuna erişecek şekilde ayarlayın. Bunun için aşağıdaki adımları uygulayın: Bu kılavuzun 2. Adımı.

  2. Tüketici SDK'sı ve Haritalar SDK'sı bağımlılıklarını Gradle veya Maven'e ekleyin yapılandırma.

    Aşağıdaki örneklerde, VERSION_NUMBER ifadesinin yerine gerekli Tüketici SDK'sının sürümü:

    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:VERSION_NUMBER"
}

    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. Şunu kullanmanız gerekir: proje API'sı anahtarı ile karşılaştırın. Örneğin, 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, 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 Secrets Gradle adlı GitHub belgelerini kullanabilirsiniz. Android için eklenti.

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ı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. Android dokümanlarında 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 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 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.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ını 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 Atıfları bağımsız bir menü öğesi veya bir Hakkında bölümü menü seçeneği.

Lisans bilgilerini "third_party_LICENSEs.txt" dosyasında bulabilirsiniz şurada dosyala: arşivden çıkarılan AAR dosyasına dokunun.

https://developers.google.com/android/guides/opensource açık kaynak bildirimleri içerir.

Sırada ne var?

Kimlik doğrulama jetonları alma