Android için Haritalar SDK'sı Hızlı Başlangıç Kılavuzu

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.

Not: Geliştirme ortamınız, Android Studio'nun farklı bir sürümünü kullanıyorsa veya Gradle'ı tercih edebilirsiniz. Adımları ortamınıza göre değiştirmeniz gerekebilir. Daha fazla Android Studio ve Gradle sürümleri hakkında bilgi edinmek için Android Gradle eklentisine bakın. ve Android Studio dikkat edin.

Android cihaz kurma

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ünü kullanmak için Android Studio ile birlikte gelen Android Virtual Device (AVD) Manager'ı kullanarak sanal cihaz oluşturabilir ve emülatörü yükleyebilirsiniz.
  Not: Android emülatörü kullanmayı seçerseniz Play Store sütununun altında görüntülenen Oynat simgesi olan bir cihaz seçin. Bu simge, bu profillerin tamamen CTS olduğunu gösterir uyumlu olmalıdır ve Play Store uygulamasını içeren sistem resimlerini kullanabilir:

  

Android Studio'da Google Haritalar projesi oluşturma

Android Studio'da Google Haritalar projesi oluşturma işlemi, Android Studio'nun Flamingo ve sonraki sürümlerinde değiştirildi.

1. Android Studio'yu açın ve Android Studio'ya Hoş Geldiniz penceresinde Yeni Proje'yi tıklayın.

2. Yeni Proje penceresinde, Telefon ve Tablet kategorisinde, Etkinlik Yok'u seçin ve İleri'yi tıklayın.

3. 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.

     Not: Hangi SDK sürümünü seçeceğinizden emin değilseniz Desteklenen kuruluşlara ilişkin dağıtım bilgilerini görüntülemek için Seçmeme yardım et bağlantısı Android SDK'ları Örneğin, Android API Düzey 21 ("Lollipop"; Android 5.0), uygulamanız şurada çalışır: Android cihazların% 99'unda.

   • Derleme yapılandırması dili ayarını Kotlin DSL veya Groovy DSL olarak belirleyin. Aşağıdaki prosedürlerde her iki derleme yapılandırması dili için de snippet'ler gösterilmektedir.

4. Son'u tıklayın.

   Android Studio, Gradle'i başlatır ve projeyi derler. Bu işlem zaman alabilir.

5. Google Maps Görünüm Etkinliği'ni ekleyin:

   1. Projenizde app klasörünü sağ tıklayın.

   2. Yeni > Google > Google Haritalar Görünümleri Etkinliği.

      

   3. Yeni Android Etkinliği iletişim kutusunda Başlatıcı Etkinliği onay kutusunu işaretleyin.

   4. Son'u seçin.

      Daha fazla bilgi için bkz. Şablondan kod ekleme

6. Derleme tamamlandığında Android Studio, AndroidManifest.xml öğesini açar ve MapsActivity dosya. Etkinliğinizin adı farklı olabilir, ancak kurulum sırasında yapılandırdığınız veridir.

   Dikkat: AndroidManifest.xml dosyası, bir Google Maps API anahtarı ve ardından local.properties dosyanıza eklemek. Yapılması gerekenler local.properties dosyasına API anahtarınızı eklemeyin. Bu durumda API anahtarınız daha az güvenli bir şekilde depolanır. Bunun yerine, Cloud projesi oluşturmak için Google Cloud projenizi ayarlama başlıklı makaleye göz atın ve API anahtarı yapılandırabilirsiniz.

Google Cloud projenizi ayarlama

Şu simgeyi tıklayarak gerekli Cloud Console kurulum adımlarını tamamlayın: ekleyebilirsiniz:

1. Adım

Konsol

1. Google Cloud Console'daki proje seçici sayfasında Yeni bir Cloud oluşturmaya başlamak için Proje oluşturun belirler.

   Proje seçici sayfasına gidin

2. 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ı ü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. İstediğ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 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:

• gcloud projects create

