Drive SDK'sının kullanıldığı bir Google Cloud Console projesi oluşturmak ve Android kullanıyorsanız bu adımları uygulayın.
- Mobil uygulama projenizi oluşturun.
- Sürücü SDK'sını uygulamanıza ekleyin.
- API anahtarını uygulamanıza ekleyin.
- Uygulamanıza gerekli ilişkilendirmeleri ekleyin.
Her adımla ilgili daha fazla bilgi için aşağıdaki bölümlere bakın.
Mobil uygulama projenizi oluşturun
Bu bölümde, Sürücü için mobil uygulama projenizi nasıl yapılandıracağınız açıklanmaktadır SDK'dır.
Mobil uygulama projenizi yapılandırmak için aşağıdaki adımları uygulayın:
- Google Cloud Console geliştirme projeniz ve API anahtarınız yoksa mobilite projeniz için bir tane ayarlamalısınız. Daha fazla bilgi için bkz. Fleet Engine projenizi oluşturun.
- Google Cloud Console'da aynı Google Cloud Console projesini seçin ve Fleet Engine için kullandığınız API anahtarı.
- API'ler ve Hizmetler'i seçin, Android için Haritalar SDK'sını arayıp etkinleştirin.
Sürücü SDK'sını uygulamanıza ekleme
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
yerine Sürücü SDK'sının seçili sürümünü yazın.
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 ekleme
Sürücü 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. Ayrıntılı bilgi için Mobil uygulama projenizi ayarlama başlıklı makaleyi inceleyin.
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 dokümanlarını kullanabilirsiniz.
Eklentiyi yüklemek ve API anahtarınızı depolamak için aşağıdaki adımları uygulayın:
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. Projenizi Gradle ile senkronize edin.
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
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 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 atıfları dahil edin
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.
Nasıl yapıldığını anlatan Açık kaynak bildirimlerini ekleme açık kaynak bildirimlerini içerebilir.