경로를 통과할 지점 설정

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

기본적으로 중간 경유지는 픽업 및 하차를 위해 정차하는 데 사용되지만 중간 경유지를 통과만 하도록 지정할 수도 있습니다.

출발지 경유지, 통과 중간 경유지, 목적지 경유지가 포함된 경로에는 중간(via라고 함) 경유지를 통과하면서 출발지와 목적지를 연결하는 경로 구간이 하나만 포함됩니다.

Waypoint 인터페이스를 사용하여 웨이포인트의 via 속성을 true로 설정하여 중간 웨이포인트를 통과 웨이포인트로 구성합니다.

via 속성은 사용자가 지도에서 경유지를 드래그하는 것에 대한 응답으로 경로를 만들 때 가장 효과적입니다. 이렇게 하면 사용자가 최종 경로가 실시간으로 어떻게 표시되는지 확인할 수 있으며, 경유지가 Routes 라이브러리에서 액세스할 수 있는 위치에 배치되도록 할 수 있습니다.

요청 예시

다음 예시 요청은 중간 경유지를 통과 경유지로 표시하는 방법을 보여줍니다.

const routeRequestWithVia = {
  origin: '100 Moffett Blvd, Mountain View, CA 94043',
  destination: '1199 9th Ave, San Francisco, CA 94122',
  travelMode: 'DRIVING',
  intermediates: [
    {location: 'Half Moon Bay, CA', via: true} // Set the via property to true
  ],
  fields: ['path', 'legs'],
};

// Make the request.
const {routes, fallbackInfo, geocodingResults} = await Route.computeRoutes(routeRequestWithIntermediates);

중간 경유지의 장소 ID에 액세스

출발지, 목적지 또는 중간 경유지의 위치를 주소 문자열 또는 플러스 코드로 지정하면 Routes 라이브러리는 해당 장소 ID가 있는 가장 관련성 높은 위치를 찾으려고 시도합니다. 결과의 geocodingResults.intermediates 배열에는 경유지 위치에 해당하는 장소 ID와 해당 위치에 대한 추가 데이터가 포함되어 있습니다.

지오코딩 결과 응답 예시

{
  "origin": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJb5NgcTa3j4ARrfF4Oc_f6q8",
    "intermediateWaypointRequestIndex": null
  },
  "destination": {
    "geocoderStatus": "OK",
    "types": [
      "premise",
      "street_address"
    ],
    "partialMatch": false,
    "placeId": "ChIJAbIPLl2HhYARQ0SSdDFxU-s",
    "intermediateWaypointRequestIndex": null
  },
  "intermediates": [
    {
      "geocoderStatus": "OK",
      "types": [
        "locality",
        "political"
      ],
      "partialMatch": false,
      "placeId": "ChIJC8sZCqULj4ARVJvnNcic_V4",
      "intermediateWaypointRequestIndex": 0
    }
  ]
}