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를 사용하지 마세요.
- Android 앱을 빌드하는 경우 Android용 Navigation SDK를 대신 사용하세요.
- Flutter 또는 React Native 앱을 빌드하는 경우 대신 Flutter 및 React Native용 Google Navigation을 사용하세요.
- 인앱 안내 없이 서버의 경로, 예상 도착 시간 또는 거리만 필요합니다. 대신 Routes API를 사용하세요.
iOS용 Navigation SDK: 설정
- 사용 설정할 서비스:
navigationsdk.googleapis.com - 인증: API 키
- 사용 설정할 API: iOS용 Maps SDK
- 사용 기여 분석:
GMSServices.addInternalUsageAttributionID(_:)(+[GMSServices addInternalUsageAttributionID:])를 호출하여 이니셜라이저에 사용 기여 분석 ID를 추가합니다. 선택 해제하려면 호출을 삭제하거나 빈 문자열을 전달합니다. - 시작하기: iOS용 Navigation SDK 설정
- 참조: iOS용 Navigation SDK 참조
- 가격 책정: iOS용 Navigation SDK 사용량 및 결제
- 정책: 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: 관련 제품
- 함께 자주 사용되는 제품: iOS용 Maps SDK, Routes API, Route Optimization API, iOS용 Places SDK
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 버전이 제공되지 않습니다. 이전 가이드를 참고하세요.
GMSNavigatorsetDestinations: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()를 통한 앱 체크 구성이 실패했습니다. 이전 가이드를 참고하세요.GMSNavigatorcontinueToNextDestination: 2026년 4월 7일부터 지원 중단되었습니다. 교체:GMSNavigatorcontinueToNextDestinationWithCompletion:.GMSUISettingsshowsTrafficLights및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: 내비게이션
- 모바일 앱에 양방향 세부 경로 안내 내비게이션을 추가합니다.
- 세부 경로 안내 내비게이션의 목적지를 설정합니다.
- 세부 경로 안내 내비게이션을 시작합니다.
- 경로 요청에 이동 수단(운전, 도보, 오토바이, 택시)을 지정합니다.
- 세부 경로 안내 내비게이션의 경로 환경설정을 수정합니다.
- 세부 경로 안내 내비게이션의 도로변 및 기타 도착 환경설정을 지정합니다.
- 재사용 가능한 경로 토큰을 사용하여 세부 경로 안내 내비게이션의 재계획된 경로를 지정합니다.
- 세부 경로 안내 내비게이션 세션에서 사용자 도착 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 사용자 위치 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 시간 및 거리 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 경로 변경 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 야간 모드 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 세션에서 사용자 속도 업데이트를 반환합니다.
- 세부 경로 안내 내비게이션 중에 표시되는 UI 요소와 컨트롤을 맞춤설정합니다.
- 세부 경로 안내 내비게이션에 새 UI 요소를 추가합니다.
- 세부 경로 안내 내비게이션에 이동 진행률 표시기를 추가합니다.
- 세부 경로 안내 내비게이션 중에 표시되는 지도 지형지물을 맞춤설정합니다.
- 세부 경로 안내 내비게이션에 교통정보 레이어를 추가합니다.
- 세부 경로 안내 내비게이션의 카메라 뷰 및 동작을 수정합니다.
- 세부 경로 안내 내비게이션의 속도계 및 속도 제한 알림을 맞춤설정합니다.
- 경로를 따라 각 이동에 대한 일련의 메시지로 세부 경로 안내 내비게이션 피드를 반환합니다.
- 세부 경로 안내 내비게이션 피드에 사용할 맞춤 이동 아이콘을 지정합니다.
- iOS 앱에 CarPlay용 양방향 세부 경로 안내 내비게이션을 추가합니다. 프리뷰
- 사용자에게 경로상의 혼잡 상황을 알립니다.
- 사용자가 내비게이션을 시작하기 전에 경로를 따라 발생하는 중단을 볼 수 있도록 허용합니다.
- 사용자가 경로에서 발생한 중단 상황을 신고할 수 있도록 허용합니다.
- 사용자가 경로상의 중단을 확인할 수 있도록 허용합니다.
- 맞춤 경로 중단 신고 버튼을 추가합니다.