Package google.maps.routes.v1alpha

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

터미널 및 중간 웨이포인트 집합과 경로 목표가 주어지면 경로 목표에 가장 적합한 경로를 계산합니다. 또한 가장 빠른 경로와 최단 경로를 참조 경로로 반환합니다.

참고: 이 방법을 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 필드 경로의 쉼표로 구분된 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 이 메서드에서 다음을 실행합니다.

• 사용 가능한 모든 필드의 필드 마스크 (수동 검사용): X-Goog-FieldMask: *
• 경로 거리, 소요 시간, 토큰, 통행료 정보의 필드 마스크: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하거나 최상위 수준 (routes)에서 필드 마스크를 지정하는 것은 권장하지 않습니다.

• 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 줄여 결과를 반환할 수 있습니다.
• 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능이 보장됩니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
• 필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

• https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

출발지 및 목적지 목록을 사용하고 출발지와 목적지의 각 조합에 대한 경로 정보가 포함된 스트림을 반환합니다.

참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 필드 경로의 쉼표로 구분된 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 이 메서드에서 다음을 실행합니다.

• 사용 가능한 모든 필드의 필드 마스크(수동 검사용): X-Goog-FieldMask: *
• 경로 시간, 거리, 요소 상태, 상태, 요소 색인의 필드 마스크 (프로덕션 설정 예): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

필드 마스크에 status를 포함해야 합니다. 그렇지 않으면 모든 메시지가 정상적으로 표시됩니다. Google에서는 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하지 않는 것이 좋습니다.

• 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 줄여 결과를 반환할 수 있습니다.
• 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능이 보장됩니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
• 필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

• https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

지정된 일련의 터미널 및 중간 경유지가 지정된 기본 경로와 선택적 대체 경로를 반환합니다.

참고: 이 방법을 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 다음 메서드에서

• 사용 가능한 모든 필드의 필드 마스크(수동 검사용): X-Goog-FieldMask: *
• 경로 수준 시간, 거리, 다중선의 필드 마스크(프로덕션 설정 예시): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하거나 최상위 수준 (routes)에서 필드 마스크를 지정하는 것은 권장하지 않습니다.

• 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 줄여 결과를 반환할 수 있습니다.
• 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능이 보장됩니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
• 필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

• https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.