Diese Seite wurde von der Cloud Translation API übersetzt.

Wählen Sie aus, welche Informationen zurückgegeben werden sollen

Wenn Sie eine Methode aufrufen, um eine Route oder Routenmatrix zu berechnen, müssen Sie angeben, welche Informationen Sie erhalten möchten, indem Sie die Felder in der Antwort zurückgegeben werden. Es gibt keine Standardliste der zurückgegebenen Felder. Wenn Sie diese Liste weglassen, geben die Methoden einen Fehler zurück.

Zum Angeben der Feldliste erstellen Sie eine Antwortfeldmaske. Sie bestehen dann die Antwortfeldmaske auf eine der beiden Methoden mithilfe des URL-Parameters $fields oder fields oder mithilfe des HTTP- oder gRPC-Headers X-Goog-FieldMask.

Die Verwendung einer Feldmaske ist eine gute Designpraxis, um sicherzustellen, dass Sie keine und unnötige Daten, was wiederum dazu beiträgt, unnötige Verarbeitungszeiten und in Rechnung gestellte Kosten zu vermeiden.

Weitere Informationen zu URL-Parametern finden Sie unter Systemparameter.

Antwortfeldmaske definieren

Die Antwortfeldmaske ist eine durch Kommas getrennte Liste von Pfaden, in denen jeder Pfad path gibt ein eindeutiges Feld in der Antwortnachricht an. Der Pfad beginnt mit der Antwortnachricht der obersten Ebene und enthält durch einen Punkt getrennte Pfad zum angegebenen Feld.

Erstellen Sie einen Feldpfad und geben Sie ihn so an:

Suchen Sie die Felder mit den benötigten Informationen aus der Routes API. Weitere Informationen findest du unter Feldverweise.
Pfade für die benötigten Felder bestimmen und Feldmasken dafür erstellen: Weitere Informationen finden Sie unter Zu verwendende Feldmaske bestimmen.
Kombinieren Sie die Feldmasken für alle benötigten Felder und trennen Sie die Feldmasken durch Kommas. Wenn Sie beispielsweise die distanceMeters für den Routenabschnitt und die Dauer für jeden Routenabschnitt anfordern möchten, geben Sie beide durch ein Komma getrennt und ohne Leerzeichen ein:
```
routes.legs.distanceMeters,routes.legs.steps.duration
```
Senden Sie die Feldmaske mit Ihrer API-Anfrage. In einer cURL-Anfrage würden Sie beispielsweise die Feldmaske mit -H und X-Goog-FieldMask angeben:
```
-H X-Goog-FieldMask: routes.legs.distanceMeters,routes.legs.steps.duration
```

Beispiele und weitere Informationen finden Sie in den folgenden Abschnitten.

Feldverweise

Die Felder, die Sie in einer Antwort über Feldmasken anfordern können, finden Sie in den Routes API-Referenzen, die in der folgenden Liste verlinkt sind. Geben Sie die Felder wie in der Referenz gezeigt in der Camel-Case-Schreibweise an. Beispiel: routePreference.

Im Gegensatz dazu müssen Werte der Parameter wie gezeigt eingegeben werden. Für routingPreference müssen Sie beispielsweise TRAFFIC_AWARE eingeben.

Diese Referenzen umfassen die verfügbaren Felder. Sie müssen sich jedoch auf die Hierarchie der Felder beziehen, um den vollständigen Feldmaskenpfad zu ermitteln. Weitere Informationen zum Abrufen der Hierarchie der Felder finden Sie im Hilfeartikel Welche Feldmaske soll verwendet werden?.

Feldmaske für Compute-Route
- REST: Gibt die Felder der Route-Objekt im Antwort mit dem Präfix routes., z. B.: routes.distanceMeters.
- gRPC: Gibt die Felder der Route-Objekt im die zurückgegeben werden soll.
Feldmasken der Routenmatrix berechnen
- REST: Gibt die Felder der Antworttext zurück.
- gRPC: Gibt die Felder der RouteMatrixElement -Objekt in der zurückzugebenden Antwort.

Bestimmen, welche Feldmasken verwendet werden sollen

So legen Sie fest, welche Felder Sie verwenden möchten, und erstellen die Feldmasken:

Alle Felder anfordern mit einer Feldmaske von *.
Achtung:Sie können diese Platzhalterfeldmaske zwar während der Entwicklung verwenden, um zu bestimmen, welche Felder Sie benötigen. Verwenden Sie sie jedoch nicht in der Produktion. Das Anfordern aller Felder in der Produktion führt zu höheren Kosten und längeren Antwortzeiten. Ihre Kosten können auch unerwartet steigen, wenn erweiterte Funktionen hinzugefügt werden, da sie in dieser Feldmaske automatisch eingeschlossen werden. Fordern Sie stattdessen nur die Felder an, die Sie benötigen, um Kosten zu minimieren und Antwortzeiten zu erhalten.
Sehen Sie sich die Hierarchie der Felder in der Antwort an. die gewünschten Felder hinzu.
Erstellen Sie Ihre Feldmasken unter Verwendung der im vorherigen Schritt gezeigten Hierarchie der Felder im folgenden Format:
```
topLevelField[.secondLevelField][.thirdLevelField][...]
```
Hinweis:Verwenden Sie in der Liste der Feldpfade keine Leerzeichen.

Für diese Teilantwort von einer Route gilt beispielsweise Folgendes:

