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

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

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

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

소비자 및 운전자 앱의 예

탐색 지점 토큰을 만들고 전달하려면 Geocoding API의 대상 엔드포인트를 사용하여 사용자가 탐색 지점 목록에서 선호하는 위치를 선택할 수 있도록 합니다. 사용자의 선택은 Geocoding API의 Destinations 엔드포인트에서 반환되는 탐색 지점이 됩니다. 그런 다음 대상 좌표와 컨텍스트 정보를 모두 포함하는 탐색 지점 토큰을 Android용 Navigation SDK에 전달하면 정확한 경로를 위한 경유지가 생성됩니다. 토큰이 연결된 장소를 기반으로 탐색 SDK에서 운전자를 위해 목적지가 강조 표시됩니다.

탐색 포인트 토큰이 생성되어 라우팅을 위해 Nav 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
      }
      }
    }
]

응답의 탐색 지점 토큰은 Android용 Navigation SDK를 사용하여 운전자를 올바른 픽업 지점으로 안내하는 Waypoint를 만드는 모바일 운전자 앱에 전달됩니다.