Eine Route für öffentliche Verkehrsmittel bietet eine Anleitung für die Navigation mit öffentlichen Verkehrsmitteln. die in der Region verfügbar sind. Mögliche Verkehrsmittel sind Busse, U-Bahnen und Zügen usw. Eine Route für öffentliche Verkehrsmittel enthält in der Regel auch eine Anleitung zum Gehen zu, von und zwischen den Haltestellen. Da eine Route für öffentliche Verkehrsmittel müssen Sie normalerweise mehrere Mobilitätsformen nutzen. und einige Teile der Antwort unterscheiden sich.
Unterschiede zwischen Routen mit öffentlichen Verkehrsmitteln und anderen Routen
Routen mit öffentlichen Verkehrsmitteln, die Sie durch Festlegen eines „travelMode“ von TRANSIT anfordern, unterscheiden sich von Routen mit verschiedenen „travelMode“-Optionen unterscheiden. Sie können nicht alle Objekte und Optionen anfordern. Die Antwort gibt im Vergleich zu anderen Routen.
In der Routes API stellen Schritte durchgängig eine Navigationsanweisung dar. für alle Arten von Reisen. Jede Navigationsanweisung ist also ein Schritt. Eine Antwort für öffentliche Verkehrsmittel ähnelt sehr stark der Antwort für andere Verkehrsmittel, mit einigen wichtigen Unterschieden:
Unterschiede bei Anfragen | Antwortunterschiede |
---|---|
Wegpunkte können nicht angegeben werden. | Umfasst Details zu öffentlichen Verkehrsmitteln. |
Keine umweltfreundlichen Routen verfügbar | Enthält Metadaten für jede Mobilitätsform, die die Zusammenfassung der Schritte für Mobilitätsform aus. Verwenden Sie zum Anfordern dieser Metadaten die Methode Feldmaske „routes.legs.stepsOverview“). |
Es kann nicht angegeben werden, wie und ob Verkehrsdaten eingeschlossen werden sollen | |
Es können keine Routenfunktionen angegeben werden, die vermieden werden sollen | |
transitPreferences kann nur angegeben werden für
routingPreference . Weitere Informationen finden Sie unter [TransitPreferences](reference/rest/v2/TransitPreferences). |
Weitere Informationen zur von der Routes API zurückgegebenen Antwort finden Sie unter Antworten zu öffentlichen Verkehrsmitteln überprüfen.
Route mit öffentlichen Verkehrsmitteln berechnen
Legen Sie Ihren Start- und Zielort fest.
Mobilitätsform als Mobilitätsform festlegen:
travelMode: "TRANSIT"
Fügen Sie eine Feldmaske hinzu, um die gewünschten Antwortfelder abzurufen. Weitere Informationen finden Sie unter Erforderliche Felder für ÖPNV-Routen anfordern.
Legen Sie bei Bedarf optionale Parameter fest. Weitere Informationen finden Sie unter Parameter für eine ÖPNV-Route festlegen.
Benötigte Felder für Routen mit öffentlichen Verkehrsmitteln anfordern
Fordern Sie die benötigten Felder für die Route mit Feldmasken an. In der folgenden Tabelle enthält einige Antwortvorschläge für eine öffentliche Verkehrsmittel Route und die Feldmaske, mit der sie angefordert werden sollen.
Um diese Informationen anzufordern | Diese Feldmaske verwenden |
---|---|
Alle Routendetails | routes.* |
Alle Details zu öffentlichen Verkehrsmitteln | routes.legs.steps.transitDetails |
Startort für jeden Streckenabschnitt | routes.legs.steps.startLocation |
Endposition für jeden Abschnitt | routes.legs.steps.endLocation |
Polylinie für jeden Schritt | routes.legs.steps.polyline |
Art des öffentlichen Verkehrsmittels, das für jeden Schritt verwendet wird | routes.legs.steps.travelMode |
den geschätzten Fahrpreis für jeden Schritt und die Route Lokalisierter geschätzter Preis | routes.travel_advisory.transitFare
localized routes.localizedValues.transitFare
Hinweis: |
Lokalisierter Text für Dauer und Entfernung | routes.localizedValues |
Weitere Informationen zum Festlegen von Feldmasken finden Sie unter Wählen Sie die Felder aus, die zurückgegeben werden sollen.
Parameter für eine Route mit öffentlichen Verkehrsmitteln festlegen
Relevante Parameter für Routen mit öffentlichen Verkehrsmitteln:
Aktion | Diesen Parameter verwenden | Hinweise |
---|---|---|
Mobilitätsform auswählen | travelMode: "TRANSIT" |
Erforderlich. Weitere Informationen |
Ankunfts- oder Abfahrtszeit festlegen | "arrivalTime": "yyyy-mm-ddThh:mm:ssZ"
ODER "departureTime": "yyyy-mm-ddThh:mm:ssZ" |
Optional. Sie können entweder „arrival_time“ (Ankunftszeit) oder „pickup_time“ (Abreisezeit) angeben. Wenn
keine Zeit angegeben ist, wird für departure_time standardmäßig die
aktuelle Ausführungszeit (now ). Sie können Ankunfts- und
Abfahrtszeiten nur im folgenden Zeitfenster, mit den aktuellen
Ausführungszeit (now ) als Referenz:
|
Alternative Routen einschließen | "computeAlternativeRoutes": true |
Optional. Legen Sie dies auf „true“ fest, damit die Routes API bis zu drei berechnet zusätzliche Routen, falls verfügbar. Weitere Informationen |
Einstellungen für die Mobilitätsform festlegen | "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}
Hinweis: Wenn Sie eine bevorzugte Mobilitätsform angeben, können zurückgegebene Routen möglicherweise weiterhin andere Verkehrsmittel nutzen, auch nur andere, je nach die Effizienz der Route und die Verfügbarkeit der bevorzugten auf Reisen. |
Optional. Geben Sie die bevorzugten Mobilitätsformen an. Weitere Informationen |
Einstellungen für die Route mit öffentlichen Verkehrsmitteln festlegen | "transitPreferences": {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} |
Optional. Legen Sie Einstellungen für die Routenplanung für öffentliche Verkehrsmittel fest. Weitere Informationen |
Beispiel: Route für öffentliche Verkehrsmittel abrufen
Im folgenden Beispiel wird eine Route mit öffentlichen Verkehrsmitteln mit den folgenden Parametern abgerufen:
Gibt Präferenzen für Zugfahrten und kürzere Fußwege an.
Fordert alternative Routen an.
Stellt eine Feldmaske bereit, die die Details zu öffentlichen Verkehrsmitteln zurückgibt:
curl -X POST -H 'content-type: application/json' -d '{ "origin": { "address": "Humberto Delgado Airport, Portugal" }, "destination": { "address": "Basílica of Estrela, Praça da Estrela, 1200-667 Lisboa, Portugal" }, "travelMode": "TRANSIT", "computeAlternativeRoutes": true, "transitPreferences": { routingPreference: "LESS_WALKING", allowedTravelModes: ["TRAIN"] }, }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.legs.steps.transitDetails' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Die Antwort enthält route.legs.steps.transitDetails
-Felder für die beiden Routen:
{ "routes": [ { "legs": [ { "steps": [ {}, {}, {}, { "transitDetails": { "stopDetails": { "arrivalStop": { "name": "Saldanha", "location": { "latLng": { "latitude": 38.73532, "longitude": -9.14543 } } }, "arrivalTime": "2023-08-26T10:49:42Z", "departureStop": { "name": "Aeroporto", "location": { "latLng": { "latitude": 38.769047799999996, "longitude": -9.1284593 } } }, "departureTime": "2023-08-26T10:32:10Z" }, "localizedValues": { "arrivalTime": { "time": { "text": "11:49" }, "timeZone": "Europe/Lisbon" }, "departureTime": { "time": { "text": "11:32" }, "timeZone": "Europe/Lisbon" } }, "headsign": "São Sebastião", "transitLine": { "agencies": [ { "name": "Metropolitano de Lisboa, E.P.E.", "phoneNumber": "+351 21 350 0115", "uri": "https://www.metrolisboa.pt/" } ], "name": "Vermelha", "color": "#f23061", "nameShort": "Vm", "textColor": "#000000", "vehicle": { "name": { "text": "Metrô" }, "type": "SUBWAY", "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png" } }, "stopCount": 11 } }, {}, { "transitDetails": { "stopDetails": { "arrivalStop": { "name": "Rato", "location": { "latLng": { "latitude": 38.7201022, "longitude": -9.1540562 } } }, "arrivalTime": "2023-08-26T11:01:37Z", "departureStop": { "name": "Saldanha", "location": { "latLng": { "latitude": 38.73527, "longitude": -9.1455200000000012 } } }, "departureTime": "2023-08-26T10:57:57Z" }, "localizedValues": { "arrivalTime": { "time": { "text": "12:01" }, "timeZone": "Europe/Lisbon" }, "departureTime": { "time": { "text": "11:57" }, "timeZone": "Europe/Lisbon" } }, "headsign": "Rato", "transitLine": { "agencies": [ { "name": "Metropolitano de Lisboa, E.P.E.", "phoneNumber": "+351 21 350 0115", "uri": "https://www.metrolisboa.pt/" } ], "name": "Amarela", "color": "#f2c200", "nameShort": "Am", "textColor": "#000000", "vehicle": { "name": { "text": "Metrô" }, "type": "SUBWAY", "iconUri": "//maps.gstatic.com/mapfiles/transit/iw2/6/subway2.png" } }, "stopCount": 4 } }, {}, {}, {}, {}, {}, {} ] } ] } ] }