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를 사용하지 마세요.
- Android 앱에 3D 지도가 필요합니다. 대신 Android용 지도 3D SDK를 사용하세요.
- 웹페이지에 3D 지도가 필요합니다. 대신 Maps JavaScript API를 사용하세요.
- iOS 앱에 표준 2D 지도가 필요합니다. 대신 iOS용 Maps SDK를 사용하세요.
iOS용 지도 3D SDK: 설정
- 사용 설정할 서비스:
mapsios.googleapis.com - 인증: API 키
- 시작하기: iOS용 지도 3D SDK 설정하기
- 참조: iOS용 지도 3D SDK 참조
- 가격 책정: iOS용 지도 3D SDK 사용량 및 결제
- 정책: 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: 관련 상품
- 함께 사용되는 경우가 많음: iOS용 Places SDK
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을 참고하세요. - 문제:
CameraaltitudeMode은 카메라 애니메이션 외부에서 무시되며flyCameraTo및flyCameraAround에만 적용됩니다. 해결 방법:CameraaltitudeMode에 종속된 경우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로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
- 웹페이지에 대화형 포토리얼리스틱 3D 지도를 추가합니다.
- 포토리얼리스틱 3D 지도에 마커를 추가합니다.
- 포토리얼리스틱 3D 지도에서 마커를 맞춤설정합니다.
- 포토리얼리스틱 3D 지도에 3D 모델을 추가합니다.
- 포토리얼리스틱 3D 지도에 3D 다중선을 추가합니다.
- 포토리얼리스틱 3D 지도에 3D 다각형을 추가합니다.
- 포토리얼리스틱 3D 지도에서 사용자 상호작용 및 이벤트에 응답합니다.
- 포토리얼리스틱 3D 지도에 표시되는 컨트롤을 맞춤설정합니다.
- 실사 수준의 3D 지도에서 카메라 경로와 애니메이션을 제어합니다.
- 포토리얼리스틱 3D 지도에서 카메라 제한을 제어합니다.