Not: Oluşturduğunuz kaynakları tutmayı düşünmüyorsanız öğrenme alıştırmasında, mevcut bir projeyi seçmek yerine bir proje oluşturmalıdır. Bitirdiğinizde Bu alıştırmada projeyi silerek projeyle ilişkili tüm kaynakları kaldırabilirsiniz.

2. Adım

Google Haritalar Platformu'nu kullanmak için projenizde kullanmayı planladığınız API'leri veya SDK'ları etkinleştirmeniz gerekir.

Konsol

Android için Haritalar SDK'sını etkinleştirme

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:

• gcloud services enable
• gcloud services disable

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 atabilirsiniz.

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

1. Google Haritalar Platformu'na gidin > Credentials (Kimlik Bilgileri) sayfasını ziyaret edin.

   Kimlik Bilgileri sayfasına gidin

2. Credentials sayfasında Create credentials >'ı (Kimlik bilgisi oluştur) tıklayın. API anahtarı.
   API anahtarı oluşturuldu iletişim kutusunda yeni oluşturulan API anahtarınız gösterilir.
3. 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:

• gcloud alpha services api-keys create

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 Gradle özellik dosyaları konusuna bakın.

Bu görevi kolaylaştırmak için Android için Secrets Gradle Plugin.

Not: Bkz. Android için Secrets Gradle Plugin dokümanlarına göz atabilirsiniz.

Google Haritalar projenize Android için Secrets Gradle Eklentisi'ni yüklemek için:

1. Android Studio'da üst düzey build.gradle.kts veya build.gradle dosyasını seçin ve aşağıdaki kodu altındaki dependencies öğesine ekleyin buildscript.

   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"
       }
   }
   

2. Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızı açın ve plugins öğ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'
   }

3. Modül düzeyindeki build.gradle.kts veya build.gradle dosyanızda targetSdk ve compileSdk değerlerinin 34 olarak ayarlandığından emin olun.
4. Dosyayı kaydedin ve projenizi Gradle ile senkronize edin.
5. 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ın çünkü secrets.properties, sürüm kontrolüne kontrol edilmekten hariç tutuldu bahsedeceğim.
   Not: secrets.properties dosyası yoksa local.properties dosyasıyla aynı klasörde oluşturun.

   MAPS_API_KEY=YOUR_API_KEY

6. Dosyayı kaydedin.

7. Ü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.

   Not: Kodu gösterildiği gibi girin. Değiştirme API anahtarınızla DEFAULT_API_KEY.

   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 secrets.properties içermeyen bir sürüm kontrol sisteminden klonlarsınız sağlamak için henüz yerel olarak bir secrets.properties dosyası oluşturmadınız API anahtarı.

8. Dosyayı kaydedin.
9. AndroidManifest.xml dosyanızda şuna gidin: com.google.android.geo.API_KEY ve android: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 name com.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.

10. In Android Studio, open your module-level build.gradle.kts or build.gradle file and edit the secrets property. If the secrets property does not exist, add it.

    Edit the properties of the plugin to set propertiesFileName to secrets.properties, set defaultPropertiesFileName to local.defaults.properties, and set any other properties.

    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 unsurları:

• SupportMapFragment nesnesi, yaşam döngüsünü temsil eder ve uygulama 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 ve GoogleMap nesnelerini daha fazla açıklamada bolca fırsat sunuyor.

• moveCamera işlevi, haritayı şurada ortalar: Avustralya'da Sidney için LatLng 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. Ayrıntılar için Kamera ve Görüntü kılavuzuna bakın.

• 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.kts 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")
}

Not: Tam sürüm, Android için Haritalar SDK'sının mevcut sürümüne bağlı olarak değişebilir.

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 dizinindedir. 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ımlanan MapsActivity 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:

1. Uygulamanızı çalıştırmak için Android Studio'da Çalıştır menü seçeneğini (veya oynat düğmesi simgesini) tıklayın.
2. 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.
3. 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ı 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.