관심 장소와 상호작용

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

참고: 기본적으로 관심 장소를 클릭하면 장소 UI 위젯이 표시됩니다. 애플리케이션에서 위젯을 숨기려면 이 동작을 재정의해야 합니다.

클릭 이벤트 수신 대기

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

사용자가 지도를 클릭하면 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
}