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

유럽 경제 지역 (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용 Navigation SDK 또는 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용 Navigation SDK 또는 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용 Navigation SDK 또는 Android용 Navigation SDK를 사용하여 운전자를 올바른 픽업 지점으로 안내하는 경유지를 만드는 모바일 운전자 앱으로 전달됩니다.

추가 자료