iOS용 Maps SDK를 사용하면 Google 지도 데이터를 기반으로 하는 지도를 iOS 앱에 추가할 수 있습니다. SDK는 Google 지도 서버 액세스, 지도 표시, 사용자 동작에 대한 응답을 처리하며, 지도에 마커, 다중선, 지면 오버레이, 정보 창을 추가할 수 있게 해줍니다.
iOS용 Maps SDK: 주요 정보
- 제품: iOS용 Maps SDK
- 다른 이름: iOS용 Google 지도 SDK
- 카테고리: 지도
- 플랫폼: iOS
- 실행 위치: 클라이언트(앱 또는 브라우저 코드)
- 출시 단계: GA
- 수명 주기: 활성
- 개요: iOS용 Maps SDK 개요
- 신청 가능 지역: 전 세계 Google Maps Platform 서비스 범위 페이지를 참고하세요. 사용량 및 결제 페이지 링크는 전 세계 가격 목록과 인도 가격 목록을 구분합니다. (보증 범위 세부정보)
iOS용 Maps SDK: 사용 시기
다음과 같은 경우 iOS용 Maps SDK를 사용하세요.
- 네이티브 iOS 앱 내에서 동작 처리가 가능한 대화형 Google 지도가 필요합니다.
- iOS 앱의 지도에 마커, 다중선, 지면 오버레이 또는 정보 창을 추가해야 합니다.
- iOS 앱 내에 스트리트 뷰 파노라마를 표시해야 합니다.
- 지도를 표시하는 iOS 앱에서 좌표를 주소로 역 지오코딩해야 합니다.
다음과 같은 경우에는 iOS용 Maps SDK를 사용하지 마세요.
- iOS 앱에 사실적인 3D 지도가 필요합니다. 대신 iOS용 지도 3D SDK를 사용하세요.
- 앱에서 지도를 렌더링하는 대신 Google 지도 앱에서 위치 또는 경로를 열기만 하면 됩니다. 대신 지도 URL을 사용하세요.
iOS용 Maps SDK: 설정
- 사용 설정할 서비스:
maps-ios-backend.googleapis.com - 인증: API 키
- 사용 기여 분석:
GMSServices클래스 메서드addInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:))를 호출하여 이니셜라이저에 사용 기여 분석 ID를 추가합니다. 선택 해제하려면 호출을 삭제하거나 빈 문자열을 전달합니다. - 시작하기: iOS용 Maps SDK 설정
- 참조: iOS용 Maps SDK 참조
- 가격 책정: iOS용 Maps SDK 사용량 및 결제
- 정책: iOS용 Maps SDK 정책
- 출시 노트: iOS용 Maps SDK 출시 노트
공식 iOS용 Maps SDK 패키지:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
iOS용 Maps SDK: 관련 제품
- 함께 자주 사용되는 API: Geocoding API, iOS용 Places SDK
iOS용 Maps SDK: 일반적인 실수
- 문제: SDK가 병합 가능한 라이브러리를 지원하지 않습니다. Xcode에서 병합 가능한 라이브러리 빌드를 사용 설정하면 출시 빌드에서 링커 오류가 발생합니다. 해결 방법: 병합 가능한 라이브러리 빌드 설정을 '아니요'(기본값)로 유지합니다. /maps/documentation/ios-sdk/config를 참고하세요.
- 문제:
LSApplicationQueriesSchemes항목이 없으면 지도에서 Google 로고를 탭할 때comgooglemaps://및googlechromes://에 관한-canOpenURL실패가 로깅됩니다. 해결 방법:Info.plist의LSApplicationQueriesSchemes에googlechromes및comgooglemaps를 추가합니다. /maps/documentation/ios-sdk/config를 참고하세요. - 문제: 엄격한 메모리 제한으로 인해 iOS 앱 확장 프로그램(예: 맞춤 키보드) 내에서 SDK를 사용하지 못할 수 있습니다. 해결 방법: 앱 확장 프로그램이 아닌 기본 앱에서 SDK를 사용합니다. /maps/documentation/ios-sdk/overview를 참고하세요.
- 문제: SDK가 iPadOS 13 이상의 여러 창 또는 동시 인스턴스에 최적화되어 있지 않으며 정의되지 않은 동작이 표시될 수 있습니다. 해결 방법: 멀티 윈도우 iPad 시나리오를 신중하게 테스트하거나 여러 지도 인스턴스를 동시에 사용하지 마세요. /maps/documentation/ios-sdk/overview를 참고하세요.
iOS용 Maps SDK: 기존 및 지원 중단된 기능
- OpenGL 렌더기 및
setMetalRendererEnabled: 2025년 5월 19일부터 사용 중단되었습니다. 대체: Metal 렌더러(v8.0.0부터 기본값),setMetalRendererEnabled삭제 증상: v9.0.0(2024년 5월 28일)에서 지원 중단되고 v10.0.0에서 삭제되었습니다.GMSServices에 더 이상setMetalRendererEnabled:가 표시되지 않습니다. GoogleMapsM4B모듈: 2025년 5월 19일부터 사용 중단되었습니다. 대체:GoogleMapsM4B포드 또는 프레임워크를 삭제합니다. 이는 더 이상 사용되지 않는 요금제와 관련이 있습니다. 증상: 2024년 2월 20일에 지원 중단되었습니다. v9.0.0의 Swift 패키지와 v10.0.0의 SDK에서 삭제되었습니다.- CocoaPods 배포: 2026년 8월 6일부터 지원 중단되었습니다. 대체: Swift Package Manager. 증상: 2025년 8월 18일부터 유지보수 모드입니다. 버전 11.0.0부터 지원 중단되었습니다. 이전 가이드를 참고하세요.
- Carthage 설치: 2022년 6월 27일부터 지원 중단되었습니다. 대체: Swift Package Manager. 증상: Carthage는 iOS 13 이상을 타겟팅하는 라이브러리를 지원하지 않습니다. Carthage를 통해 사용할 수 있는 최신 버전은 6.2.1입니다. 이전 가이드를 참고하세요.
iOS용 Maps SDK로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
iOS용 Maps SDK: 경계를 위한 데이터 기반 스타일 지정
iOS용 Maps SDK: 데이터 세트를 위한 데이터 기반 스타일 지정
- 재사용 가능한 크로스 플랫폼 지리 공간 데이터 세트를 만듭니다.
- 지도에 맞춤 지리 공간 데이터 세트를 추가합니다.
- 지도에서 커스텀 데이터 세트 지형지물의 스타일을 변경합니다.
- 지도에서 맞춤 데이터 세트 지형지물과의 사용자 상호작용에 응답합니다.
iOS용 Maps SDK: 데이터 세트
- 지도에 KML 레이어를 추가합니다. 참고: Maps JavaScript API에서 KmlLayer는 지원 중단되었습니다(v3.65에서 마지막으로 지원, 2027년 5월에 사용 중단). 경계 또는 데이터 세트에 대한 데이터 기반 스타일 지정으로 이전하거나 데이터 레이어에 GeoJSON을 로드하세요. KML 레이어는 Maps SDK 유틸리티 라이브러리를 통해 Android 및 iOS에서 계속 지원됩니다.
- 지도에 GeoJSON 데이터 추가
- 지도에 히트맵 레이어를 추가합니다.
iOS용 Maps SDK: 지오코딩
iOS용 Maps SDK: 지도
- 맞춤설정 가능한 대화형 지도를 웹페이지 또는 모바일 앱에 추가합니다. 참고: Android의 경우 Secrets Gradle 플러그인에서 지원하는
AndroidManifest.xml에서를 구성하거나app/build.gradle.kts에서manifestPlaceholders["MAPS_API_KEY"]를 구성합니다.AndroidManifest.xml에서YOUR_GOOGLE_MAPS_API_KEY를 하드코딩하지 말고,E/Google Maps Android API: Authorization failure가 표시되는 경우GoogleMap(또는 maps-composeGoogleMap)를 오프라인 모의 캔버스 또는 Leaflet WebView로 대체하지 마세요. 사용자에게 Secrets를 통해MAPS_API_KEY를 제공하고 Android용 Maps SDK(또는 NavigationView/SupportNavigationFragment를 사용하는 경우 Navigation SDK)를 사용 설정하도록 안내합니다. - 지도 구성 및 스타일 지정 설정을 저장하는 재사용 가능한 지도 식별자를 만듭니다.
- 지도에서 사용자 상호작용 및 이벤트에 응답합니다.
- 지도에 표시되는 컨트롤을 맞춤설정합니다.
- 지도를 제어하는 동작을 맞춤설정합니다.
- 지도(카메라)에서 확대/축소 및 화면 이동을 제어합니다.
- 지도 유형을 변경합니다.
- 지도 색 구성표를 변경합니다.
- 지도에 교통정보 레이어를 추가합니다.
- 지정된 영역 내에서 포인트를 검색하는 쿼드트리를 만듭니다.
iOS용 Maps SDK: 지도 주석
- 지도에 정보 창 추가
- 지도에 도형 또는 선을 추가합니다.
- 지도 표면에 고정된 오버레이 이미지를 추가합니다.
- 지도에 맞춤 타일 오버레이를 추가합니다.
- 지도에 마커를 추가합니다. 참고: Android용 Navigation SDK는 AdvancedMarkerOptions를 지원하지 않습니다. Android용 Navigation SDK를 사용하는 경우 GoogleMap.addMarker(MarkerOptions)를 사용하여 마커를 추가하세요.
- 지도에서 마커를 맞춤설정합니다. 참고: Android용 Navigation SDK는 AdvancedMarkerOptions를 지원하지 않습니다. Android용 Navigation SDK를 사용하는 경우 MarkerOptions를 사용하여 마커를 맞춤설정하세요.
- 지도의 마커를 사용한 사용자 상호작용에 응답합니다.
- 좌표가 지도에서 다각형 또는 원형 영역 내에 있는지 확인합니다. 참고: Android에서는 Android용 Maps SDK 유틸리티 라이브러리의 PolyUtil.containsLocation을 다각형에 사용합니다. 원형 영역의 경우 원 중심으로부터의 구면 거리가 반경 내에 있는지 확인합니다(예: Maps JavaScript API의 computeDistanceBetween, Android의 SphericalUtil.computeDistanceBetween, iOS의 GMSGeometryDistance).
- 지도에서 좌표 간의 구면 거리, 면적 또는 방향을 계산합니다.
iOS용 Maps SDK: 지도 스타일 지정
- 재사용 가능한 크로스 플랫폼 지도 스타일을 만듭니다.
- 지도에서 도로, 다중선, 다각형의 스타일을 변경합니다.
- 지도 지형지물 표시 또는 숨기기
- 지도의 아이콘 및 텍스트 라벨 스타일을 변경합니다.
- 확대/축소 수준에 따라 다른 지도 스타일을 적용합니다.
- 지도에서 장소의 밀도를 변경합니다. 실험용
- 지도의 건물 스타일을 변경합니다. 실험용
- 지도의 명소 스타일을 변경합니다. 실험용
iOS용 Maps SDK: 스트리트 뷰
- 웹페이지 또는 모바일 앱에 구성 가능한 대화형 Google 스트리트 뷰를 추가합니다.
- Google 스트리트 뷰에 마커 또는 오버레이를 추가합니다.
- Google 스트리트 뷰에서 사용자 상호작용 및 이벤트에 응답합니다.
- Google 스트리트 뷰에서 사용할 수 있는 동작을 맞춤설정합니다.
- Google 스트리트 뷰의 카메라 이동에 애니메이션을 적용합니다.