Özel görünümlerle işaretçi oluşturma

New York'un 3D görüntüsünde Empire State Binası ve üzerinde üç özel dijital işaretçi görünüyor. İşaretçilerden biri, etiketli bir çizgi film gorili.

Özel Android View hiyerarşilerini 3D haritada işaretçi olarak oluşturmak için MarkerView kullanabilirsiniz. Özel görünüm işaretçileri, coğrafi koordinatlara sabitlenmiş zengin kullanıcı arayüzü yerleşimleri, etkileşimli widget'lar ve görünüm animasyonları görüntülemenize olanak tanır.

Özel görünüm işaretçisi ekleme

Haritanıza özel görünüm işaretçisi eklemek için bir MarkerViewOptions örneği oluşturun, LatLngAltitude nesnesi kullanarak konumunu setPosition ile yapılandırın ve setContent kullanarak özel Android View öğenizi sağlayın. Ardından, seçenekleri GoogleMap3D örneğinizdeki addMarkerView öğesine iletin.

setContent için bir görünüm sağlamazsanız SDK, varsayılan bir PinView oluşturur ve oluşturur.

// Add imports
import android.widget.TextView
import com.google.android.gms.maps3d.model.MarkerViewOptions
import com.google.android.gms.maps3d.model.latLngAltitude

// Create a custom Android View
val badgeView = TextView(context).apply {
    text = "Empire State Building"
    contentDescription = "Marker for Empire State Building"
    setPadding(24, 12, 24, 12)
}

// Configure MarkerViewOptions and add the marker view to the map
val options = MarkerViewOptions().apply {
    position = latLngAltitude {
        latitude = 40.7484
        longitude = -73.9857
        altitude = 100.0
    }
    content = badgeView
}

val markerView = googleMap3D.addMarkerView(options)

Varsayılan PinView'u özelleştirme

Tamamen özel bir Android View oluşturmak yerine, özel bir PinConfiguration ile PinView oluşturarak (veya mevcut bir örneği setPinConfiguration ile güncelleyerek) ve bunu setContent öğesine ileterek özelleştirilmiş bir raptiye oluşturabilirsiniz.

// Add imports
import android.graphics.Color
import com.google.android.gms.maps3d.model.MarkerViewOptions
import com.google.android.gms.maps3d.model.PinView
import com.google.android.gms.maps3d.model.latLngAltitude
import com.google.android.gms.maps3d.model.pinConfiguration

// Create a customized PinView
val customPinView = PinView(context, pinConfiguration {
    backgroundColor = Color.BLUE
    borderColor = Color.WHITE
})

// Configure MarkerViewOptions and add the marker view to the map
val options = MarkerViewOptions().apply {
    position = latLngAltitude {
        latitude = 40.7484
        longitude = -73.9857
        altitude = 100.0
    }
    content = customPinView
}

val markerView = googleMap3D.addMarkerView(options)

Etkileşimleri ve animasyonları yönetme

MarkerView, Android View'yi sarmaladığı için standart tıklama dinleyicileri ve görünüm animasyonlarını doğrudan getContent tarafından döndürülen görünüme ekleyebilirsiniz.

Ayrıca MarkerView, addPopover kullanarak bir Popover öğesini işaretçi görünümüne sabitlemenize olanak tanıyan Anchorable öğesini uygular:

markerView?.content?.setOnClickListener { view ->
    // Animate the view when clicked
    view.animate().rotationBy(90f).setDuration(300).start()
}

Rakım ve çakışma davranışını yapılandırma

MarkerView öğesinin dikey olarak nasıl konumlandırılacağını ve çakışan harita etiketleri veya işaretçileriyle nasıl etkileşim kuracağını özelleştirebilirsiniz:

Erişilebilirlik ve kaldırma

setContent için sağlanan özel Android View üzerinde contentDescription gibi erişilebilirlik özelliklerini yapılandırmak sizin sorumluluğunuzdadır.

Haritadan bir MarkerView öğesini kaldırmak için remove yöntemini çağırın:

markerView?.remove()