Routes API를 사용하는 이유
Routes API를 사용하면 교통 세부정보, 최신 교통정보 및 도로 상황, 경로 환경설정을 사용하여 정확한 경로 및 이동 정보를 얻을 수 있습니다.
다양한 운송 수단의 유형 및 기능
차량이 이동하는 방향
승차 또는 하차 위치가 있는 도로 측면
교통상황 및 도로 폐쇄
위험한 지역을 피하거나 안전 픽업 지역을 제공하는 등의 안전 문제
시간 및 거리와 연비와 같은 통행 요금 및 이동 메타데이터와 같은 선택적 기능을 사용하여 경로 요건 전반에서 지연 시간, 품질, 비용의 균형을 맞춥니다.
다음과 같이 전달 일정을 위한 가장 효율적인 경로를 확인할 수도 있습니다.
일련의 패키지를 픽업할 작업자 집합을 할당하는 가장 좋은 방법
최종 목적지로 패키지를 발송할 최적의 창고를 결정합니다.
Routes API로 무엇을 할 수 있나요?
Routes API를 사용하면 경로 정보의 두 가지 기본 카테고리를 가져올 수 있습니다.
한 위치에서 단일 대상 또는 여러 대상으로의 경로
여러 출발지와 도착지 사이에서 가능한 경로의 행렬입니다.
단일 또는 여러 대상의 경로 가져오기
Routes API Compute Routes 메서드를 사용하면 위치 간 계산을 수행할 수 있습니다.
단일 목적지 또는 여러 목적지에 대한 다양한 이동 방법에 대한 경로 찾기:
대중교통, 운전, 오토바이, 도보, 자전거를 포함한 이동 모드.
경유지로 이동하는 가장 효율적인 순서로 최적화할 수 있는 일련의 경유지.
출발지, 목적지, 경유지를 지정하는 다양한 방법:
텍스트 문자열. 예: 'Chicago, IL', 'Darwin, NT, Australia', '1800 Amphitheatre Parkway, Mountain View, CA 94043' 또는 'CWF6+FWX Mountain View, California'
장소 ID
위도 및 경도 좌표(선택사항으로 차량 방향 포함)
필요와 목표에 따라 경로 옵션을 세부적으로 조정합니다.
차량 엔진 유형에 맞는 연비 또는 에너지 효율 경로(디젤, 전기, 하이브리드, 휘발유)를 선택합니다. 자세한 내용은 친환경 경로 찾기를 참고하세요.
트래픽 계산에 세분화된 옵션을 설정하여 품질과 지연 시간의 절충 여부를 결정할 수 있습니다. 자세한 내용은 교통정보 데이터 포함 방법 및 포함 여부 지정을 참고하세요.
도착예정시간 정확도를 높이기 위해 경유지의 차량 방향 (이동 방향) 및 도로 측면 정보를 설정합니다. 자세한 내용은 차량 방향 및 도로 측면 지정을 참고하세요.
패스스루 및 터미널 위치 및 안전한 중간 기착 위치를 지정합니다. 자세한 내용은 경로를 따라 경유지 설정 및 경로가 통과할 지점 설정을 참고하세요.
경로 거리 및 도착예정시간과 함께 통행료 정보를 요청합니다. 자세한 내용은 경로의 통행료 계산을 참조하세요.
필드 마스크를 사용해 필요한 데이터만 요청하여 지연 시간과 품질을 제어하면 불필요한 처리 시간과 높은 요청 요금 청구를 피할 수 있습니다. 자세한 내용은 반환할 정보 선택을 참고하세요.
가능한 경로의 행렬 가져오기
Routes API Compute Route Matrix 메서드는 거리 및 예상 도착 시간을 포함하여 여러 출발지와 도착지 사이의 추천 경로에 대한 정보 행렬을 제공하여 비즈니스 요구사항에 따라 최적의 출발지와 목적지를 선택하는 데 도움을 줍니다. 다음과 같은 종류의 거리 데이터를 요청할 수 있습니다.
선택한 이동수단의 거리
거리(킬로미터 또는 마일)
교통량 예상 이동 시간
거리 데이터를 사용하면 가능한 여러 출발지와 목적지 사이에서 승객, 화물, 직원을 가장 효율적으로 이동시킬 수 있는 방법을 파악할 수 있습니다.
전체 매트릭스가 계산되기 전에 응답의 요소를 스트리밍하여 응답 지연 시간을 줄일 수 있습니다.
서버 측 요청당 출발지 수와 목적지 수를 최대 625개 곱하여 여러 출발지와 목적지를 지정할 수 있습니다.
Routes API의 작동 방식
Routes API에는 ComputeRoute와 ComputeRouteMatrix의 두 가지 메서드가 있습니다.
ComputeRoute
Routes API ComputeRoute 메서드는 요청 세부정보가 포함된 JSON 요청 본문과 함께 HTTP POST 요청을 허용합니다. 출발지, 목적지,
travelMode 및 반환할 필드를 지정하는 필드 마스크는 필수 항목입니다.
예
curl -X POST -d '{
"origin": {
"address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
},
"destination": {
"address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
그러면 서비스는 요청된 경로를 계산하고 사용자가 요청한 필드를 반환합니다.
ComputeRouteMatrix
Routes API ComputeRouteMatrix는 요청 세부정보가 포함된 JSON 요청 본문과 함께 HTTP POST 요청을 허용합니다. 최소한 1개 이상의 출발지, 2개 이상의 목적지, travelMode, 반환할 필드를 지정하는 필드 마스크가 필요합니다.
예
curl -X POST -d '{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420761,
"longitude": -122.081356
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.403184,
"longitude": -122.097371
}
}
}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420999,
"longitude": -122.086894
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.383047,
"longitude": -122.044651
}
}
}
}
],
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
응답에는 모든 출발지와 목적지 경유지의 조합에 대한 가능한 경로가 포함됩니다.
자료
다음 표에는 Routes API에서 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다.
| 데이터 리소스 | 반환된 데이터 | 반환 형식 |
|---|---|---|
| ComputeRoute | 요청된 경우 대체 경로와 함께 경로의 경로, 구간, 단계를 반환합니다. | JSON |
| ComputeRouteMatrix | 하나의 출발지 경유지에서 하나의 목적지 경유지까지의 경로 배열을 반환합니다. |
Routes API 사용 방법
| 1 | 설정하기 | Google Cloud 프로젝트 설정으로 시작하고 다음 설정 안내를 완료합니다. |
| 2 | 경로 계산 및 응답 검토 | 자세한 내용은 경로 가져오기 및 경로 응답 검토를 참고하세요. |
| 3 | 경로 행렬 계산 및 응답 검토 | 자세한 내용은 경로 매트릭스 가져오기 및 경로 매트릭스 응답 검토를 참고하세요. |
사용 가능한 클라이언트 라이브러리
Routes API에 사용할 수 있는 클라이언트 라이브러리 목록은 클라이언트 라이브러리를 참조하세요.