Google Maps Görünümler'i kullanarak harita görüntüleyen bir Android uygulaması oluşturma şablonunu bulun. Android Studio projenizde istediğiniz zaman Android Studio projesi oluşturma başlıklı makaleyi inceleyin.
Bu hızlı başlangıç kılavuzu, Kotlin veya Java ile temel Android geliştirme hakkında bilgi sahibi olan geliştiriciler için hazırlanmıştır.
Geliştirme ortamı hakkında
Bu hızlı başlangıç kılavuzu, Android Studio Hedgehog ve Android Gradle eklentisi 8.2 sürümü kullanılarak geliştirilmiştir.
Android cihaz kurma
Android için Haritalar SDK'sını kullanan bir uygulamayı çalıştırmak istiyorsanız uygulamayı Android 5.0 veya sonraki sürümleri temel alan ve Google API'lerini içeren bir Android cihaza ya da Android emülatörüne dağıtmanız gerekir.
- Android cihaz kullanmak için Uygulamaları donanım cihazında çalıştırma başlıklı makaledeki talimatları uygulayın.
- Android emülatörü kullanmak için sanal cihaz oluşturabilir ve Android Sanal Cihaz (AVD) Yöneticisi bir uygulamadır.
Android Studio'da Google Haritalar projesi oluşturma
Android Studio'da Google Haritalar projesi oluşturma prosedürü ve Android Studio'nun sonraki sürümleri.
Android Studio'yu açın ve Android Studio'ya Hoş Geldiniz penceresinde Yeni Proje'yi tıklayın.
Yeni Proje penceresinde, Telefon ve Tablet kategorisinde, Etkinlik Yok'u seçin ve İleri'yi tıklayın.
Yeni Proje formunu doldurun:
Dil'i Java veya Kotlin olarak ayarlayın. Her iki dil de Android için Haritalar SDK'sı tarafından tam olarak desteklenir. Kotlin hakkında daha fazla bilgi edinmek için Kotlin ile Android uygulamaları geliştirme başlıklı makaleyi inceleyin.
Minimum SDK'yı test cihazınızla uyumlu bir SDK sürümüne ayarlayın. Android için Haritalar SDK'sı 19.0.x sürümü tarafından gereken minimum sürümden (Android API düzeyi 21 ("Lollipop"; Android 5.0) veya üstü) daha yeni bir sürüm seçmeniz gerekir. SDK sürümü şartlarıyla ilgili en son bilgiler için Sürüm Notları'na bakın.
Derleme yapılandırması dili ayarını Kotlin DSL veya Groovy DSL olarak belirleyin. Her iki derleme yapılandırması dili için snippet'ler aşağıda gösterilmiştir lütfen unutmayın.
Son'u tıklayın.
Android Studio, Gradle'ı başlatır ve projeyi oluşturur. Bu işlem zaman alabilir.
Google Haritalar Görüntüleme Etkinliği'ni ekleyin:
- Projenizde
app
klasörünü sağ tıklayın. Yeni > Google > Google Haritalar Görüntüleme Etkinliği'ni seçin.
Yeni Android Etkinliği iletişim kutusunda Başlatıcı Etkinliği onay kutusunu işaretleyin.
Son'u seçin.
Daha fazla bilgi için bkz. Şablondan kod ekleme
- Projenizde
Derleme tamamlandığında Android Studio,
AndroidManifest.xml
veMapsActivity
dosyalarını açar. Etkinliğinizin adı farklı olabilir, ancak kurulum sırasında yapılandırdığınız veridir.
Google Cloud projenizi oluşturun
Şu simgeyi tıklayarak gerekli Cloud Console kurulum adımlarını tamamlayın: ekleyebilirsiniz:
1. adım
Konsol
-
Yeni bir Cloud projesi oluşturmaya başlamak için Google Cloud Console'daki proje seçici sayfasında Proje Oluştur'u tıklayın.
-
Cloud projenizde faturalandırmanın etkinleştirildiğinden emin olun. Projeniz için faturalandırmanın etkinleştirildiğinden emin olun.
Google Cloud, 0,00 ABD doları ücretli deneme sürümü sunar. Deneme süresi 90 günün sonunda sona erer gün içinde veya hesaba 300 TL tutarında masraf tahakkuk ettikten sonra (hangisi önce gerçekleşirse) bunu yapabilirsiniz. İptal devam edebilir. Google Haritalar Platformu'nda aylık 200 ABD doları tutarındaki yinelenen bir kredi bulunur. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma başlıklı makaleleri inceleyin.
Google Cloud SDK
gcloud projects create "PROJECT"
Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:
2. Adım
Google Haritalar Platformu'nu kullanmak için projenizde kullanmayı planladığınız API'leri veya SDK'ları etkinleştirmeniz gerekir.
Konsol
Google Cloud SDK
gcloud services enable \ --project "PROJECT" \ "maps-android-backend.googleapis.com"
Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:
3. adım
Bu adım yalnızca API anahtarı oluşturma işlemiyle yapılır. API anahtarınızı üretimde kullanıyorsanız API anahtarınızı kısıtlamanızı önemle tavsiye ederiz. Daha fazla ürüne özel API Anahtarlarını Kullanma sayfasındaki bilgilere göz atın.
API anahtarı, şunun için projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır: yalnızca kullanım ve faturalandırma için değil. Projenizle ilişkilendirilmiş en az bir API anahtarınız olmalıdır.
API anahtarı oluşturmak için:
Konsol
-
Google Haritalar Platformu > Kimlik Bilgileri sayfasına gidin.
-
Credentials sayfasında Create credentials >'ı (Kimlik bilgileri oluştur) tıklayın. API anahtarı.
Oluşturulan API anahtarı iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir. -
Kapat'ı tıklayın.
. Yeni API anahtarı, Kimlik bilgileri sayfasında API anahtarları altında listelenir.
(API anahtarını üretimde kullanmadan önce kısıtlamayı unutmayın.)
Google Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Şu konu hakkında daha fazla bilgi edinin: Google Cloud SDK'sı , Google Cloud SDK kurulumu ve aşağıdaki komutları içerir:
API anahtarını uygulamanıza ekleyin
Bu bölümde, web siteleri tarafından güvenli bir şekilde referans verilebilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır.
en iyi şekilde yararlanabilirsiniz. API anahtarınızı sürüm kontrol sisteminize kontrol etmemeniz gerekir, bu nedenle
dosyayı, uygulamanızın kök dizininde bulunan secrets.properties
dosyasında depolayarak
belirler. secrets.properties
dosyası hakkında daha fazla bilgi için bkz.
Gradle özellikleri dosyaları.
Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin.
Google Haritalar projenize Android için Secrets Gradle Eklentisi'ni yüklemek için:
-
Android Studio'da üst düzey
build.gradle.kts
veyabuild.gradle
dosyanızı açın vebuildscript
altındakidependencies
öğesine aşağıdaki kodu ekleyin.Kotlin
buildscript { dependencies { classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
Modern
buildscript { dependencies { classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
-
Modül düzeyindeki
build.gradle.kts
veyabuild.gradle
dosyanızı açın veplugins
öğesine aşağıdaki kodu ekleyin.Kotlin
plugins { // ... id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
Modern
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
- Modül düzeyindeki
build.gradle.kts
veyabuild.gradle
dosyanızdatargetSdk
vecompileSdk
ayarlandığı için 34 yaşa. - Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
-
Üst düzey dizininizdeki
secrets.properties
dosyasını açıp aşağıdaki kodu ekleyin.YOUR_API_KEY
kısmını API anahtarınızla değiştirin.secrets.properties
, bir sürüm kontrol sistemine kontrol edilmekten hariç tutulduğu için anahtarınızı bu dosyada saklayın.MAPS_API_KEY=YOUR_API_KEY
- Dosyayı kaydedin.
-
Üst düzey dizininizde
local.defaults.properties
dosyasını oluşturun. klasörünüsecrets.properties
dosyası olarak kaydedin, ardından aşağıdaki kodu ekleyin.MAPS_API_KEY=DEFAULT_API_KEY
Bu dosyanın amacı,
secrets.properties
dosyası bulunamazsa API anahtarı için yedek bir konum sağlamak ve böylece derlemelerin başarısız olmasını önlemektir. Bu durum, uygulamayısecrets.properties
dosyasını atlayan bir sürüm kontrol sisteminden klonladıysanız ve API anahtarınızı sağlamak için henüz yerel olarak birsecrets.properties
dosyası oluşturmadıysanız ortaya çıkabilir. - Dosyayı kaydedin.
-
AndroidManifest.xml
dosyanızdacom.google.android.geo.API_KEY
bölümüne gidin veandroid:value attribute
değerini güncelleyin.<meta-data>
etiketi mevcut değilse bunu<application>
etiketi.<meta-data android:name="com.google.android.geo.API_KEY" android:value="${MAPS_API_KEY}" />
Not:
com.google.android.geo.API_KEY
önerilen meta veri adıdır girin. Bu ada sahip bir anahtar, Android için Haritalar SDK'sı da dahil olmak üzere Android platformundaki birden fazla Google Haritalar tabanlı API'de kimlik doğrulaması yapmak için kullanılabilir. API, geriye dönük uyumluluk içincom.google.android.maps.v2.API_KEY
adını da destekler. Bu eski ad yalnızca Android Maps API v2 ile kimlik doğrulamasına izin verir. Bir uygulama API anahtarı meta veri adlarından yalnızca birini belirtme. Her ikisi de belirtilmişse API bir istisna oluşturur. -
Android Studio'da modül düzeyindeki
build.gradle.kts
veyabuild.gradle
dosyasını açın vesecrets
özelliğini düzenleyin. Öğesecrets
mülkü mevcut değil, ekleyin.propertiesFileName
değerinisecrets.properties
,defaultPropertiesFileName
değerinilocal.defaults.properties
ve diğer özellikleri ayarlamak için eklentinin özelliklerini düzenleyin.Kotlin
secrets { // To add your Maps API key to this project: // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file. // 2. Add this line, where YOUR_API_KEY is your API key: // MAPS_API_KEY=YOUR_API_KEY propertiesFileName = "secrets.properties" // A properties file containing default secret values. This file can be // checked in version control. defaultPropertiesFileName = "local.defaults.properties" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
Modern
secrets { // To add your Maps API key to this project: // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file. // 2. Add this line, where YOUR_API_KEY is your API key: // MAPS_API_KEY=YOUR_API_KEY propertiesFileName = "secrets.properties" // A properties file containing default secret values. This file can be // checked in version control. defaultPropertiesFileName = "local.defaults.properties" // Configure which keys should be ignored by the plugin by providing regular expressions. // "sdk.dir" is ignored by default. ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore" ignoreList.add("sdk.*") // Ignore all keys matching the regexp "sdk.*" }
Koda bakın
Şablon tarafından sağlanan kodu inceleyin. Özellikle Android Studio projenizde aşağıdaki dosyalara bakın.
Haritalar etkinliği dosyası
Haritalar etkinlik dosyası, uygulamanın ana etkinliğidir ve haritayı yönetmek ve görüntülemek için gereken kodu içerir. Varsayılan olarak,
MapsActivity.java
adlı etkinliği tanımlarsa veya
uygulamanızın dili (MapsActivity.kt
)
Haritalar etkinliğinin ana öğeleri:
SupportMapFragment
nesnesi, yaşam döngüsünü oluşturur ve uygulamanın kullanıcı arayüzünün üst öğesidir.GoogleMap
nesnesi, harita verilerine erişim sağlar ve görünüm. Bu, Android için Haritalar SDK'sının ana sınıfıdır.SupportMapFragment
veGoogleMap
nesneleri, Harita Nesneleri kılavuzunda daha ayrıntılı olarak açıklanmaktadır.moveCamera
işlevi, haritayı şurada ortalar: Avustralya'da Sidney içinLatLng
koordinatları. Harita eklerken yapılandırmanız gereken ilk ayarlar genellikle harita konumu ve kamera ayarlarından (ör. görüntüleme açısı, harita yönü ve yakınlaştırma düzeyi) oluşur. Ayrıntılar için Kamera ve Görüntü kılavuzuna bakın.addMarker
işlevi, bu konuma ait koordinatlara bir işaretçi Sidney. Ayrıntılar için İşaretçiler kılavuzuna bakın.
Modül Gradle dosyası
build.gradle.kts
modülü dosyası, Android için Haritalar SDK'sı tarafından gereken aşağıdaki Haritalar bağımlılığını içerir.
dependencies { // Maps SDK for Android implementation("com.google.android.gms:play-services-maps:19.0.0") }
Haritalar bağımlılığını yönetme hakkında daha fazla bilgi edinmek için Sürüm oluşturma bölümüne bakın.
XML düzen dosyası
activity_maps.xml
dosyası,
yapısına dikkat edin. Dosya, res/layout
dizininde bulunur.
activity_maps.xml
dosyası şunları içeren bir parça bildirir:
öğeler:
tools:context
, parçanın varsayılan etkinliğini ayarlar Haritalar etkinlik dosyasında tanımlananMapsActivity
olarak.android:name
, parçanın sınıf adını şu şekilde ayarlar:SupportMapFragment
, harita etkinliğinde kullanılan parça türüdür dosyası olarak kaydedebilirsiniz.
XML düzen dosyası aşağıdaki kodu içerir:
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/map"
android:name="com.google.android.gms.maps.SupportMapFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MapsActivity" />
Uygulamayı dağıtma ve çalıştırma
Uygulamayı başarılı bir şekilde çalıştırdığınızda, ortalanmış olan harita Aşağıdaki ekran görüntüsünde görüldüğü gibi, şehrin üzerinde bir işaretçi bulunan Sidney Avustralya.
Uygulamayı dağıtmak ve çalıştırmak için:
- Android Studio'da Çalıştır menü seçeneğini (veya oynat düğmesi simgesini) tıklayarak yardımcı olabilir.
- Cihaz seçmeniz istendiğinde aşağıdaki seçeneklerden birini belirleyin:
- Bilgisayarınıza bağlı Android cihazı seçin.
- Alternatif olarak, Emülatör'ü başlat radyo düğmesini ve ayarladığınız sanal cihazı seçin.
- Tamam'ı tıklayın. Android Studio, uygulamanızı derlemek için Gradle'i başlatır ve ardından sonuçları cihazınızda veya emülatörde gösterir. Uygulamanın yüklenmesi birkaç dakika sürebilir lansman sonrasında gerçekleşebilir.
Sonraki adımlar
Harita oluşturma: Bu doküman haritanız için başlangıç ve çalışma zamanı ayarlarını nasıl yapacağınızı açıklar. Kamera konumu, harita türü, kullanıcı arayüzü bileşenleri ve hareketler gibi.
Android uygulamanıza (Kotlin) harita ekleme: Bu codelab Gemini'ın bazı ek özelliklerini gösteren uygulamada size yol gösterir. Android için Haritalar SDK'sı.
Haritalar Android KTX kitaplığını kullanın: Bu Kotlin uzantıları (KTX) kitaplığı, Android için Haritalar SDK'sını kullanırken çeşitli Kotlin dili özelliklerinden yararlanmanıza olanak tanır.