Route mit kürzerer Entfernung abrufen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Mit „Routen berechnen“ können Sie Routen für Autofahrten zurückgeben, die für eine kürzere Strecke optimiert sind, wenn Sie Routen mit kürzerer Strecke aktivieren.

Wenn Sie eine Route mit kürzerer Strecke anfordern, gibt der Dienst Folgendes zurück:

Die Standardroute, die hauptsächlich für die voraussichtliche Ankunftszeit optimiert ist.
Eine kürzere Route, die für die Minimierung der Strecke während der gesamten Fahrt optimiert ist.

Was ist das und warum sollte ich es verwenden?

Bei einer Route mit kürzerer Strecke wird die Entfernung gegenüber Fahrkomfort oder Geschwindigkeit priorisiert. Beispielsweise werden möglicherweise Landstraßen anstelle von Autobahnen, unbefestigte Straßen oder Parkplätze bevorzugt. Es werden keine Manöver zurückgegeben, die Google Maps als illegal kennt.

Route mit kürzerer Strecke anfordern

Ihre Anfrage muss die folgenden Kriterien erfüllen:

Setzen Sie travelMode auf DRIVE, BICYCLE oder TWO_WHEELER.
Setzen Sie requestedReferenceRoutes auf SHORTER_DISTANCE.
Legen Sie eine Feldmaske für die Antwort fest, um die Antwortattribute zurückzugeben, die mit einer Route mit kürzerer Strecke verknüpft sind:
- routes.routeLabels: Gibt an, ob die Route DEFAULT_ROUTE, SHORTER_DISTANCE oder DEFAULT_ROUTE_ALTERNATE ist.
- routes.routeToken: Ein Routentoken, das Sie an das Navigation SDK übergeben können, um eine benutzerdefinierte Route abzurufen.
Fügen Sie keine Zwischenziele vom Typ Via ein.
Fügen Sie nicht den optimizeWaypointOrder Parameter ein.
Optional: Legen Sie eine Feldmaske für die Antwort fest, um die folgenden Attribute zurückzugeben, die sowohl mit der Standardroute als auch mit der Route mit kürzerer Strecke verknüpft sind:
- routes.distanceMeters: Gibt die Entfernung der Route zurück.
- routes.duration: Gibt die Dauer der Route zurück.

Referenzinformationen finden Sie unter ReferenceRoute und RouteLabel.

Beispielanfrage: Route mit kürzerer Strecke

Der folgende Code zeigt eine Anfrage für eine Route mit kürzerer Strecke. In diesem Beispiel verwenden Sie die Feldmaske für die Antwort, um Felder zurückzugeben, die sowohl mit der Standardroute als auch mit der Route mit kürzerer Strecke verknüpft sind. Dazu verwenden Sie die folgenden Feldmasken:

routes.distanceMeters
routes.duration

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE",
  "requestedReferenceRoutes": ["SHORTER_DISTANCE"],
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Beispielantwort für eine kürzere Route

{
  "routes": [
    {
      "distanceMeters": 138943,
      "duration": "5373s",
      "routeToken": "CrsCCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXcklWWFo2cjhDZmltdk9NUDQ3aU1nUU0QBRpPCk0KGAoNCgIIAREAAAAAAIBmQBF56SYxqDm4QBISCAAQAxAGEBMQEhgCQgQaAggFIhsKF3JJVlhaLWFOQnZpbXZPTVA0N2lNZ1FNcAEoASIVAACBmRY1BjeCiUQewJGTrQ3DuHRp",
      "routeLabels": [
        "DEFAULT_ROUTE"
      ]
    },
    {
      "distanceMeters": 112610,
      "duration": "7165s",
      "routeToken": "CqgCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdySVZYWjZHR0RiTzV2T01QOUpiQXlBTRAFGk8KTQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhIIABADEAYQExASGAJCBBoCCAUiGwoXcklWWFo3S09Cck81dk9NUDlKYkF5QU1wASgCIhUAAIGZFlj_CmMgGE6KGZcsE-tEywM",
      "routeLabels": [
        "SHORTER_DISTANCE"
      ]
    }
  ]
}

