Wenn Sie die Methode ComputeRoutes()
aufrufen, müssen Sie angeben, welche Felder
die in der Antwort zurückgegeben werden sollen. Dazu verwenden Sie eine Antwortfeldmaske,
Sie mit dem URL-Parameter $fields
oder fields
oder mithilfe des Parameters
HTTP/gRPC-Header X-Goog-FieldMask
. Weitere Informationen finden Sie unter
Systemparameter.
Feldmaske
Der Feldmaskenwert ist eine durch Kommas getrennte Liste von Feldpfaden. Jeder Feldpfad ist eine durch Punkte getrennte Liste von Feldnamen, die die Nachrichtenhierarchie darstellen. A Feldname ist entweder der JSON-Objektschlüssel oder der Tag-Name des protobuf-Felds. Die Feldpfad beginnt mit dem Nachrichtentyp der obersten Ebene und ist optional gefolgt von einem oder mehreren Punkten und dann der nächsten Ebene des Feldnamens. Im Allgemeinen Feldpfade werden folgendermaßen konstruiert:
topLevelField[.secondLevelField][.thirdLevelField][...]
Eine Feldmaske für Sonderfälle ist ein Platzhalter „*“, mit dem alle Elemente auf Stammebene ausgewählt werden. .
Beispiele
Das folgende Beispiel zeigt, wie Feldmasken für die
ComputeRoutes()
-Methode.
Beispiel 1
Feldmaske aller verfügbaren Felder (für die manuelle Prüfung).
X-Goog-FieldMask: *
Beispiel 2
Feldmaske mit der Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für eine Produktionskonfiguration).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Wir raten von der Verwendung der Platzhalter-Antwortfeldmaske (*) oder der Angabe von Feldmaske auf oberster Ebene (Routen) in der Produktion. Wenn Sie nur die die Sie benötigen:
Dadurch kann unser Server Verarbeitungszyklen speichern, sodass wir Ihre mit einer geringeren Latenz.
Sorgt für eine stabile Latenzleistung Möglicherweise fügen wir in der Spalte Diese neuen Felder erfordern unter Umständen zusätzliche Rechenzeit. Wenn Sie oder alle Felder auf oberster Ebene auswählen, da jedes neu hinzugefügte Feld automatisch in Ihrer Antwort enthalten.
Führt zu einer kleineren Antwortgröße, was wiederum zu einem größeren Netzwerk führt. Durchsatz.
Weitere Informationen zum Erstellen von Feldpfaden finden Sie in der field_mask.proto.