Navigation SDK는 앱에 탐색 환경을 통합하는 다양한 방법을 제공합니다. 이 페이지에서는 Google 탐색 환경이 무엇인지, Navigation SDK에서 사용할 수 있는 다른 탐색 환경과 어떻게 다른지 설명합니다.
Google 탐색 환경이란 무엇인가요?
Google 내비게이션 환경은 Google 지도 앱 내의 내비게이션 환경과 유사한 Google 제공 UI 요소와 시각적 요소를 사용하는 단계별 내비게이션 환경을 삽입하기 위해 Navigation SDK를 사용하는 것을 의미합니다. Google 탐색 환경을 앱에 삽입하면 탐색 환경을 처음부터 빌드할 필요는 없지만 환경의 일부를 수정할 수는 있습니다. 또는 Google 탐색 환경에서 제공하는 것보다 더 많은 맞춤설정이 필요한 경우 탐색 SDK에서 턴바이턴 탐색 피드를 요청한 다음 자체 UI 요소를 제공하고 관리할 수 있습니다.
Google 탐색 환경을 사용하면 앱에서 Navigation SDK를 호출하여 다음 흐름을 사용하여 탐색을 시작, 실행, 중지합니다.
내비게이션을 시작합니다. 탐색을 시작하기 위해 앱은 탐색기 인스턴스를 만듭니다. 여기에서 탐색기의 대상을 설정하고 지도를 초기화합니다. 마지막으로 앱이 내비게이션 세부 경로 안내를 시작합니다. 이 앱 흐름은 사용 사례에 따라 다양한 방식으로 사용자에게 표시될 수 있습니다. 예를 들어 앱에 사용자가 매장으로의 탐색을 시작하는 데 사용할 수 있는 자체 UI 요소가 있는 매장 찾기가 있을 수 있습니다. 또는 운전자가 배송 작업을 수락하면 앱이 사전 정의된 목적지로 활성 탐색을 시작할 수 있습니다.
활성 탐색 앱이 활성 탐색에 들어가면 기기 위치를 사용하여 활성 안내를 유지합니다. 경로 변경, 목적지까지 남은 시간 등 사용 사례에 의미 있는 이벤트 리스너를 구성합니다. 내비게이션이 진행 중일 때 내비게이션 SDK는 Google 지도 앱의 UI 구성요소와 유사한 UI 구성요소를 제공합니다. 예를 들어 탐색 환경에는 세부 경로 안내 카드, 교통정보 레이어, 대체 경로, 속도 제한과 같은 시각적 요소가 포함된 표준 Google 지도 레이어가 표시됩니다.
내비게이션을 중지합니다. 앱은 사용자가 목적지에 도착할 때 트리거되는 도착 리스너와 같이 사용 사례에 가장 적합한 방식으로 내비게이션 세션을 종료합니다.
Google 탐색 환경을 어떻게 수정할 수 있나요?
일반적으로 Google 탐색 환경을 수정하여 다양한 색상 구성표, 카메라 뷰, 추가 회전 안내, 이벤트 응답 트리거를 사용할 수 있습니다. 다음 목록에서는 조정할 수 있는 몇 가지 사항을 설명합니다. 이 목록은 일부일 뿐 전체 목록이 아닙니다.
수정
세부정보
수정된 탐색 안내: 헤더, 색상 및 글꼴, 경로, 대체 경로, 이동 진행 상황 표시/숨기기
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-16(UTC)"],[[["\u003cp\u003eThe Google Navigation SDK enables developers to easily integrate turn-by-turn navigation into their apps using pre-built UI elements similar to the Google Maps app.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can customize aspects of the Google navigation experience like color schemes, camera views, and guidance information, but for full control, a custom navigation experience is recommended.\u003c/p\u003e\n"],["\u003cp\u003eThe Google navigation experience involves a three-step flow: starting navigation by defining the destination, active navigation with real-time guidance, and stopping navigation upon arrival.\u003c/p\u003e\n"],["\u003cp\u003eThe Navigation SDK offers various options for modifying the navigation UI, such as showing or hiding elements, adjusting traffic and speed limit information, and customizing the map and camera.\u003c/p\u003e\n"]]],[],null,["The Navigation SDK provides different ways to integrate a navigation\nexperience into your app. This page explains what the Google navigation\nexperience is and how it differs from other navigation experiences that are\navailable in the Navigation SDK.\n\nWhat is the Google navigation experience?\n\nThe Google navigation experience refers to using the Navigation SDK to\nembed a turn-by-turn navigation experience that uses Google-provided UI elements\nand visuals, which are similar to the navigation experience within the Google\nMaps apps. When you embed the Google navigation experience in your app, you\ndon't need to build the navigation experience from scratch, but you can still\nmodify parts of the experience. As an alternative, if you need more\ncustomization than is available with the Google navigation experience, you can\nrequest a turn-by-turn navigation feed from the Navigation SDK and then\nprovide and manage your own UI elements.\nFor more information, see [Custom navigation experience](/maps/documentation/navigation/android-sdk/intro-custom-nav).\n\n\u003cbr /\u003e\n\nWhen you use Google navigation experience, your app calls the\nNavigation SDK to start, run, and stop navigation, using the following\nflow:\n\n1. **Start navigation**. To start navigation, your app creates a navigator\n instance. From there, it sets the destination for the navigator and\n initializes a map. Finally, the app initiates the turn-by-turn guidance.\n This app flow can be presented to the user in a variety of ways depending on\n your use case. For example, the app might have a store locator with its own\n UI elements that users can use to begin navigation to the store. Or, your\n app might begin active navigation with a predefined destination when a\n driver accepts a delivery task.\n\n2. **Active navigation**. Once your app enters active navigation, it uses the\n device location to maintain active guidance. You configure event listeners\n that are meaningful to your use case, such as for route changes and\n remaining time to the destination. During active navigation, the Navigation\n SDK provides UI components, which are similar to those in the Google Maps\n apps. For example, the navigation experience shows a standard Google maps\n layer, with visuals like turn guidance cards, traffic layers, alternate\n routes, and speed limits.\n\n3. **Stop navigation**. Your app terminates the navigation session in the way\n that best works for your use case, such as with an arrival listener that\n triggers when the user reaches the destination.\n\nHow can you modify the Google navigation experience?\n\nIn general, you can modify the Google navigation experience to have different\ncolor schemes, camera views, extra turn guidance, and event response triggers.\nThe following list describes some of the adjustments you can make. This list is\nnot exhaustive.\n\n| **Modification** | **Details** |\n|--------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Modified navigation guidance: show/hide headers, colors and fonts, directions, alternate routes, and trip progress | [Map UI controls](/maps/documentation/navigation/android-sdk/controls) [Modify the navigation header](/maps/documentation/navigation/android-sdk/controls#modify_the_navigation_header) [Display directions list](/maps/documentation/navigation/android-sdk/controls#display_directions_list) [Hide alternate routes](/maps/documentation/navigation/android-sdk/controls#hiding_alternate_routes) [Display trip progress](/maps/documentation/navigation/android-sdk/controls#trip-progress-bar) |\n| Adjust traffic information and speed limit information | [Turn off traffic layer](/maps/documentation/navigation/android-sdk/controls#turn_off_the_traffic_layer) [Enable traffic lights and stop signs](/maps/documentation/navigation/android-sdk/controls#enable_traffic_lights_and_stop_signs) [Display the speedometer](/maps/documentation/navigation/android-sdk/controls#display_the_speed_limit) |\n| Change the map experience UI and adjust the camera. | [Add custom markers](/maps/documentation/navigation/android-sdk/controls#add_custom_markers) [Floating text](/maps/documentation/navigation/android-sdk/controls#floating_text) [Set night mode](/maps/documentation/navigation/android-sdk/controls#set_night_mode) [Adjust the camera](/maps/documentation/navigation/android-sdk/camera) |"]]
