Önemli yerlerle etkileşim kurma

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

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

Tıklama etkinliklerini dinleme

Haritada tıklama etkinliklerini dinlemek için setMap3DClickListener işlevini GoogleMap3D örneğinizde ç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 yüksekliğini 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:

  • Dönüş false: Varsayılan Yerler kullanıcı arayüzü widget'ını gösterir (placeId null değilse).
  • Return true: Varsayılan Yerler kullanıcı arayüzü widget'ını bastırır.

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
}