경로 행렬 계산

Routes Preferred API의 ComputeRouteMatrix 메서드를 사용하여 여러 출발지와 목적지의 경로 거리와 시간을 계산할 수 있습니다. ComputeRouteMatrix는 스트리밍 gRPC 호출과 REST HTTP 호출을 모두 지원합니다.

출발지 및 목적지 쌍 목록이 주어지면 ComputeRouteMatrix는 각 출발지에서 시작하여 각 목적지에서 끝나는 경로의 거리와 소요 시간을 계산합니다. 스트림의 각 요소는 단일 경로의 정보에 해당합니다.

ComputeRouteMatrix 메서드는 거리 매트릭스 서비스에 비해 다음과 같은 몇 가지 장점이 있습니다.

• 스트리밍을 사용하면 전체 행렬이 계산되기 전에 요소를 반환할 수 있으므로 지연 시간이 줄어듭니다.
• ComputeRouteMatrix에는 트래픽 계산을 위한 세부 옵션이 있어 품질-지연 시간 절충 결정을 내릴 수 있습니다.
• 요청은 Google 인프라 내에서 더 높은 우선순위로 실행되므로 가용성이 높아집니다.
• 경로의 경유지에 대한 방향 (이동 방향) 및 도로 측면 정보를 지정할 수 있습니다.
• 경로 거리 및 도착 예정 시간과 함께 통행료 정보가 반환되도록 요청할 수 있습니다.

ComputeRouteMatrix 메서드 사용 설정

코드에서 ComputeRouteMatrix 메서드를 사용하려면 먼저 사용 설정해야 합니다. Routes Preferred API 메서드 사용 설정에 대한 자세한 내용은 시작하기를 참고하세요.

ComputeRouteMatrix 메서드 사용

ComputeRouteMatrix 메서드는 Routes Preferred v1 엔드포인트를 통해 사용할 수 있습니다.

자세한 내용은 다음 문서를 참고하세요.

gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

다음 일반 단계에서는 gRPC를 사용하여 ComputeRouteMatrix 메서드를 호출하는 방법을 설명합니다.

1. googleapis 저장소에서 필요한 프로토콜 버퍼를 체크아웃합니다.

   https://github.com/googleapis/googleapis/tree/master/google/maps/routes

   Go와 같은 일부 빌드 시스템은 이 작업을 자동으로 실행할 수 있습니다.

2. 선호하는 언어와 빌드 도구 세트를 사용하여 관련 프로토버퍼 코드를 생성합니다.

3. 요청을 생성합니다. 요청과 함께 전송해야 하는 두 가지 필수 메타데이터가 있습니다.

   • X-Goog-Api-Key는 API 키로 설정해야 합니다.

   • X-Goog-Fieldmask는 응답에서 필요한 필드의 쉼표로 구분된 목록으로 설정해야 합니다. 예를 들어 X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status입니다. 와일드 카드 문자 (*)를 사용하여 모든 필드를 나타낼 수 있지만 권장하지는 않습니다. 와일드 카드 문자를 사용하여 API 응답을 테스트하고 이해하되, 프로덕션 코드의 필드 마스크에 원하는 필드를 명시적으로 나열하세요.

     필드 마스크 문자열을 구성하는 방법에 대한 자세한 내용은 https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto를 참고하세요. 필요하지 않은 필드를 사용 중지하면 이러한 필드에 추가 계산이 필요할 수 있으므로 지연 시간을 줄일 수 있습니다. 필요한 필드를 지정하고 나중에 더 많은 계산이 필요한 새 필드를 추가하면 지연 시간이 안정적으로 유지됩니다.

4. routespreferred.googleapis.com:443에 요청을 전송합니다.TLS 프로토콜을 사용해야 합니다.

ComputeRouteMatrix 메서드 사용 예시는 경로 매트릭스 계산 (베타) 예시를 참고하세요.

ComputeRouteMatrix 메서드의 한 가지 특징은 전체 스트림 또는 개별 요소에 대해 오류 코드를 반환할 수 있다는 것입니다. 예를 들어 요청이 잘못된 경우 (예: 원본이 0개임) 스트림 연결에서 오류가 반환됩니다. 하지만 오류가 스트림의 일부 요소에만 적용되는 경우 (예: 원본에 잘못된 장소 ID를 설정하는 경우) 오류의 영향을 받는 요소에만 오류 코드가 포함됩니다.

스트림에서 반환된 요소는 순서가 보장되지 않습니다. 이 때문에 각 요소에는 origin_index와 destination_index가 포함됩니다. 요청에 의해 지정된 출발지와 목적지의 경우, 경로 출발지는 지정된 요소에 대해 origins[origin_index]와 동일하고 경로 목적지는 destinations[destination_index]와 동일합니다. 이러한 배열은 0부터 시작하는 색인입니다. 출발지 및 도착지 목록 순서를 저장하는 것이 중요합니다.

통행료 계산

통행료 계산에 대한 자세한 내용은 통행료 계산을 참고하세요.

통행료 계산 예시는 경로 매트릭스 계산 예시를 참고하세요.