iOS용 Maps SDK 빠른 참조

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: 설정

공식 iOS용 Maps SDK 패키지:

  • swift_package: https://github.com/googlemaps/ios-maps-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: 데이터 세트

iOS용 Maps SDK: 지오코딩

iOS용 Maps SDK: 지도

iOS용 Maps SDK: 지도 주석

iOS용 Maps SDK: 지도 스타일 지정

iOS용 Maps SDK: 스트리트 뷰