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.
- Geliştirme projenizi oluşturun.
- Tüketici SDK'sını uygulamanıza ekleyin.
- API anahtarını uygulamanıza ekleyin.
- 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 Fleet Engine için kullandığınız Google Cloud Console projesi ve API anahtarı.
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 sütun eklemek için Uygulamanıza tüketici SDK'sı eklemek için aşağıdaki adımları uygulayın:
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ı.
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ğiyle 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:
Kök düzeyindeki
build.gradle
dosyanızı açın ve aşağıdaki kodubuildscript
altındadependencies
öğ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") } }
Uygulama düzeyindeki
build.gradle
dosyanızı açın ve aşağıdaki koduplugins
öğesi.Modern
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
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.
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
AndroidManifest.xml
dosyanızdacom.google.android.geo.API_KEY
adresine gidin veandroid: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 İlişkilendirmeleri, bağımsız bir menü öğesi veya bir Hakkında 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.