"routes": [
    {
        "legs": [
            {  "steps": [
                    {"distanceMeters": 119},
                    {"distanceMeters": 41}  ]
            }
        ],
        "distanceMeters": 160
    }
]

So geben Sie für den Routenabschnitt nur das Feld distanceMeters zurück: Das heißt, die Feldmaske im letzten distanceMeters im vorherigen Beispiel lautet so:

routes.legs.distanceMeters

Wenn Sie stattdessen das Feld distanceMeters für jeden Schritt des Routenabschnitts zurückgeben möchten, Das heißt, der distanceMeters unter steps im vorherigen Beispiel lautet Ihre Feldmaske:

routes.legs.steps.distanceMeters

Wenn Sie beide zurückgeben möchten, sieht Ihre Feldmaske mit dem obigen Ergebnis so aus:

routes.legs.distanceMeters,routes.legs.steps.distanceMeters

Beispiele für Feldmaskenpfade

Dieser Abschnitt enthält weitere Beispiele zum Angeben eines Feldpfads als Teil einer Antwortfeldmaske in REST- und gRPC-Aufrufen.

REST-Aufruf an `computeRoutes`

Im ersten Beispiel verwenden Sie einen REST-Aufruf an die computeRoutes-Methode zur Berechnung eine Route berechnen. In diesem Beispiel geben Sie im Header Feldmasken an, um die Routenfelder distanceMeters und duration in der Antwort zurückzugeben. Denken Sie daran, dem Feldnamen routes voranzustellen.

X-Goog-FieldMask: routes.distanceMeters,routes.duration

REST-Aufruf an `computeRouteMatrix`

Für REST computeRouteMatrix -Methode zur Berechnung einer Routenmatrix. Geben Sie im Header an, dass die Daten zurückgegeben werden sollen. originIndex, destinationIndex und duration für jede Ursprungskombination und Ziel:

X-Goog-FieldMask: originIndex,destinationIndex,duration

gRPC-Aufruf

Legen Sie für gRPC eine Variable fest, die die Antwortfeldmaske enthält. Sie können diese Variable dann an die Anfrage übergeben.

const (
  fieldMask = "routes.distanceMeters,routes.duration,routes.polyline.encodedPolyline"
)

Überlegungen zu Feldpfaden

Nehmen Sie nur die Felder in die Antwort auf, die Sie benötigen, um nur das Feld die Sie benötigen:

Verringert die Verarbeitungszeiten, sodass Ihre Ergebnisse mit einer geringeren Latenz zurückgegeben werden.
Sorgt für eine stabile Latenzleistung. Wenn Sie oder alle Felder auf der obersten Ebene auswählen, kann es zu Leistungseinbußen kommen, wenn neue Felder hinzugefügt werden. automatisch in Ihrer Antwort enthalten.
Ergibt eine kleinere Antwortgröße, was zu einem höheren Netzwerkdurchsatz führt.
Sorgt dafür, dass keine unnötigen Daten angefordert werden, um unnötige Verarbeitungszeiten und in Rechnung gestellte Kosten zu vermeiden.

Hinweis:Wenn eine Antwortnachricht geparst wird, und ein Feld in der Antwortnachricht seinen Standardwert enthält, kann das Feld in der Antwort weggelassen werden, auch wenn in der Antwortfeldmaske angegeben. Weitere Informationen finden Sie in der Language Guide (proto3) zugreifen Wenn Sie beispielsweise eine Routenmatrix berechnen, Das Feld distanceMeters der Antwort kann den Wert 0 enthalten. Standardwert sein. Da 0 der Standardwert von distanceMeters ist, wird wird in der Antwort ausgelassen.

Weitere Informationen zum Erstellen einer Feldmaske finden Sie in der field_mask.proto.

Routingtoken anfordern

So fordern Sie an, dass die Routes API Routentokens für generierte Routen zurückgibt:

Legen Sie die folgenden Parameter fest, die erforderlich sind, um ein Routentoken zurückzugeben:
- Setzen Sie travelMode auf DRIVE.
- Legen Sie routingPreference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL fest.
Achten Sie darauf, dass keiner der Wegpunkte Ihrer Route via-Wegpunkte ist.
Geben Sie die Feldmaske routes.routeToken an, um ein Routentoken zurückzugeben:
```
X-Goog-FieldMask: routes.routeToken
```

Sie können das Routentoken für Ihre geplante Route im Navigation SDK verwenden. Weitere Informationen finden Sie unter Route planen (Android) oder Route planen (iOS)

Beispiel für Routentoken

Hier ist ein Beispiel für einen cURL-Anfragetext für einen einzelnen Start- und Zielort Route mit Feldmasken zum Anfordern eines Routing-Tokens zusammen mit der Route Dauer, Entfernung und Polylinienlinie der Route:

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

Weitere Informationen finden Sie in der Referenz zur Compute Routes API

Wählen Sie aus, welche Informationen zurückgegeben werden sollen

Antwortfeldmaske definieren

Feldverweise

Bestimmen, welche Feldmasken verwendet werden sollen

Beispiele für Feldmaskenpfade

REST-Aufruf an computeRoutes

REST-Aufruf an computeRouteMatrix

gRPC-Aufruf

Überlegungen zu Feldpfaden

Routingtoken anfordern

Beispiel für Routentoken

REST-Aufruf an `computeRoutes`

REST-Aufruf an `computeRouteMatrix`