Uygulamanıza 3D harita ekleme

Platform seçin: Android iOS JavaScript

New York şehrini gösteren bir 3D harita

Bu sayfada, Android için Haritalar 3D SDK'sını kullanarak Android uygulamasına temel bir 3D haritanın nasıl ekleneceğine dair bir örnek açıklanmaktadır. Bu sayfadaki talimatlarda, Kurulum sayfasındaki adımları tamamladığınız ve aşağıdakilere sahip olduğunuz varsayılır:

  • Android için Haritalar 3D SDK'sının etkinleştirildiği bir Google Cloud projesi
  • Android için Haritalar 3D SDK'sı ile kullanılacak şekilde yapılandırılmış bir API anahtarı
  • Android için Haritalar 3D SDK'sı ile kullanılmak üzere ayarlanmış bir Android Studio projesi

Bu ön koşullar hakkında daha fazla bilgi için Kurulum başlıklı makaleyi inceleyin.

1. bölüm: Map3DView bileşenini eklemek için düzen dosyasını (activity_main.xml) güncelleyin

Map3DView bileşeni, uygulama içinde 3D haritayı oluşturmak için kullanılan görünümdür. Aşağıdaki adımlarda, bileşen eklenir ve kamera konumu ile ilgili özellikler de dahil olmak üzere haritanın ilk durumu yapılandırılır:

  1. Ana etkinliğinizin düzen dosyasını açın. Bu dosya genellikle app/src/main/res/layout/activity_main.xml konumunda bulunur.

  2. Kök ConstraintLayout öğesine (veya kök düzen öğenize) map3d XML ad alanını ekleyin:

    xmlns:map3d="http://schemas.android.com/apk/res-auto"

  3. "Hello World!" ifadesini gösteren varsayılan <TextView> öğesini silin.

  4. Düzeninize Map3DView bileşenini ekleyin. Kamera konumunu ve diğer özellikleri özelleştirebilirsiniz:

    <?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  xmlns:map3d="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools"
  android:id="@+id/main"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  tools:context=".MainActivity">

  <com.google.android.gms.maps3d.Map3DView
    android:id="@+id/map3dView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map3d:mode="hybrid"
    map3d:centerLat="38.544012"
    map3d:centerLng="-107.670428"
    map3d:centerAlt="2427.6"
    map3d:heading="310"
    map3d:tilt="63"
    map3d:range="8266"
    map3d:roll="0"
    map3d:minAltitude="0"
    map3d:maxAltitude="1000000"
    map3d:minHeading="0"
    map3d:maxHeading="360"
    map3d:minTilt="0"
    map3d:maxTilt="90"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

2. bölüm: MainActivity.kt dosyasını güncelleyin

Aşağıdaki adımlar, 1. bölümde activity_main.xml dosyasına eklenen Map3DView bileşenini başlatır ve bileşen yaşam döngüsü etkinliklerini yönetir:

  1. Genellikle app/src/main/java/com/example/yourpackagename/MainActivity.kt konumunda bulunan MainActivity.kt dosyanızı açın.

  2. Android için Haritalar 3D SDK'sı ile ilgili gerekli içe aktarma işlemlerini ekleyin:

    import com.google.android.gms.maps3d.GoogleMap3D
import com.google.android.gms.maps3d.Map3DView
import com.google.android.gms.maps3d.OnMap3DViewReadyCallback

  3. MainActivity sınıfını OnMap3DViewReadyCallback'yi uygulayacak şekilde değiştirin:

    class MainActivity : AppCompatActivity(), OnMap3DViewReadyCallback {

  4. Map3DView ve GoogleMap3D için değişkenleri bildirin:

    private lateinit var map3DView: Map3DView
private var googleMap3D: GoogleMap3D? = null

  5. onCreate yönteminde, setContentView(...) ve ViewCompat.setOnApplyWindowInsetsListener bloğundan sonra map3DView öğesini başlatın, onCreate yaşam döngüsü yöntemini çağırın ve haritayı eşzamansız olarak isteyin:

    override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    enableEdgeToEdge()
    setContentView(R.layout.activity_main)
    ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
        val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
        v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
        insets
    }

    map3DView = findViewById(R.id.map3dView)
    map3DView.onCreate(savedInstanceState)
    map3DView.getMap3DViewAsync(this)
}

  6. onMap3DViewReady yöntemini geçersiz kılın. Bu geri çağırma, harita kullanılmaya hazır olduğunda tetiklenir:

    override fun onMap3DViewReady(googleMap3D: GoogleMap3D) {
    // Interact with the googleMap3D object here
    this.googleMap3D = googleMap3D
    // You can now make calls to the googleMap3D object, e.g.,
    // googleMap3D.cameraController.flyTo(camera { ... })
}

  7. Aşağıdaki geçersiz kılmaları MainActivity öğesine ekleyerek etkinlik yaşam döngüsü etkinliklerini Etkinliğinizden Map3DView öğesine yönlendirin:

    override fun onStart() {
    super.onStart()
    map3DView.onStart()
}

override fun onResume() {
    super.onResume()
    map3DView.onResume()
}

override fun onPause() {
    map3DView.onPause()
    super.onPause()
}

override fun onStop() {
    map3DView.onStop()
    super.onStop()
}

override fun onDestroy() {
    map3DView.onDestroy()
    super.onDestroy()
}

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    map3DView.onSaveInstanceState(outState)
}

override fun onLowMemory() {
    super.onLowMemory()
    map3DView.onLowMemory()
}

3. bölüm: Gradle'ı senkronize etme ve çalıştırma

Uygulamanızın düzenini ve etkinliğini güncellediğinize göre artık 3D harita görünümünü görmek için uygulamayı oluşturup çalıştırabilirsiniz.

  1. Projenizi Gradle ile senkronize etmek için File > Sync Project with Gradle Files'ı (Dosya > Projeyi Gradle Dosyalarıyla Senkronize Et) seçin.

  2. Uygulamanızı bir emülatörde veya fiziksel cihazda oluşturup çalıştırmak için Run > Run'ı (Çalıştır > Çalıştır) seçin.

Her şey doğru şekilde yapılandırıldıysa uygulamanızda 3D harita gösterilir. Bu harita, activity_main.xml dosyanızda belirtilen koordinatların yakınında ortalanır.

Sonraki adımlar

Uygulamanıza temel bir 3D harita eklediğinize göre artık Android için Maps 3D SDK'sının kamera yolu animasyonları, 3D işaretçiler veya çokgenler gibi daha gelişmiş özelliklerini keşfedebilirsiniz.