Beispielanfrage: Route mit kürzerer Strecke und kraftstoffeffiziente Route

Der folgende Code zeigt eine Anfrage für eine Route mit kürzerer Strecke und eine kraftstoffeffiziente Route.

 curl -X POST -d '{
"origin": {  "location": {  "latLng": {  "latitude": 41.76904801292959,
"longitude": -72.67374935684933  }  }  },  "destination": {  "location": {
"latLng": {  "latitude": 41.823042361105024,  "longitude": -71.40933143059424  }
 }  },  "travelMode":"DRIVE",  "routingPreference":"TRAFFIC_AWARE_OPTIMAL",
"requestedReferenceRoutes": ["SHORTER_DISTANCE", "FUEL_EFFICIENT"] }' 

-H 'Content-Type: application/json' 

-H 'X-Goog-Api-Key: YOUR_API_KEY' 

-H 'X-Goog-FieldMask:
routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' 

'https://routes.googleapis.com/directions/v2:computeRoutes'

Beispielantwort: Route mit kürzerer Strecke und kraftstoffeffiziente Route

In diesem Fall sind die Route mit kürzerer Strecke und die kraftstoffeffizienteste Route identisch. Daher wird diese Route zurückgegeben und das routeLabel ist für beide Routentypen enthalten.

{  "routes": [  {  "distanceMeters": 138943,  "duration": "5375s",
"routeToken":
"Cr8CCs4BMssBGq8BCkECFg9eN0MowaEI3Y4KqMEhzOTe-Qi3947kBsb8koUBkvX0oAKJ_b1S4uPoUvzzAYfXA92t_RXyw98Up6qKAaRaABIsNBjodKMdkMYAPMLMIajCwj-zsIxpgyBxOLYjdBBeKgkO3tFDDrj4YgZB5bMaFQAATME12CCCA9MEF-kO2wL_____DyoLHgAOAHN3DggAQQEyBAUBAQM9VDgqPkV88FI_SNO81oLq4JnjYyIXS1laWFo4T19JcWVCM2ZFUDFMbms4UXcQBRpTClEKGAoNCgIIAREAAAAAAIBmQBFOYhBYGTy4QBIWCAAQAxAGEBMQEhgCQgQaAggFSgIIASIbChdLWVpYWjlpV0g2ZUIzZkVQMUxuazhRd3ABKAEiFQAAgZkW4Df4cspNNJZWlMZuUUxLPQ",
 "routeLabels": [  "DEFAULT_ROUTE"  ]  },  {  "distanceMeters": 112610,
"duration": "7156s",  "routeToken":
"CqwCCrsBMrgBGpwBCjYCFg1SN0MowaEI3Y4KjfqjF6Ls9BXc-QGiqCOpu7FDtfCXxSG2zLOGI_r4uQGc-we_nQ7MLAASLDQY6HSjHZDGg26EAFrPI5Q3NxvGA4ELazy3sLYqno_9eAFD2KxlCqAGQeWzGg4AAMQDGwyiAqwwKQggJCoLHgBsCQ8Acm0XWWcyAgQGPVQ4Kj5FfPBSP0jikPWC95WdhIwBIhdLWVpYWi1UNklfT055OVlQczhhcWlRSRAFGlMKUQoYCg0KAggCEQAAAAAAAFlAEU5iEFh5af1AEhYIABADEAYQExASGAJCBBoCCAVKAggBIhsKF0tZWlhaNERXSF9PTnk5WVBzOGFxaVFJcAEoAiIVAACBmRaESp2EJS5nmwiEF8KH15_f",
 "routeLabels": [  "FUEL_EFFICIENT",  "SHORTER_DISTANCE"  ]  }  ] }

Unterstützte Regionen

Routen mit kürzerer Strecke werden in allen Regionen unterstützt.

Abrechnung

Für die Nutzung einer experimentellen Funktion werden von der Google Maps Platform keine zusätzlichen Gebühren erhoben. Die Gebühren richten sich nach Ihrer Nutzung der API und anderen von Ihnen festgelegten Parametern.

Weitere Informationen zur Abrechnung für die Routes API