Routes API가 경로를 계산할 때 경유지를 가져와서 사용자가 입력으로 제공하는 구성 매개변수를 선택할 수 있습니다 그러면 API가 응답을 반환합니다. 기본 경로 및 하나 이상의 대체 경로가 포함된 경로
응답에는 다음과 같은 필드가 포함됩니다.
응답에 이를 포함하기 위해 | 이 문서 보기 |
---|---|
차량 엔진 유형에 따른 연비 또는 에너지 효율이 가장 우수한 경로입니다. | 친환경 경로 구성하기 |
대체 경로 최대 3개 | 대체 경로 요청 |
전체 경로, 경로의 각 구간 및 각 단계에 대한 폴리라인 볼 수 있습니다 | 경로 다중선 요청 |
통행료 할인을 고려한 예상 통행료 또는 패스를 사용할 수 없습니다. | 통행료 계산 |
언어 코드 및 측정 단위 (영국식 또는 측정항목). | 현지화된 값 요청 |
탐색 안내 형식을 HTML 텍스트 문자열로 지정하려면 HTML_FORMATTED_NAVIGATION_INSTRUCTIONS 를
extraComputations 입니다. |
추가 계산 |
입력 옵션의 전체 목록은 사용 가능한 경로 옵션을 참조하세요. 및 요청 본문.
이 응답을 사용하여 고객에게 정보를 제공할 수 있습니다. 필요에 따라 적절한 경로를 선택하는 데 도움이 됩니다.
필드 마스크에 관한 정보
메서드를 호출하여 경로를 계산할 때 필드를 지정해야 합니다. 마스크는 응답에서 반환되기를 원하는 필드를 정의합니다. 없음 반환된 필드의 기본 목록입니다. 이 목록을 생략하면 메서드가 오류가 발생했습니다.
이 문서의 예에서는 전체 응답 객체를 필드 마스크를 고려해야 합니다 프로덕션 환경에서 응답은 필드 마스크에 명시적으로 지정한 필드만 포함합니다.
자세한 내용은 반환할 정보 선택하기를 참고하세요.
저작권 표시 정보
사용자에게 결과를 표시할 때 다음 저작권 고지를 포함해야 합니다.
Powered by Google, ©YEAR Google
예를 들면 다음과 같습니다.
Powered by Google, ©2023 Google
경로, 구간, 걸음 수 정보
Routes API에서 반환한 응답을 보기 전에 경로를 구성하는 구성 요소를 이해해야 합니다.
응답에는 다음 각 경로 구성요소에 대한 정보가 포함될 수 있습니다.
경로: 출발지 경유지에서 다음 지점까지 전체 여정 중간 경유지에서 도착 경유지로 이동하는 것입니다. 경로는 이상의 구간.
구간: 경로의 한 경유지에서 다음 경유지까지의 경로입니다. 있습니다. 각 구간은 하나 이상의 개별 걸음 수로 구성됩니다.
경로에는 각 경유지에서 다음 경유지까지의 경로에 대한 개별 구간이 포함됩니다. 예를 들어 경로에 하나의 출발지 경유지와 하나의 경유지가 포함된 경우 목적지가 있다면 경로에 단일 구간이 포함됩니다. 각 출발지와 목적지 다음 경로에 추가하는 경유지 중간 경유지라고 부르면 API에서 별도의 구간을 추가합니다.
API는 통과 중간 경유지에 구간을 추가하지 않습니다. 대상 예: 출발지 경유지, 통과 경로 도착지 경유지에 출발지에서 출발하는 한 구간만 경유지를 통과하는 동안 목적지로 이동하는 것입니다. 자세한 내용은 통과 경유지에 대한 자세한 내용은 통과 경유지 정의
단계: 경로의 구간에 따른 단일 안내입니다. 한 단계가 경로의 원자 단위입니다. 예를 들어 단계에 '기본 설정에서 왼쪽으로 켜 줘'라고 표시할 수 있습니다. Street'').
응답 내용
JSON 객체 에는 다음과 같은 최상위 속성이 포함되어 있음을 나타냅니다.
routes
: 다음 유형의 요소의 배열 경로.routes
배열에는 API에서 반환한 경로마다 요소 한 개가 포함됩니다. 배열은 최대 다섯 개의 요소를 포함할 수 있습니다. 기본 경로, 최대 3개의 대체 경로 중에서 선택할 수 있습니다.geocodingResults
: 다음 유형의 요소의 배열 GeocodingResults. 요청의 모든 위치 (출발지, 목적지 또는 중간) 경유지)로서 주소 문자열 또는 플러스 코드로 지정한 경우 API가 장소 ID 조회를 수행합니다. 이 배열의 각 요소에는 장소 ID를 반환합니다. 요청의 위치는 다음과 같이 지정됩니다. 장소 ID 또는 위도/경도 좌표는 포함되지 않습니다. 장소 ID 또는 위도와 경도를 사용하여 모든 위치를 지정한 경우 좌표의 경우 이 배열은 제공되지 않습니다.fallbackInfo
, 유형 FallbackInfo. API가 모든 입력 속성에서 경로를 계산할 수 없는 경우 다른 계산 방법을 사용하는 것으로 대체할 수 있습니다 대체 시 사용되는 경우 이 필드에는 있습니다. 그렇지 않으면 이 필드가 설정되지 않습니다.
응답의 형식은 다음과 같습니다.
{ // The routes array. "routes": [ { object (Route) } ], // The place ID lookup results. "geocodingResults": [ { object (GeocodedWaypoint) } ], // The fallback property. "fallbackInfo": { object (FallbackInfo) } }
경로 배열 해독
응답에는 routes
배열이 포함되며, 여기서 각 배열 요소는 다음 유형입니다.
경로.
각 배열 요소는 출발지에서 목적지까지의 전체 경로를 나타냅니다. 이
API가 항상 기본 경로라고 하는 경로를 하나 이상 반환합니다.
추가 경로를 요청할 수 있습니다. 만약
친환경 경로인 경우 배열에 다음 두 요소를 포함할 수 있습니다.
기본 경로와 친환경 경로일 수 있습니다. 또는 computeAlternativeRoutes
를 다음으로 설정
요청에 true
를 포함하여 응답에 최대 3개의 대체 경로를 추가합니다.
배열의 각 경로는 routeLabels
배열 속성으로 식별됩니다.
값 | 설명 |
---|---|
DEFAULT_ROUTE |
기본 경로를 식별합니다. |
FUEL_EFFICIENT |
친환경 경로를 식별합니다. |
DEFAULT_ROUTE_ALTERNATE |
대체 경로를 발급합니다. |
legs
배열에는 경로의 각 구간에 대한 정의가 포함됩니다. 나머지
속성(예: distanceMeters
, duration
, polyline,
)에는
경로 전체에 대한 정보입니다.
{ "routeLabels": [ enum (RouteLabel) ], "legs": [ { object (RouteLeg) } ], "distanceMeters": integer, "duration": string, "routeLabels": [string], "staticDuration": string, "polyline": { object (Polyline) }, "description": string, "warnings": [ string ], "viewport": { object (Viewport) }, "travelAdvisory": { object (RouteTravelAdvisory) } "routeToken": string }
현재 운전 상황 및 기타 요인으로 인해 기본 경로와
친환경 경로도 동일할 수 있습니다. 이 경우 routeLabels
배열은
DEFAULT_ROUTE
및 FUEL_EFFICIENT
라벨이 모두 포함됩니다.
{ "routes": [ { "routeLabels": [ "DEFAULT_ROUTE", "FUEL_EFFICIENT" ], … } ] }
legs 배열 이해
응답의 각 route
에는 legs
배열이 포함됩니다. 여기서 각 legs
배열은
요소의 유형이 다음과 같음
RouteLeg).
배열의 각 구간은 한 경유지에서 다음 경유지까지의 경로를 정의합니다.
살펴봤습니다 경로에는 항상 하나 이상의 구간이 포함됩니다.
legs
속성에는
steps
배열 나머지 속성(예: distanceMeters
, duration
)은
및 polyline
에는 구간에 관한 정보가 포함됩니다.
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object (Polyline) }, "startLocation": { object (Location) }, "endLocation": { object (Location) }, "steps": [ { object (RouteLegStep) } ], "travelAdvisory": { object (RouteLegTravelAdvisory) } }
단계 배열 이해하기
응답의 각 구간에는 steps
배열이 포함됩니다. 여기서 각 steps
배열은
요소의 유형이 다음과 같음
RouteLegStep으로 설정합니다.
단계는 구간에 있는 단일 명령어에 해당합니다. 다리는 항상
최소 한 단계여야 합니다
steps
배열의 각 요소에는 navigationInstruction
가 포함됩니다.
속성, 유형
NavigationInstruction,
여기에는 단계 지침이 포함되어 있습니다. 예를 들면 다음과 같습니다.
"navigationInstruction": { "maneuver": "TURN_LEFT", "instructions": "Turn left toward Frontage Rd" }
instructions
에는 단계에 대한 추가 정보가 포함될 수 있습니다. 예를 들면 다음과 같습니다.
"navigationInstruction": { "maneuver": "TURN_SLIGHT_LEFT", "instructions": "Slight left (signs for I-90 W/Worcester)nParts of this road may be closed at certain times or days" }
단계의 나머지 속성은 단계에 대한 정보를 설명합니다.
distanceMeters
, duration
, polyline
형식으로 반환합니다.
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object (Polyline) }, "startLocation": { object (Location) }, "endLocation": { object (Location) }, "navigationInstruction": { object (NavigationInstruction) } }
단계 안내의 언어 지정
API는 원하는 경우 기본 설정을 관찰하면서 사용자가 읽을 수 있는 스크립트 있습니다. 주소 구성요소는 모두 동일한 언어로 반환됩니다.
languageCode
매개변수를 사용합니다. 요청 지원되는 언어 목록에서 경로 언어를 명시적으로 설정 언어를 참고하세요. Google은 지원되는 이 목록은 완전하지 않을 수 있습니다.지정된 언어로 이름을 사용할 수 없는 경우 API는 가장 근접한 값을 찾습니다.
지정된 언어는 API는 반환과 반환 순서를 선택합니다. 이 지오코더는 다음과 같이 언어에 따라 약어를 다르게 해석합니다. 거리 유형의 약어 또는 한 형식에서 유효할 수 있는 동의어를 다른 언어로는 볼 수 없습니다. 예를 들어 utca와 tér는 헝가리어로 된 길에 있습니다.
GeocodingResults 배열 이해
요청의 모든 위치 (출발지, 목적지 또는 중간)
경유지)가 주소 문자열 또는 플러스 코드로 지정된 경우
API는 해당하는 장소가 있는 가장 관련성 높은 위치를 찾으려고 시도합니다.
있습니다. 이
geocodingResults
드림
배열에 placeID
필드가 포함됨
장소 ID로 위치를 포함하며 위치를 지정하는 type
필드
유형(예: street_address
, premise
, airport
)
geocodingResults
배열에는 3개의 필드가 있습니다.
origin
: 주소 문자열 또는 플러스 코드로 지정된 경우 출발지의 장소 ID입니다. 그렇지 않으면 이 필드는 응답에서 생략됩니다.destination
: 주소 문자열 또는 플러스 코드로 지정된 경우 목적지의 장소 ID입니다. 그렇지 않으면 이 필드가 있습니다.intermediates
: 중간 위치의 장소 ID가 포함된 배열 주소 문자열 또는 플러스 코드로 지정된 경유지. 만약 장소 ID 또는 위도를 사용하여 중간 경유지 및 경도 좌표의 경우 응답에서 생략됩니다. 사용intermediateWaypointRequestIndex
속성을 사용하여 요청의 장소 ID에 해당하는 중간 경유지 확인할 수 있습니다.
"geocodingResults": { "origin": { "geocoderStatus": {}, "type": [ enum (Type) ], "placeId": string }, "destination": { "geocoderStatus": {}, "type": [ enum (Type) ], "placeId": string }, "intermediates": [ { "geocoderStatus": {}, "intermediateWaypointRequestIndex": integer, "type": [ enum (Type) ], "placeId": string }, { "geocoderStatus": {}, "intermediateWaypointRequestIndex": integer, "type": [ enum (Type) ], "placeId": string } ] }
현지화된 응답 값 이해
현지화된 응답 값은 반환된 매개변수 값의 현지화된 텍스트입니다. 현지화된 텍스트는 이동 시간, 거리, 단위 체계 (미터법 또는 야드파운드법)입니다. 요청 사항 현지화된 값을 사용할 수 있으며, 언어 및 언어 또는 단위 체계를 사용하거나 API에서 추론한 값을 사용할 수 있습니다. 자세한 내용은 LocalizedValues
예를 들어 독일어 (de) 및 야드파운드법 언어 코드를 지정하는 경우
distanceMeters
의 값이 49889.7이 됩니다.
또한 독일어 및 독일어로 된 거리 측정을 제공하는 현지화된 텍스트도
"31 Meile"입니다.
다음은 현지화된 값에 대해 표시되는 예입니다.
{ "localized_values": { "distance": { "text": "31,0 Meile/n" }, "duration": { "text": 38 Minuten}. "static_duration": { "text": 36 Minuten}. } }
언어나 단위 체계를 지정하지 않으면 API에서 언어를 유추합니다. 단위를 다음과 같이 지정합니다.
ComputeRoutes
메서드는 위치와 거리를 추론합니다. 단위(단위: 초)를 정합니다. 따라서 미국에서 라우팅 요청의 경우 API는en-US
언어와IMPERIAL
단위를 추론합니다.ComputeRouteMatrix
메서드의 기본값은 'en-US'입니다. 언어 및 METRIC 단위가 포함됩니다.