Android Studio için Google Haritalar Görünümleri şablonunu kullanarak harita görüntüleyen bir Android uygulaması oluşturun. Ayarlamak istediğiniz mevcut bir Android Studio projeniz varsa Android Studio projesi oluşturma bölümüne bakın.
Bu hızlı başlangıç kılavuzu, Kotlin veya Java ile temel Android geliştirme hakkında bilgi sahibi olan geliştiricilere yöneliktir.
Geliştirme ortamı hakkında
Bu hızlı başlangıç kılavuzu, Android StudioHedgehog ve Android Gradle eklentisi 8.2 sürümü kullanılarak geliştirildi.
Android cihaz kurulumu
Android için Haritalar SDK'sını kullanan bir uygulamayı çalıştırmak istiyorsanız bu uygulamayı, Android 5.0 veya sonraki sürümleri tabanlı 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 Donanım cihazında uygulama çalıştırma sayfasındaki talimatları uygulayın.
- Android emülatörü kullanmak için sanal bir cihaz oluşturabilir ve Android Studio ile birlikte gelen Android Sanal Cihaz (AVD) Yöneticisi'ni kullanarak emülatörü yükleyebilirsiniz.
Android Studio'da Google Haritalar projesi oluşturma
Android Studio'da Google Haritalar projesi oluşturma prosedürü, Flamingo'da ve Android Studio'nun sonraki sürümlerinde değiştirildi.
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çip İ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 desteklenmektedir. Kotlin hakkında daha fazla bilgi edinmek için Kotlin ile Android uygulamaları geliştirme konusuna bakın.
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ü (Android API Düzeyi 21 ("Lollipop"; Android 5.0) veya sonraki bir sürüm" için gereken minimum sürümden daha büyük bir sürüm seçmeniz gerekir. SDK sürümü gereksinimleri hakkında en güncel 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ğıdaki prosedürlerde gösterilmektedir.
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 Maps Görünüm Etkinliği'ni seçin.
Yeni Android Etkinliği iletişim kutusunda Başlatıcı Etkinliği onay kutusunu seçin.
Son'u seçin.
Daha fazla bilgi için Şablondan kod ekleme bölümüne bakın.
- 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 addır.
Google Cloud projenizi oluşturun
Aşağıdaki sekmeleri tıklayarak gerekli Cloud Console kurulum adımlarını tamamlayın:
1. Adım
Konsol
-
Yeni bir Cloud projesi oluşturmaya başlamak için Google Cloud Console'un proje seçici sayfasında Proje Oluştur'u tıklayın.
-
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 veya hesaba 300 ABD doları değerinde ücret tahakkuk ettikten sonra (hangisi önce gerçekleşirse) sona erer. Dilediğiniz zaman iptal edebilirsiniz. Google Haritalar Platformu'nda aylık 200 ABD doları değerinde yinelenen bir kredi sunulur. Daha fazla bilgi için Faturalandırma hesabı kredileri ve Faturalandırma bölümlerine göz atın.
Google Cloud SDK
gcloud projects create "PROJECT"
Google Cloud SDK, Google Cloud SDK kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
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"
Google Cloud SDK, Google Cloud SDK kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
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. Ürüne özgü API Anahtarlarını Kullanma sayfasında daha fazla bilgi bulabilirsiniz.
API anahtarı, kullanım ve faturalandırma amacıyla projenizle ilişkili isteklerin kimliğini doğrulayan benzersiz bir tanımlayıcıdır. 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.
-
Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > API anahtarı'nı tıklayın.
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ı'nın altında listelenmiştir.
(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"
Google Cloud SDK, Google Cloud SDK kurulumu ve aşağıdaki komutlar hakkında daha fazla bilgi edinin:
API anahtarını uygulamanıza ekleyin
Bu bölümde, uygulamanız tarafından güvenli bir şekilde referans verilebilmesi için API anahtarınızı nasıl depolayacağınız açıklanmaktadır. API anahtarınızı sürüm kontrol sisteminizde kontrol etmemeniz gerekir. Bu nedenle, projenizin kök dizininde bulunan secrets.properties
dosyasında saklamanızı öneririz. secrets.properties
dosyası hakkında daha fazla bilgi için Gradle özellikleri dosyaları bölümüne bakın.
Bu görevi kolaylaştırmak için Android için Secrets Gradle Eklentisi'ni kullanmanızı öneririz.
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
dosyanızı açın ve aşağıdaki kodubuildscript
altındakidependencies
öğesine ekleyin.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 veplugins
öğesine aşağıdaki kodu ekleyin.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
öğelerinin 34 olarak ayarlandığından emin olun. - Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
-
En üst düzey dizininizde
secrets.properties
dosyasını açın ve ardından aşağıdaki kodu ekleyin.YOUR_API_KEY
kısmını API anahtarınızla değiştirin.secrets.properties
, sürüm kontrol sistemine kontrol edilmekten hariç tutulduğu için anahtarınızı bu dosyada depolayın.MAPS_API_KEY=YOUR_API_KEY
- Dosyayı kaydedin.
-
local.defaults.properties
dosyasını en üst düzey dizininizde,secrets.properties
dosyasıyla aynı klasörde oluşturun ve aşağıdaki kodu ekleyin.MAPS_API_KEY=DEFAULT_API_KEY
Bu dosyanın amacı,
secrets.properties
dosyası bulunamazsa API anahtarı için yedek konum sağlayarak derlemelerin başarısız olmasını sağlamaktır. Uygulamayısecrets.properties
içermeyen bir sürüm kontrol sisteminden klonlarsanız ve henüz API anahtarınızı sağlamak için yerel olarak birsecrets.properties
dosyası oluşturmadıysanız bu durum ortaya çıkabilir. - Dosyayı kaydedin.
-
AndroidManifest.xml
dosyanızdacom.google.android.geo.API_KEY
bölümüne gidipandroid:value attribute
dosyasını güncelleyin.<meta-data>
etiketi yoksa bu etiketi<application>
etiketinin alt öğesi olarak oluşturun.<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, Android Studio projenizde aşağıdaki dosyalara bakın.
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, etkinliği tanımlayan dosyanın adı
MapsActivity.java
olur veya Kotlin'i uygulamanızın dili olarak ayarlarsanızMapsActivity.kt
olur.Haritalar etkinliğinin ana öğeleri:
SupportMapFragment
nesnesi, haritanın yaşam döngüsünü yönetir ve uygulamanın kullanıcı arayüzünün üst öğesidir.GoogleMap
nesnesi, harita verilerine ve görünümüne erişim sağlar. Bu, Android için Haritalar SDK'sının ana sınıfıdır. Harita Nesneleri kılavuzunda,SupportMapFragment
veGoogleMap
nesneleri daha ayrıntılı olarak açıklanmaktadır.moveCamera
işlevi, haritayı Sidney'inLatLng
koordinatlarında ortalar. Harita eklerken yapılandırılan ilk ayarlar genellikle görüntüleme açısı, harita yönü ve yakınlaştırma düzeyi gibi harita konumu ve kamera ayarlarıdır. Ayrıntılar için Kamera ve Görünüm kılavuzuna bakın.addMarker
işlevi, Sidney'in koordinatlarına bir işaretçi ekler. Ayrıntılar için İşaretçiler kılavuzuna bakın.
Module Gradle dosyası
build.gradle
adlı Modül dosyası, Android için Haritalar SDK'sı tarafından zorunlu kılınan aşağıdaki harita 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ı, uygulamanın kullanıcı arayüzünün yapısını tanımlayan XML düzen dosyasıdır. Dosya,res/layout
dizininde bulunur.activity_maps.xml
dosyası, aşağıdaki öğeleri içeren bir parçayı bildirir:tools:context
, parçanın varsayılan etkinliğini, harita etkinlik dosyasında tanımlananMapsActivity
olarak ayarlar.android:name
, parçanın sınıf adını, harita etkinlik dosyasında kullanılan parça türü olanSupportMapFragment
olarak ayarlar.
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, aşağıdaki ekran görüntüsünde görüldüğü gibi, Sidney Avustralya'yı merkez alan bir harita ve şehir üzerinde bir işaretçi gösterilir.
Uygulamayı dağıtmak ve çalıştırmak için:
- Android Studio'da, uygulamanızı çalıştırmak için Çalıştır menü seçeneğini (veya oynat düğmesi simgesini) tıklayın.
- 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 ardından kurduğunuz sanal cihazı seçin.
- Tamam'ı tıklayın. Android Studio, uygulamanızı derlemek için Gradle'ı başlatır, ardından sonuçları cihazınızda veya emülatörünüzde görüntüler. Uygulamanın başlatılması birkaç dakika sürebilir.
Sonraki adımlar
Harita oluşturma: Bu dokümanda, haritanız için kamera konumu, harita türü, kullanıcı arayüzü bileşenleri ve hareketler gibi başlangıç ve çalışma zamanı ayarlarının nasıl yapılacağı açıklanmaktadır.
Android uygulamanıza harita ekleme (Kotlin): Bu codelab'de, Android için Haritalar SDK'sının bazı ek özelliklerini gösteren bir uygulamada yol gösterici bilgiler sağlanmaktadır.
Haritalar Android KTX kitaplığını kullanma: 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.
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-07-13 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" }]