이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Routes API 개요

Routes API는 HTTPS 요청을 수락하고 두 위치 간의 이상적인 경로 또는 여러 출발지와 목적지 간의 경로 매트릭스의 거리와 이동 시간을 반환하는 서비스입니다.

Routes API를 사용해야 하는 이유

Routes API를 사용하면 대중교통 세부정보, 최신 교통 및 도로 상태, 경로 환경설정을 사용하여 정확한 경로 및 이동 정보를 가져올 수 있습니다.

다양한 이동수단의 유형 및 기능
차량이 향하는 방향
승하차할 도로의 측면
교통상황 및 도로 폐쇄
위험한 지역을 피하거나 안전한 수령 지역을 제공하는 등 안전 문제
통행료, 시간 및 거리와 같은 경로 메타데이터, 연료 효율과 같은 선택적 기능을 사용하여 라우팅 요구사항 전반에서 지연 시간, 품질, 비용의 균형을 유지합니다.

다음과 같이 가장 효율적인 배송 일정 경로를 결정할 수도 있습니다.

일련의 패키지를 수거할 일꾼을 할당하는 가장 좋은 방법
최종 목적지로 상품을 배송할 가장 적합한 창고 결정

Routes API로 무엇을 할 수 있나요?

Routes API를 사용하면 다음과 같은 두 가지 기본 라우팅 정보 카테고리를 가져올 수 있습니다.

한 위치에서 하나 또는 여러 목적지로의 경로
여러 시작 위치와 끝 위치 간의 가능한 경로 매트릭스입니다.

하나 또는 여러 목적지의 경로 가져오기

Routes API Compute Routes 메서드를 사용하면 다음을 계산할 수 있습니다.

다양한 이동 수단과 단일 또는 여러 목적지에 대한 경로를 확인할 수 있습니다.
- 대중교통, 운전, 이륜차, 도보 또는 자전거 등 이동 수단
- 일련의 경유지로, 가장 효율적인 순서로 이동하도록 최적화할 수 있습니다.
출발지, 목적지, 경유지를 지정하는 여러 가지 방법:
- 텍스트 문자열 예: '시카고, 일리노이', '다윈, NT, 오스트레일리아', '1800 Amphitheatre Parkway, Mountain View, CA 94043' 또는 'CWF6+FWX Mountain View, California'
- 장소 ID
- 위도 및 경도 좌표(선택적으로 차량 방향 포함)
필요와 목표에 따라 경로 옵션을 미세 조정합니다.
- 차량의 엔진 유형(디젤, 전기, 하이브리드, 가솔린)에 따라 연료 또는 에너지 효율이 높은 경로를 선택합니다. 자세한 내용은 친환경 경로 가져오기를 참고하세요.
- 트래픽 계산을 위한 세분화된 옵션을 설정하여 품질과 지연 시간 간의 절충점을 결정할 수 있습니다. 자세한 내용은 트래픽 데이터를 포함하는 방법 및 여부 지정을 참고하세요.
- 도착예정시간 정확성을 높이려면 경유지의 차량 방향 (운행 방향) 및 도로변 정보를 설정하세요. 자세한 내용은 차량 진행 방향 및 도로 측면 지정을 참고하세요.
- 통과 위치와 터미널 위치, 안전한 경유지 위치를 지정합니다. 자세한 내용은 경로의 정류장 설정 및 경로가 통과하는 지점 설정을 참고하세요.
- 경로 거리 및 도착 예정 시간과 함께 통행료 정보를 요청합니다. 자세한 내용은 경로의 통행료 계산을 참고하세요.
필드 마스크를 사용하여 필요한 데이터만 요청하여 지연 시간과 품질을 제어하세요. 이렇게 하면 불필요한 처리 시간과 요금이 더 높은 요청 청구 요율을 방지할 수 있습니다. 자세한 내용은 반환할 정보 선택하기를 참고하세요.

가능한 경로의 행렬 가져오기

Routes API Compute Route Matrix 메서드는 비즈니스 요구사항에 따라 최적의 출발지와 목적지를 선택하는 데 도움이 되도록 거리 및 예상 도착 시간을 비롯하여 여러 시작 지점과 종료 지점 간의 추천 경로에 관한 정보 매트릭스를 제공합니다. 다음과 같은 종류의 거리 데이터를 요청할 수 있습니다.

선택한 이동 모드의 거리
거리(킬로미터 또는 마일)
예상 이동 시간(교통 상황 고려)

거리 데이터를 사용하면 여러 가능한 출발지와 도착지 간에 승객, 배송 또는 작업자의 경로를 가장 효율적으로 지정할 수 있습니다.

전체 행렬이 계산되기 전에 응답 요소를 스트리밍하여 응답 지연 시간을 줄일 수 있습니다.

서버 측 요청당 출발지와 도착지를 여러 개 지정할 수 있으며, 출발지 수가 도착지 수의 최대 625배까지 가능합니다.

Routes API 작동 방식

Routes API에는 ComputeRoutes 및 ComputeRouteMatrix라는 두 가지 메서드가 있습니다.

ComputeRoutes

Routes API ComputeRoutes 메서드는 요청 세부정보가 포함된 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를 통해 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다.

데이터 리소스	반환된 데이터	반환 형식
ComputeRoutes	요청된 경우 대체 경로와 함께 경로, 구간, 경로의 단계를 반환합니다.	JSON
ComputeRouteMatrix	하나의 출발 웨이포인트에서 하나의 도착 웨이포인트로의 경로 배열을 반환합니다.

Routes API 사용 방법

1	설정하기	Google Cloud 프로젝트 설정하기부터 시작하여 다음의 설정 안내를 완료합니다.
2	경로 계산 및 응답 검토	자세한 내용은 경로 가져오기 및 경로 응답 검토를 참고하세요.
3	경로 매트릭스 계산 및 응답 검토	자세한 내용은 경로 매트릭스 가져오기 및 경로 매트릭스 응답 검토를 참고하세요.

사용 가능한 클라이언트 라이브러리

Routes API에 사용할 수 있는 클라이언트 라이브러리의 목록은 클라이언트 라이브러리를 참고하세요.