Önemli yerlerle etkileşim kurma

Tıklama sonucunda ekranın alt kısmında yer ayrıntılarını içeren küçük bir popover gösteren fotoğraf.

Kullanıcı bir önemli yeri (ÖY) tıkladığında Android için Haritalar 3D SDK'sı, ilgili ÖY için bir Konum widget'ı gösterir. Tıklama etkinliklerini dinleyebilir ve OnMap3DClickListener kullanarak bu widget'ı gizleyebilirsiniz. Konum Widget'larını kullanmak için Yerler SDK'sını bağımlılık olarak eklemeniz gerekir.

Tıklama etkinliklerini dinleme

Haritadaki tıklama etkinliklerini dinlemek için GoogleMap3D örneğinizde setMap3DClickListener yöntemini çağırın.

Kullanıcı haritayı tıkladığında onMap3DClick geri çağırma işlevi, aşağıdaki özellikleri içeren bir Map3DClickEvent nesnesi alır:

  • location: Tıklamanın coğrafi koordinatlarını ve rakımını temsil eden LatLngAltitude.
  • placeId: Tıklama konumundaki yerin benzersiz tanımlayıcısı (String?) veya yoksa null.

onMap3DClick yöntemi bir Boolean döndürür:

  • Return false: Varsayılan Places kullanıcı arayüzü widget'ını gösterir (placeId, null değilse).
  • Return true: Varsayılan Places kullanıcı arayüzü widget'ını gizler.

Aşağıdaki örnekte, tıklama dinleyicisinin nasıl ayarlanacağı ve özel bir işlem gerçekleştirmek için varsayılan Yerler kullanıcı arayüzü widget'ının nasıl gizleneceği gösterilmektedir:

googleMap3D.setMap3DClickListener { clickEvent ->
    val location = clickEvent.location
    val placeId = clickEvent.placeId

    // Perform custom action, for example logging or showing a custom tooltip
    showCustomTooltip(location, placeId)

    // Suppress the default Places UI widget by returning true
    true
}