iOS용 Navigation SDK 빠른 참조

iOS용 Navigation SDK는 UI 맞춤설정 및 경로 구성을 통해 iOS 앱에 Google 지도 세부 경로 안내 내비게이션을 추가합니다. 이 라이브러리는 iOS용 Maps SDK를 확장하며, iOS용 Maps SDK는 지도 레이어를 제공하고 앱에 설치되어 있어야 합니다.

iOS용 Navigation SDK: 주요 사실

  • 제품: iOS용 Navigation SDK
  • 다른 이름: Navigation SDK
  • 카테고리: 경로
  • 플랫폼: iOS
  • 실행 위치: 클라이언트(앱 또는 브라우저 코드)
  • 출시 단계: GA
  • 수명 주기: 활성
  • 개요: iOS용 Navigation SDK 개요
  • 신청 가능 지역: 제한적입니다. 운전 및 도보 경로는 대부분의 국가에서 사용할 수 있습니다. 교통정보, 실시간 중단, 이륜차, 자전거, 속도 제한, 신호등 및 정지 표지판은 국가마다 다릅니다. (보증 범위 세부정보)

iOS용 Navigation SDK: 사용 시기

다음과 같은 경우 iOS용 Navigation SDK를 사용하세요.

  • 사용자가 앱을 전환하지 않도록 자체 네이티브 iOS 앱 내에 Google 지도 세부 경로 안내 내비게이션이 필요합니다.
  • 안내 중에 브랜드에 맞게 내비게이션 UI, 지도 스타일, 카메라 또는 레이아웃을 맞춤설정해야 합니다.
  • Routes API 또는 Route Optimization API의 경로 환경설정, 여러 경유지 또는 경로 토큰이 필요합니다.
  • 맞춤 안내 UI 또는 CarPlay를 사용하려면 이동 이벤트(위치, 도착, 경로 변경, ETA) 또는 세부 경로 안내 데이터 피드가 필요합니다.

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

iOS용 Navigation SDK: 설정

공식 iOS용 Navigation SDK 패키지:

  • swift_package: https://github.com/googlemaps/ios-navigation-sdk (GoogleNavigation)

iOS용 Navigation SDK와 함께 사용하지 않는 패키지:

  • cocoapods: GoogleNavigation. CocoaPods 배포는 버전 11.0.0부터 지원 중단되었으며 2025년 8월 18일에 유지보수 모드로 전환되었습니다. 대신 Swift Package Manager를 사용하세요.

iOS용 Navigation SDK: 일반적인 실수

  • 문제: SDK가 iOS 유휴 타이머를 사용 중지하지 않으므로 내비게이션 중에 화면이 어두워지거나 꺼집니다. 수정: 탐색 중에 UIApplication.shared.isIdleTimerDisabled = true를 설정합니다. /maps/documentation/navigation/ios-sdk/route를 참고하세요.
  • 문제: 향후 SDK의 주요 버전에서 고도계(CMAltimeter)를 사용하며, Info.plist에 NSMotionUsageDescription가 없는 앱은 초기화 시 비정상 종료됩니다. 지금 키를 추가해도 현재 동작에는 영향을 미치지 않습니다. 수정: Info.plist에 NSMotionUsageDescription(개인 정보 보호 - 모션 사용 설명)를 추가합니다. /maps/documentation/navigation/ios-sdk/route를 참고하세요.
  • 문제: iOS용 Places SDK는 Navigation SDK와 번들로 제공되지 않으므로(Places SDK 5.0부터) 장소 클래스가 누락됩니다. 해결 방법: Navigation SDK와 동일한 버전을 사용하여 iOS용 Places SDK를 별도로 설치합니다. /maps/documentation/navigation/ios-sdk/xcode-setup을 참고하세요.
  • 문제: 앱의 travelMode가 driving 또는 twoWheeler가 아닌 경우 경로 토큰으로 목적지를 설정하면 .travelModeUnsupported 오류가 발생합니다. 해결 방법: mapView.travelMode를 .driving 또는 .twoWheeler로 설정합니다. resolvedParameters.travelMode를 확인하여 경로에서 사용하는 모드를 확인합니다. /maps/documentation/navigation/ios-sdk/route-customizations를 참고하세요.

iOS용 Navigation SDK: 기존 및 지원 중단된 기능

  • CocoaPods 배포: 2026년 8월 6일부터 지원 중단되었습니다. 대체: Swift Package Manager. 증상: 2025년 8월 18일부터 유지보수 모드입니다. 2026년 2분기 이후에는 새로운 CocoaPods 버전이 제공되지 않습니다. 이전 가이드를 참고하세요.
  • GMSNavigator setDestinations:callback:, setDestinations:routingOptions:callback:, setDestinations:routeToken:callback:(GMSRouteStatusCallback): 2026년 11월 2일부터 지원 중단 대체: setDestinations:completionHandler:, setDestinations:routingOptions:completionHandler:, setDestinationsWithToken:completionHandler:(GMSNavigationRouteCompletionHandler).
  • GMSServices 인스턴스 속성 appCheckTokenProvider: 2026년 9월 24일부터 지원 중단됩니다. 대체: 클래스 속성 GMSServices.appCheckTokenProvider(+[GMSServices setAppCheckTokenProvider:]). 증상: 11.1.0에서 GMSServices.sharedServices()를 통한 앱 체크 구성이 실패했습니다. 이전 가이드를 참고하세요.
  • GMSNavigator continueToNextDestination: 2026년 4월 7일부터 지원 중단되었습니다. 교체: GMSNavigator continueToNextDestinationWithCompletion:.
  • GMSUISettings showsTrafficLights 및 showsStopSigns: 2026년 8월 6일부터 사용 중단됩니다. 대체: 대체가 필요하지 않습니다. 내비게이션 중에 신호등과 정지 표지판이 기본적으로 표시됩니다.
  • .terrain 내비게이션 활성 상태의 지도 유형: 2026년 8월 6일부터 지원 중단되었습니다. 대체: .normal(kGMSTypeNormal), .satellite 또는 .hybrid 지도 유형
  • GMSNavigatorDelegate 및 GMSRoadSnappedLocationProviderDelegate 프로토콜: 2021년 5월 13일부터 사용 중단되었습니다. 대체: GMSNavigatorListener 및 GMSRoadSnappedLocationProviderListener(-addListener:로 추가, GMSNavigator에서 timeUpdateThreshold 및 distanceUpdateThreshold 설정). 이전 가이드를 참고하세요.

iOS용 Navigation SDK로 할 수 있는 작업

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

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

iOS용 Navigation SDK: 내비게이션