탐색 포인트 토큰을 사용하여 라우팅

유럽 경제 지역 (EEA) 개발자

탐색 지점 토큰을 사용하면 목적지에 관한 주요 컨텍스트 정보를 Android용 Navigation SDK, iOS용 Navigation SDK 또는 Routes API로 전송하여 경로 및 운전자 환경을 개선할 수 있습니다. 이 기능은 음식 배달이나 차량 공유와 같이 사용자 입력이 없으면 승차 또는 하차 지점이 모호할 수 있는 경우에 유용합니다.

경로 탐색 지점 토큰을 만들고 전달하려면 Geocoding API의 Destinations 메서드를 사용하여 사용자가 경로 탐색 지점 목록에서 원하는 위치를 선택할 수 있도록 합니다. 사용자의 선택은 Geocoding API의 Destinations 메서드에서 반환하는 탐색 지점이 됩니다.

그런 다음 목적지 좌표와 문맥 정보를 모두 포함하는 내비게이션 지점 토큰을 Android용 Navigation SDK, iOS용 Navigation SDK 또는 Routes API에 전달할 수 있습니다. 여기서 정확한 경로를 위한 경유지가 생성됩니다. 토큰이 연결된 장소를 기반으로 Navigation SDK에서 운전자에게 목적지를 강조 표시합니다.

예: 차량 공유 사용 사례

개요

이 예에서는 Geocoding API, Routes API, iOS 또는 Android용 Navigation SDK를 결합하여 경로 가격을 계산하고 운전자를 올바른 승차 지점으로 안내하는 차량 공유 앱을 만드는 방법을 보여줍니다.

대략적인 단계는 다음과 같습니다.

  1. Geocoding API를 통해 탐색 지점 토큰을 가져옵니다.
  2. Routes API를 사용하여 경로를 계산하고 경로 토큰으로 인코딩합니다.
  3. 내비게이션 지점 토큰과 경로 토큰을 모두 Navigation SDK에 전달합니다.
  4. Navigation SDK를 사용하여 운전자를 올바른 승차 지점으로 안내합니다.

관련 Routes API, iOS용 Navigation SDK, Android용 Navigation SDK 문서 링크는 추가 자료 섹션을 참고하세요.

이 다이어그램은 차량 공유 또는 배달 앱에서 Geocoding API, Routes API, iOS 또는 Android용 Navigation SDK를 사용하여 경로 토큰과 내비게이션 지점 토큰을 통해 운전자의 경로를 지정하는 방법을 보여줍니다.

공유 차량 또는 배송 사용 사례 다이어그램
차량 공유 또는 배송 사용 사례 다이어그램

공유 차량 예시

소비자가 차량을 예약하는 앱과 운전자가 차량 및 목적지까지의 경로 정보에 관한 알림을 받는 두 번째 앱이 있는 차량 공유 시나리오를 상상해 보세요.

이 이미지는 내비게이션 지점이 선택된 소비자 차량 공유 앱과 Android용 Navigation SDK를 사용하여 운전자를 정확하게 안내하는 운전자 앱의 예를 보여줍니다.

소비자 및 운전자 앱의 예

소비자가 소비자 앱을 열면 앱은 Geocoding API의 Destinations 메서드를 호출하고 소비자에게 잠재적인 탐색 지점을 선택할 수 있도록 제공합니다.

반납 지점을 선택하는 소비자

사용자는 SearchDestinations 요청의 응답 본문에 있는 navigationPoints 배열 중 하나인 원하는 지점을 선택합니다.

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

앱 백엔드는 내비게이션 지점 토큰을 Routes API에 제공하여 경로를 계산하고 경로 토큰을 가져옵니다.

마지막으로, 내비게이션 지점 토큰과 경로 토큰이 모두 iOS 또는 Android용 Navigation SDK를 사용하는 모바일 운전자 앱에 전달되어 운전자를 올바른 승차 지점으로 안내하는 경유지를 만듭니다.

추가 자료