Wenn Sie die ComputeRoutes()-Methode aufrufen, müssen Sie angeben, welche Felder in der Antwort zurückgegeben werden sollen. Dazu verwenden Sie eine Antwortfeldmaske, die Sie mit dem URL-Parameter $fields oder fields oder mit dem HTTP-/gRPC-Header X-Goog-FieldMask bereitstellen. Weitere Informationen finden Sie unter Systemparameter.
Feldmaske
Der Wert der Feldmaske ist eine durch Kommas getrennte Liste von Feldpfaden. Jeder Feldpfad ist eine durch Punkte getrennte Liste von Feldnamen, die die Nachrichtenhierarchie darstellen. Ein Feldname ist entweder der JSON-Objektschlüssel oder der Protobuf-Feld-Tag-Name. Der Feldpfad beginnt mit dem Antwortnachrichtentyp der obersten Ebene und wird optional von einem oder mehreren Punkten gefolgt, dann vom Feldnamen der nächsten Ebene. Im Allgemeinen werden Feldpfade so erstellt:
topLevelField[.secondLevelField][.thirdLevelField][...]
Ein Sonderfall für die Feldmaske ist der Platzhalter „*“, mit dem alle Felder auf Stammebene ausgewählt werden.
Beispiele
Das folgende Beispiel zeigt, wie Feldmasken für die Methode ComputeRoutes() festgelegt werden.
Beispiel 1
Feldmaske aller verfügbaren Felder (zur manuellen Überprüfung).
X-Goog-FieldMask: *
Beispiel 2
Feldmaske für Dauer, Entfernung und Polylinie auf Routenebene (Beispiel für die Produktionseinrichtung).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Wir raten davon ab, in der Produktion die Antwortfeldmaske mit dem Platzhalter (*) zu verwenden oder die Feldmaske auf der obersten Ebene (Routen) anzugeben. Nur die benötigten Felder auswählen:
So kann unser Server Verarbeitungszyklen sparen, sodass wir Ihre Ergebnisse mit einer geringeren Latenz zurückgeben können.
Sorgt für eine stabile Latenzleistung. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu, die zusätzliche Rechenzeit erfordern. Wenn Sie alle Felder oder alle Felder auf oberster Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neue Feld, das wir hinzufügen, automatisch in Ihre Antwort aufgenommen wird.
Führt zu einer kleineren Antwortgröße, was zu einem höheren Netzwerkdurchsatz führt.
Weitere Informationen zum Erstellen von Feldpfaden finden Sie unter field_mask.proto.