Compute Routes – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Entwickler im Europäischen Wirtschaftsraum (EWR)
Einführung
„Compute Routes“ ist eine Methode im Routes API-Dienst, die eine HTTPS-Anfrage akzeptiert und die ideale Route zwischen zwei Orten zurückgibt.
Stellen Sie Ihren Nutzern Wegbeschreibungen per öffentlichem Verkehrsmittel, Fahrrad, Auto, Motorrad oder zu Fuß bereit – inklusive Verkehrsinformationen in Echtzeit.
Benötigen Sie Routenmatrixen? Weitere Informationen zu Routenmatrix finden Sie unter Compute Route Matrix – Übersicht.
Migriert? Wenn Sie von der Distance Matrix API (alte Version) migrieren, lesen Sie die Migrationsanleitung ab Vorteile der Migration zur Routes API.
Vorteile von Compute Routes
Mit Compute Routes können Sie Ihre Fahrzeuge oder Pakete mithilfe einer Vielzahl von Routendetails nach Ihren Wünschen planen und gleichzeitig Kosten und Qualität optimieren.
Was kann ich mit Compute Routes tun?
Mit der Compute Routes-Methode der Routes API können Sie Folgendes tun:
Sie können Wegbeschreibungen für verschiedene Verkehrsmittel und für ein oder mehrere Ziele abrufen:
Mobilitätsformen: öffentliche Verkehrsmittel, Auto, Zweiräder, zu Fuß oder Fahrrad
Eine Reihe von Wegpunkten, die Sie für die effizienteste Reihenfolge der Fahrt zu ihnen optimieren können.
Es gibt mehrere Möglichkeiten, Start- und Zielorte sowie Wegpunkte anzugeben:
Textstrings Beispiele: „Chicago, IL“, „Darwin, NT, Australien“, „1800 Amphitheatre Parkway, Mountain View, CA 94043“ oder „CWF6+FWX Mountain View, Kalifornien“
Orts-IDs
Breiten- und Längengradkoordinaten, optional mit Fahrzeugkurs
Passen Sie die Routenoptionen an Ihre Anforderungen und Ziele an:
Verwalten Sie Latenz und Qualität, indem Sie mithilfe einer Feldmaske nur die Daten anfordern, die Sie benötigen. So vermeiden Sie unnötige Verarbeitungszeiten und höhere Abrechnungsraten für Anfragen. Weitere Informationen finden Sie unter Zurückzugebende Informationen auswählen.
So funktioniert „Compute Routes“
Die ComputeRoutes-Methode der Routes API akzeptiert eine HTTP-POST-Anfrage mit einem JSON-Anfragetext, der die Anfragedetails enthält. Erforderlich sind ein Ursprung, ein Ziel, travelMode und eine Feldmaske, mit der angegeben wird, welche Felder zurückgegeben werden sollen.
Beispiel
curl -X POST -d '{
"origin": {
"address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
},
"destination": {
"address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
Der Dienst berechnet dann die angeforderte Route und gibt die angeforderten Felder zurück.
Ressourcen
In der folgenden Tabelle sind die über die Methode „Compute Routes“ der Routes API verfügbaren Ressourcen zusammen mit den zurückgegebenen Daten zusammengefasst.
| Datenressourcen |
Zurückgegebene Daten |
Rückgabeformat |
| ComputeRoutes |
Gibt Routen, Abschnitte und Schritte für eine Route zurück, einschließlich alternativer Routen, falls angefordert. |
JSON |
Compute Routes verwenden
Verfügbare Clientbibliotheken
Eine Liste der verfügbaren Clientbibliotheken für Compute Routes finden Sie unter Clientbibliotheken.
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-06-20 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-06-20 (UTC)."],[],[],null,["# Compute Routes Overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n[](/maps/documentation/routes/demo)\n\nIntroduction\n------------\n\nCompute Routes is a method in the Routes API service that accepts\nan HTTPS request and returns the ideal route between two locations.\nProvide directions with real-time traffic for transit, biking, driving,\n2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Compute Route Matrix Overview](/maps/documentation/routes/compute-route-matrix-over).\n\n**Migrating?** If you are migrating from the Distance Matrix API (Legacy),\nsee migration instructions starting with\n[Why migrate to the Routes API](/maps/documentation/routes/migrate-routes-why).\n\nWhy use Compute Routes\n----------------------\n\nWith Compute Routes, with a wide\nrange of route details you can route your vehicles or packages according to\nyour preferences while optimizing for cost and quality.\n\nWhat you can do with Compute Routes?\n------------------------------------\n\nWith the Routes API `Compute Routes` method, you can\ndo the following things:\n\n- **Get directions for different ways to travel**, and for a single or\n multiple destinations:\n\n - Modes of transportation: transit, driving, two-wheel vehicles,\n walking, or bicycling.\n\n - A series of waypoints that you can optimize for the most efficient\n order in which to travel to them.\n\n- **Use multiple ways to specify origins, destinations, and waypoints**:\n\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800\n Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain\n View, California\"\n\n - Place IDs\n\n - Latitude and longitude coordinates, optionally with vehicle heading\n\n- **Fine-tune your route options** based on your needs and goals:\n\n - Select fuel or energy-efficient routes for your vehicle's engine type:\n Diesel, Electric, Hybrid, Gas. For more information, see\n [Get an eco-friendly route](/maps/documentation/routes/eco-routes#request_an_eco-friendly_route).\n\n - Set fine-grained options for traffic calculation, letting you make\n quality versus latency trade off decisions. For details, see\n [Specify how and if to include traffic data](/maps/documentation/routes/config_trade_offs).\n\n - Set vehicle heading (direction of travel) and side-of-road information\n for waypoints to increase ETA accuracy. For details, see\n [Specify vehicle heading and side of road](/maps/documentation/routes/location_modifiers).\n\n - Specify pass-through versus terminal locations and safe stopover\n locations. For details, see [Set a stop along a route](/maps/documentation/routes/stop_over) and\n [Set a point for a route to pass through](/maps/documentation/routes/pass-through).\n\n - Request toll information, along with route distance and ETA. For\n details, see\n [Calculate toll fees for a route](/maps/documentation/routes/calculate_toll_fees).\n\n- **Control your latency and quality** by requesting only the data you need\n using a field mask, which helps you avoid unnecessary processing time and\n higher request billing rates. For details, see\n [Choose what information to return](/maps/documentation/routes/choose_fields).\n\nHow Compute Routes works\n------------------------\n\nThe Routes API `ComputeRoutes` method accepts an HTTP POST request with\na JSON request body that contains the request details. Required are an origin,\ndestination, `travelMode`, and a field mask to specify which fields to return. \n\n#### Example\n\n```json\ncurl -X POST -d '{\n \"origin\": {\n \"address\": \"1800 Amphitheatre Parkway, Mountain View, CA 94043\"\n },\n \"destination\": {\n \"address\": \"Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132\"\n },\n \"travelMode\": \"DRIVE\"\n }' \\\n -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \\\n -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \\\n 'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\nThe service then calculates the requested route, and returns the fields you've\nrequested.\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoutes API Compute Routes method,\nalong with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|----------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------|\n| [ComputeRoutes](/maps/documentation/routes/compute_route_directions) | Returns routes, legs, and steps for a route, with alternate routes, if requested. | JSON |\n\n\u003cbr /\u003e\n\n### How to use Compute Routes\n\n|---|---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/routes/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Understand how the Routes API bills** | For information, see [Usage and billing](/maps/documentation/routes/usage-and-billing). |\n| 3 | **Compute a route and review the response** | For more information, see [Get a route](/maps/documentation/routes/compute_route_directions) and [Review the route responses](/maps/documentation/routes/understand-route-response). |\n\n### Available client libraries\n\nFor a list of the available client libraries for\nCompute Routes, see\n[Client libraries](/maps/documentation/routes/client-libraries).\n\nWhat's next\n-----------\n\n- [Get a route](/maps/documentation/routes/compute_route_directions)\n- [Available route options](/maps/documentation/routes/route-opt)\n- [Choose what information to return](/maps/documentation/routes/choose_fields)\n- [Migrate from Directions API (Legacy)](/maps/documentation/routes/migrate-routes)\n- [Migrate from the Routes API preview to GA](/maps/documentation/routes/migrate-routes-preview)"]]
