관심 장소와 상호작용

사용자가 관심 장소 (POI)를 클릭하면 Android용 지도 3D SDK에 해당 관심 장소의 장소 위젯이 표시됩니다. OnMap3DClickListener를 사용하여 클릭 이벤트를 수신 대기하고 이 위젯을 표시하지 않을 수 있습니다. 장소 위젯을 사용하려면 Places SDK를 종속 항목으로 추가해야 합니다.

클릭 이벤트 수신 대기

지도의 클릭 이벤트를 수신 대기하려면 GoogleMap3D 인스턴스에서 setMap3DClickListener를 호출합니다.

사용자가 지도를 클릭하면 onMap3DClick 콜백이 다음 속성을 포함하는 Map3DClickEvent 객체를 수신합니다.

• location: 클릭의 지리적 좌표와 고도를 나타내는 LatLngAltitude입니다.
• placeId: 클릭 위치에 있는 장소의 고유 식별자 (String?)입니다. 없으면 null입니다.

onMap3DClick 메서드는 Boolean를 반환합니다.

• Return false: 기본 장소 UI 위젯을 표시합니다 (placeId가 null가 아닌 경우).
• Return true 반환: 기본 장소 UI 위젯을 표시하지 않습니다.

다음 예에서는 클릭 리스너를 설정하고 기본 장소 UI 위젯을 표시하지 않고 맞춤 작업을 실행하는 방법을 보여줍니다.

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
}