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 Strecke 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 geschätzte Ankunftszeit optimiert ist.
  • Eine kürzere Route, die darauf ausgelegt ist, die zurückzulegende Strecke für die gesamte Fahrt zu minimieren.

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 oder Schotterstraßen bevorzugt oder Parkplätze durchquert. Es werden keine Manöver zurückgegeben, die laut Google Maps illegal sind.

Kürzere Route anfordern

Ihr Antrag 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 mit einer Route mit kürzerer Distanz verknüpft sind:
    • routes.routeLabels: Gibt an, ob es sich bei der jeweiligen Route um DEFAULT_ROUTE, SHORTER_DISTANCE oder DEFAULT_ROUTE_ALTERNATE handelt.
    • routes.routeToken: Ein Routen-Token, 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 Maske für das Antwortfeld fest, um die folgenden Eigenschaften zurückzugeben, die sowohl mit der Standard- als auch mit der Route mit kürzerer Distanz 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 Distanz

Der folgende Code zeigt eine Anfrage für eine Route mit kürzerer Distanz. 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 verbrauchsärmste Route

Der folgende Code zeigt eine Anfrage für eine Route mit kürzerer Distanz und eine spritsparende 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 und die verbrauchsärmste 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 Distanz werden in allen Regionen unterstützt.

Abrechnung

Für die Nutzung einer experimentellen Funktion fallen bei der Google Maps Platform 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