Route mit kürzerer Entfernung abrufen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Mit Compute Routes können Fahrrouten zurückgegeben werden, die für eine kürzere Fahrstrecke optimiert sind, wenn Sie Routen mit kürzerer Distanz aktivieren.

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

  • Die Standardroute, die in erster Linie für die voraussichtliche Ankunftszeit optimiert ist.
  • Eine kürzere Route, die so optimiert ist, dass die Fahrstrecke für die gesamte Fahrt minimiert wird.

Was ist das und warum sollte ich es verwenden?

Bei einer Route mit kürzerer Distanz wird die Distanz gegenüber Fahrkomfort oder Geschwindigkeit priorisiert. So werden beispielsweise Landstraßen anstelle von Autobahnen bevorzugt, Schotterstraßen befahren oder Parkplätze durchquert. Es werden keine Manöver zurückgegeben, die laut Google Maps illegal sind.

Route mit kürzerer Entfernung anfordern

Ihre Anfrage muss die folgenden Kriterien erfüllen:

  • Legen Sie travelMode auf DRIVE, BICYCLE oder TWO_WHEELER fest.
  • Setzen Sie requestedReferenceRoutes auf SHORTER_DISTANCE.
  • Legen Sie eine Antwortfeldmaske fest, um die Antwortattribute zurückzugeben, die einer Route mit kürzerer Distanz zugeordnet sind:
    • routes.routeLabels: Gibt an, ob die jeweilige Route als DEFAULT_ROUTE, SHORTER_DISTANCE oder DEFAULT_ROUTE_ALTERNATE identifiziert wird.
    • routes.routeToken: Ein Routentoken, das Sie an das Navigation SDK übergeben können, um eine benutzerdefinierte Route abzurufen.
  • Fügen Sie keine Via-Wegpunkte ein.
  • Geben Sie den Parameter optimizeWaypointOrder nicht an.
  • Optional: Legen Sie eine Antwortfeldmaske fest, um die folgenden Attribute für die Standardroute und die Route mit kürzerer Entfernung zurückzugeben:
    • routes.distanceMeters: Gibt die Entfernung der Route zurück.
    • routes.duration: Gibt die Dauer der Route zurück.

Weitere Informationen finden Sie unter ReferenceRoute und RouteLabel.

Beispielanfrage: Route mit kürzerer Entfernung

Der folgende Code zeigt eine Anfrage für eine Route mit kürzerer Entfernung. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Felder zurückzugeben, die sowohl der Standardroute als auch der Route mit der kürzeren Distanz zugeordnet 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'

Beispiel für eine Antwort mit einer kürzeren 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: Kürzere Strecke und verbrauchsarme Route

Der folgende Code zeigt eine Anfrage für eine kürzere und eine kraftstoffsparende 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: Kürzere Strecke und spritsparende Route

In diesem Fall sind die kürzere Strecke und die spritsparendste Route identisch. Daher wird diese Route zurückgegeben und die 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 Entfernung werden in allen Regionen unterstützt.

Abrechnung

Für die Nutzung einer experimentellen Funktion fallen keine zusätzlichen Kosten an. 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