Route mit kürzerer Entfernung abrufen

Die Routes API kann für kürzere Strecken optimierte Routen für Pkw zurückgeben, wenn Sie Routen mit kürzerer Entfernung aktivieren.

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

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

Was ist das und warum sollte ich es verwenden?

Bei einer Route mit kürzerer Entfernung wird die Entfernung vor Fahrkomfort oder Geschwindigkeit priorisiert. So kann es beispielsweise sein, dass die Route über Landstraßen statt über Autobahnen führt, über unbefestigte Straßen verläuft oder über Parkplätze führt. 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 Antworteigenschaften für eine Route mit kürzerer Entfernung zurückzugeben:
    • routes.routeLabels: Gibt an, ob eine Route DEFAULT_ROUTE, SHORTER_DISTANCE oder DEFAULT_ROUTE_ALTERNATE ist.
    • 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 dazwischen ein.
  • Geben Sie den Parameter optimizeWaypointOrder nicht an.
  • Optional: Legen Sie eine Antwortfeldmaske fest, um die folgenden Eigenschaften zurückzugeben, die sowohl mit der Standardroute als auch mit der kürzeren Route verknüpft sind:
    • 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 kürzere Route. In diesem Beispiel verwenden Sie die Antwortfeldmaske, um Felder zurückzugeben, die sowohl mit der Standardroute als auch mit der kürzeren Route verknüpft sind. Verwenden Sie dazu 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 kürzerer 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 kraftstoffsparende Route

Der folgende Code zeigt eine Anfrage für eine kürzere Strecke und eine verbrauchsgünstige 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'

Beispiel für eine Antwort: Kürzere Strecke und spritsparende Route

In diesem Fall sind die kürzeste Entfernung und die sparsamste 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 der Google Maps Platform fallen keine zusätzlichen Kosten an. Die Gebühren richten sich nach Ihrer Nutzung der API und nach anderen von Ihnen festgelegten Parametern.

Weitere Informationen zur Abrechnung für die Routes API