경로 행렬 계산

여러 목적지로 향하는 경로의 거리와 소요 시간을 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. 요청을 생성합니다. 필수 메타데이터 2개를 전송해야 함 다음과 같이 요청합니다.

    • 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(으)로 요청을 보냅니다. 다음을 사용해야 합니다. 전송하려고 합니다

ComputeRouteMatrix 메서드 사용 예는 다음을 참조하세요. 경로 행렬 계산 (베타) 예시를 참조하세요.

ComputeRouteMatrix 메서드의 한 가지 두드러진 특징은 오류 코드는 전체 스트림 또는 요소 예를 들어 요청이 잘못된 형식입니다 (예: 출처가 없음). 하지만 오류가 스트림의 일부 요소에만 적용할 수 있습니다 (예: 잘못된 장소 ID 설정 오류의 영향을 받은 요소에만 오류 코드가 표시됩니다.

스트림에서 반환한 요소는 반환되리라는 보장이 없습니다. 어떤 순서로든 말이죠. 따라서 각 요소에 origin_index 및 destination_index입니다. 지정된 출발지 및 목적지 요청에 따라 경로 출발지가 origins[origin_index]와 같음 경로 목적지가 동일한 경우 destinations[destination_index]에게 전송합니다. 이러한 배열은 0으로 색인이 생성됩니다. 그것은 출발지 및 목적지 목록 주문을 저장하는 것이 중요합니다.

통행료 계산

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

통행료 계산의 예는 다음을 참고하세요. 경로 행렬 계산 예