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

Google에서는 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하거나 최상위 수준 (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를 포함해야 합니다. 그러지 않으면 모든 메시지가 정상인 것처럼 보입니다. 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하지 않는 것이 좋습니다.

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

승인 범위

다음 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

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

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

승인 범위

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

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

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