Ö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ı, bu ÖY için bir Konum widget'ı gösterir. Tıklama etkinliklerini dinleyebilir ve OnMap3DClickListener kullanarak bu widget'ı gizleyebilirsiniz. Konum widget'ı, Yerler SDK'sını bağımlılık olarak eklemenizi gerektirir.

Tıklama etkinliklerini dinleme

Haritadaki tıklama etkinliklerini dinlemek için GoogleMap3D örneğinizde setMap3DClickListener öğesini ç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 engelleneceğ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
}