Compute Route Matrix 개요

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

Compute Route Matrix는 HTTPS 요청을 수락하고 서로 다른 출발지 및 목적지 위치 간의 경로 매트릭스에 대한 거리와 이동 시간을 반환하는 Routes API 서비스의 메서드입니다. 여러 목적지 간의 이동 시간과 거리를 최대 625개의 경로 요소를 기반으로 계산하세요.

운전 경로가 필요하신가요? 경로 안내에 관심이 있다면 경로 계산 개요를 참고하세요.

이전하시나요? Distance Matrix API (기존)에서 마이그레이션하는 경우 Routes API로 마이그레이션해야 하는 이유로 시작하는 마이그레이션 안내를 참고하세요.

Compute Route Matrix를 사용하는 이유

Compute Route Matrix를 사용하면 다음과 같은 발송 일정에 가장 효율적인 경로를 확인할 수 있습니다.

  • 일련의 패키지를 수령할 작업자 집합을 가장 효과적으로 할당하는 방법

  • 최종 목적지로 패키지를 배송할 최적의 창고를 결정합니다.

Compute Route Matrix로 무엇을 할 수 있나요?

Compute Route Matrix를 사용하면 여러 시작 위치와 종료 위치 간의 가능한 경로 매트릭스를 확인할 수 있습니다. 서버 측 요청당 여러 출발지와 목적지를 지정할 수 있으며, 출발지 수와 목적지 수의 곱이 최대 625개입니다. 전체 행렬이 계산되기 전에 대답의 요소를 스트리밍하여 대답 지연 시간을 줄일 수 있습니다.

이러한 종류의 경로 데이터를 요청하여 여러 출발지와 목적지 간에 승객, 화물 또는 작업자를 가장 효율적으로 안내할 수 있습니다.

  • 선택한 이동 모드의 거리(킬로미터 또는 마일)

  • 교통 상황을 고려한 예상 이동 시간

Compute Route Matrix 작동 방식

ComputeRouteMatrix 메서드는 요청 세부정보가 포함된 JSON 요청 본문이 있는 HTTP POST 요청을 허용합니다. 하나 이상의 출발지, 두 개 이상의 도착지, 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 Compute Route Matrix 메서드를 통해 사용할 수 있는 리소스와 반환되는 데이터가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
ComputeRouteMatrix 하나의 출발지 경유지에서 하나의 목적지 경유지까지의 경로 배열을 반환합니다. JSON

Compute Route Matrix 사용 방법

1 설정하기 Google Cloud 프로젝트 설정하기로 시작하여 다음에 나오는 설정 안내를 완료합니다.
2 Routes API 청구 방식 이해하기 자세한 내용은 사용량 및 결제를 참고하세요.
3 경로 매트릭스 계산 및 응답 검토 자세한 내용은 경로 매트릭스 가져오기 및 경로 매트릭스 응답 검토하기를 참고하세요.

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

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

다음 단계