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ıç, temel işlemler hakkında bilgi sahibi olan geliştiricilere yöneliktir. Kotlin veya Java ile Android geliştirme
Geliştirme ortamı hakkında
Bu hızlı başlangıç, Android Studio ile geliştirildi Kirpi ve Android Gradle eklentisi sürümü 8.2'dir.
Android cihaz kurulumu
Android için Haritalar SDK'sını kullanan bir uygulamayı çalıştırmak istiyorsanız bunu bir Android cihaza veya Android'e dağıtmanız gerekir. Android 5.0 veya sonraki sürümleri temel alan ve Google API'leri.
- Android cihaz kullanmak için şu adresteki talimatları uygulayın: Uygulamaları donanım cihazında çalıştırma.
- 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 Yeni Proje Android Studio'ya hoş geldiniz penceresi.
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 Google Haritalar SDK'sı. Kotlin hakkında daha fazla bilgi edinmek için bkz. Kotlin ile Android uygulamaları geliştirme.
Minimum SDK'yı test cihazınızla uyumlu bir SDK sürümüne ayarlayın. Android için Haritalar SDK'sı sürüm 19.0.x, Android API Düzey 21 ("Lollipop"; Android 5.0) veya sonraki sürümler. Aşağıdakiler için Sürüm Notları'na bakın: SDK sürümü gereksinimleriyle ilgili en güncel bilgiler.
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 Maps Görünüm Etkinliği'ni ekleyin:
- Projenizde
app
klasörünü sağ tıklayın. Yeni > Google > Google Haritalar Görünümleri Etkinliği.
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
öğesini açar veMapsActivity
dosya. 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
-
Google Cloud Console'daki proje seçici sayfasında Yeni bir Cloud oluşturmaya başlamak için Proje oluşturun belirler.
-
Cloud projeniz için faturalandırmanın etkinleştirildiğinden emin olun. Projenizde faturalandırmanın etkin olduğunu onaylayın.
Google Cloud 0,00 ABD doları deneme süresi 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ı değerinde yinelenen bir kredi sunulur. Daha fazla bkz. Faturalandırma hesabı kredileri ve Faturalandırma.
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:
ziyaret edin.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ı 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'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.
-
Credentials sayfasında Create credentials >'ı (Kimlik bilgileri oluştur) tıklayın. API anahtarı.
API anahtarı oluşturuldu 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'yi kısıtlamayı unutmayın. anahtarının doğru şekilde yüklenmesini sağlayı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
veyabuild.gradle.kts
dosyasını seçin ve aşağıdaki kodu altındakidependencies
öğesine ekleyinbuildscript
.Modern
buildscript { dependencies { classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1" } }
Kotlin
buildscript { dependencies { classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1") } }
-
Modül düzeyindeki
build.gradle
dosyanızı açın ve aşağıdaki koduplugins
öğesi.Modern
plugins { // ... id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' }
Kotlin
plugins { id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") }
- Modül düzeyindeki
build.gradle
dosyanızdatargetSdk
vecompileSdk
, 34 olarak ayarlandı. - Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
-
secrets.properties
dosyasını en üst düzey dizininizde açın ve şunu ekleyin: aşağıdaki kodu kullanabilirsiniz.YOUR_API_KEY
kısmını API anahtarınızla değiştirin. Anahtarınızı bu dosyada depolayınsecrets.properties
, sürüm kontrolüne kontrol edilmekten hariç tutulduğundan bahsedeceğim.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ı, Derlemelerin başarısız olmaması için
secrets.properties
dosyası bulunamadı. Bu durum, uygulamayı,secrets.properties
ve sağlamak için henüz yerel olarak birsecrets.properties
dosyası oluşturmadınız API anahtarı. - Dosyayı kaydedin.
-
AndroidManifest.xml
dosyanızda şuna gidin:com.google.android.geo.API_KEY
veandroid:value attribute
öğesini 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}" />
Note:
com.google.android.geo.API_KEY
is the recommended metadata name for the API key. A key with this name can be used to authenticate to multiple Google Maps-based APIs on the Android platform, including the Maps SDK for Android. For backwards compatibility, the API also supports the namecom.google.android.maps.v2.API_KEY
. This legacy name allows authentication to the Android Maps API v2 only. An application can specify only one of the API key metadata names. If both are specified, the API throws an exception. -
In Android Studio, open your module-level
build.gradle
orbuild.gradle.kts
file and edit thesecrets
property. If thesecrets
property does not exist, add it.Edit the properties of the plugin to set
propertiesFileName
tosecrets.properties
, setdefaultPropertiesFileName
tolocal.defaults.properties
, and set any other properties.Groovy
secrets { // Optionally specify a different file name containing your secrets. // The plugin defaults to "local.properties" 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.*" }
Kotlin
secrets { // Optionally specify a different file name containing your secrets. // The plugin defaults to "local.properties" 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 aşağıdaki konulara bakın: dosyaları oluşturun.
Haritalar etkinlik 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. Harita Nesneleri kılavuzu,SupportMapFragment
veGoogleMap
nesnelerini daha fazla açıklamada bolca fırsat sunuyor.moveCamera
işlevi, haritayı şurada ortalar: Avustralya'da Sidney içinLatLng
koordinatları. Bu ilk ayarların Harita eklerken yapılandırmak için genellikle harita konumu ve kamera ayarları gerekir. görüntüleme açısı, harita yönü ve yakınlaştırma düzeyi gibi. Bkz. Ayrıntılar için Kamera ve Görünüm rehberini inceleyin.addMarker
işlevi, her bir öğenin koordinatlarına bir işaretçi Sidney. Ayrıntılar için İşaretçiler kılavuzuna bakın.
Module Gradle dosyası
build.gradle
adlı Modül dosyası şu harita bağımlılığını içerir: Android için Haritalar SDK'sı tarafından gereklidir.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 Launch emülator (Emülatörü başlat) radyo düğmesini, ardından da sanal cihazdır.
- Tamam'ı tıklayın. Android Studio, uygulamanızı derlemek için Gradle'ı başlatır ve ardından sonuçları cihazınızda veya emülatörünüzde görüntüler. 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ı kullanma: Bu Kotlin uzantıları (KTX) kitaplığı, birçok avantajdan Android için Haritalar SDK'sını kullanırken Kotlin dili özellikleri.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-08-16 UTC.
[{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"İhtiyacım olan bilgiler yok" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Çok karmaşık / çok fazla adım var" },{ "type": "thumb-down", "id": "outOfDate", "label":"Güncel değil" },{ "type": "thumb-down", "id": "translationIssue", "label":"Çeviri sorunu" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Örnek veya kod sorunu" },{ "type": "thumb-down", "id": "otherDown", "label":"Diğer" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Anlaması kolay" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Sorunumu çözdü" },{ "type": "thumb-up", "id": "otherUp", "label":"Diğer" }]