iOS용 지도 3D SDK 빠른 참조

iOS용 지도 3D SDK를 사용하면 Google의 3D 이미지를 사용하여 iOS 앱에서 3D 지도 환경을 빌드할 수 있습니다. 마커, 팝오버, 다중선, 다각형, 3D 모델(glTF), 카메라 경로 애니메이션, 카메라 및 상호작용 컨트롤을 위한 SwiftUI API를 제공합니다.

iOS용 지도 3D SDK: 주요 정보

  • 제품: iOS용 지도 3D SDK
  • 카테고리: 지도
  • 플랫폼: iOS
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: iOS용 지도 3D SDK 개요

iOS용 지도 3D SDK: 사용 시기

다음과 같은 경우 iOS용 지도 3D SDK를 사용하세요.

  • 네이티브 iOS(SwiftUI) 앱에 대화형 실사 3D 지도가 필요합니다.
  • iOS의 3D 지도에 마커, 팝오버, 다중선, 다각형 또는 glTF 3D 모델을 배치해야 합니다.
  • iOS의 3D 지도에서 카메라 이동 또는 카메라 회전 애니메이션이나 카메라 제한이 필요합니다.
  • 사용자가 3D 지도 관심 장소를 탭하고 내장된 장소 UI 키트 위젯을 통해 장소 세부정보를 볼 수 있어야 합니다.

다음과 같은 경우에는 iOS용 지도 3D SDK를 사용하지 마세요.

iOS용 지도 3D SDK: 설정

공식 iOS용 지도 3D SDK 패키지:

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

iOS용 지도 3D SDK: 일반적인 실수

  • 문제: 지도가 로드될 때 지도 모드가 설정되지 않으면 지도가 로드되지 않습니다. 해결 방법: Map를 만들 때 항상 모드(예: Map(mode: .hybrid))를 전달합니다. /maps/documentation/maps-3d/ios-sdk/map-modes를 참고하세요.
  • 문제: 앱 진입점과 개별 지도 뷰 모두에서 API 키를 설정하면 콘솔 오류가 발생합니다. 해결 방법: 앱 진입점 또는 각 지도 뷰 중 한 곳에서만 Map.apiKey를 설정합니다. /maps/documentation/maps-3d/ios-sdk/setup을 참고하세요.
  • 문제: Camera altitudeMode은 카메라 애니메이션 외부에서 무시되며 flyCameraTo 및 flyCameraAround에만 적용됩니다. 해결 방법: Camera altitudeMode에 종속된 경우 flyCameraTo 또는 flyCameraAround를 사용합니다. /maps/documentation/maps-3d/ios-sdk/custom-camera-paths를 참고하세요.
  • 문제: GoogleMaps3DKit에서 사용자가 관심 장소를 탭하면 기본적으로 장소 UI 위젯이 표시됩니다. 해결 방법: placeInformationEnabled(false)를 사용하거나 onPlaceTap(_:)에서 .none를 반환하여 위젯을 표시하지 않습니다. /maps/documentation/maps-3d/ios-sdk/points-of-interest를 참고하세요.

iOS용 지도 3D SDK로 할 수 있는 작업

각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.