ComputeRoutes()
메서드를 호출할 때
지정할 수 있습니다. 응답 필드 마스크를 사용하면 됩니다.
URL 매개변수 $fields
또는 fields
를 제공하거나
HTTP/gRPC 헤더 X-Goog-FieldMask
입니다. 자세한 내용은
시스템 매개변수.
필드 마스크
필드 마스크 값은 쉼표로 구분된 필드 경로 목록입니다. 각 필드 경로 는 메시지 계층 구조를 나타내는 점으로 구분된 필드 이름 목록입니다. 가 필드 이름은 JSON 객체 키이거나 protobuf 필드 태그 이름입니다. 이 필드 경로는 최상위 응답 메시지 유형에서 시작하며, 선택적으로 1개 이상의 점과 다음 수준의 필드 이름이 차례로 표시됩니다. 일반적으로 필드 경로는 다음과 같은 방식으로 구성됩니다.
topLevelField[.secondLevelField][.thirdLevelField][...]
특수 케이스 필드 마스크는 모든 루트 수준을 선택하는 와일드 카드 '*'입니다. 있습니다.
예
다음 예에서는 다음에 대한 필드 마스크를 설정하는 방법을 보여줍니다.
ComputeRoutes()
메서드를 사용하여 지도 가장자리에
패딩을 추가할 수 있습니다.
예시 1
사용 가능한 모든 필드의 필드 마스크 (수동 검사용)
X-Goog-FieldMask: *
예 2
경로 수준 소요 시간, 거리, 다중선의 필드 마스크 (프로덕션 설정 예)
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
와일드 카드 (*) 응답 필드 마스크를 사용하거나 프로덕션의 최상위 수준 (경로)에 있는 필드 마스크를 사용합니다. 선택 기준만 선택하면 다음과 같은 필드가 있습니다.
Google 서버가 처리 주기를 저장하여 더 짧은 지연 시간을 제공할 수 있습니다
안정적인 지연 시간 성능을 보장합니다. 응답 필드를 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 선택 항목 최상위 수준에서 모든 필드를 선택하는 경우 추가되는 모든 새 필드가 자동으로 포함되어 있습니다.
그 결과 응답 크기가 작아져 네트워크 규모가 커집니다. 더 높은 처리량을 제공하도록 설계되었습니다
필드 경로를 구성하는 방법에 관한 자세한 내용은 field_mask.proto.