Route für öffentliche Verkehrsmittel abrufen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Eine Route mit öffentlichen Verkehrsmitteln enthält Navigationsanweisungen für die in der Region verfügbaren öffentlichen Verkehrsmittel. Zu den Optionen für öffentliche Verkehrsmittel gehören unter anderem Busse, U-Bahnen und Züge. Eine Route für öffentliche Verkehrsmittel enthält in der Regel auch Anweisungen zum Gehen zu, von und zwischen Haltestellen. Da eine Route mit öffentlichen Verkehrsmitteln in der Regel mehrere Verkehrsmittel erfordert, unterscheiden sich die Anfrage der Route und einige Teile der Antwort.

Unterschiede zwischen Transitrouten und anderen Routen

Routen mit öffentlichen Verkehrsmitteln, die Sie mit dem travelMode TRANSIT anfordern, unterscheiden sich von Routen mit anderen travelMode-Optionen. Sie können nicht dieselben Objekte und Optionen anfordern und die Antwort gibt im Vergleich zu anderen Routen andere Felder zurück.

In der Routes API ist ein Schritt bei allen Reisearten immer eine Navigationsanweisung. Jede Navigationsanweisung ist also ein Schritt. Eine Antwort für eine Route mit öffentlichen Verkehrsmitteln ähnelt Routen mit anderen Mobilitätsformen, es gibt jedoch einige wichtige Unterschiede:

Unterschiede bei Anfragen Unterschiede bei den Antworten
Sie können keine Zwischenwegpunkte angeben. Enthält Details zu öffentlichen Verkehrsmitteln.
Verbrauchsarme Routen können nicht abgerufen werden Enthält Metadaten für jeden Reisemodus, die die Zusammenfassung der Schritte für diesen Reisemodus in „stepsOverview“ enthalten. Verwenden Sie die Feldmaske „routes.legs.stepsOverview“, um diese Metadaten anzufordern.
Es kann nicht angegeben werden, ob und wie Verkehrsdaten einbezogen werden sollen
Zu vermeidende Routenmerkmale können nicht angegeben werden
transitPreferences kann nur für routingPreference angegeben werden. Weitere Informationen finden Sie unter TransitPreferences.

Weitere Informationen zur Antwort der Routes API finden Sie unter Antworten für Routen mit öffentlichen Verkehrsmitteln prüfen.

Route für öffentliche Verkehrsmittel abrufen

  1. Legen Sie den Start- und Zielort fest.

  2. Legen Sie die Mobilitätsform auf „Öffentliche Verkehrsmittel“ fest:

    travelMode: "TRANSIT"

  3. Fügen Sie eine Feldmaske hinzu, um die gewünschten Antwortfelder zu erhalten. Weitere Informationen finden Sie unter Erforderliche Felder für die Transitroute anfordern.

  4. Legen Sie bei Bedarf optionale Parameter fest. Weitere Informationen finden Sie unter Parameter für eine Transitroute festlegen.

Felder für die Route mit öffentlichen Verkehrsmitteln anfordern, die Sie benötigen

Fordern Sie die benötigten Felder für die Transitroute mithilfe von Feldmasken an. Die folgende Tabelle enthält einige vorgeschlagene Antworten für eine Route mit öffentlichen Verkehrsmitteln und die Feldmaske, die Sie verwenden müssen, um sie anzufordern.

So fordern Sie diese Informationen an: Diese Feldmaske verwenden
Alle Routendetails routes.*
Alle Details zu öffentlichen Verkehrsmitteln routes.legs.steps.transitDetails
Startort für jeden Abschnitt routes.legs.steps.startLocation
Zielort für jeden Abschnitt routes.legs.steps.endLocation
Routen-Polylinie für jeden Schritt routes.legs.steps.polyline
Art des öffentlichen Verkehrsmittels, das für jeden Schritt verwendet wird routes.legs.steps.travelMode
Geschätzter Fahrpreis für jeden Schritt und die Route sowie lokalisierter geschätzter Fahrpreis routes.travel_advisory.transitFare localized routes.localizedValues.transitFare

Hinweis: transitFare wird nur angegeben, wenn die API für alle Schritte Fahrpreisinformationen für öffentliche Verkehrsmittel ermitteln kann.

Lokalisierter Text für Dauer und Entfernung routes.localizedValues

Weitere Informationen zum Festlegen von Feldmasken finden Sie unter Felder für die Rückgabe auswählen.

Parameter für eine Transitroute festlegen

Hier sind die relevanten Parameter für Routen mit öffentlichen Verkehrsmitteln:

Gehen Sie dazu so vor: Diesen Parameter verwenden Hinweise
Öffentliche Verkehrsmittel 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“ oder „departure_time“ angeben. Wenn keine der beiden Zeiten angegeben ist, wird für departure_time standardmäßig die aktuelle Ausführungszeit (now) verwendet. Sie können Ankunfts- und Abfahrtszeiten nur innerhalb des folgenden Zeitfensters festlegen, wobei die aktuelle Ausführungszeit (now) als Referenz dient:
  • bis zu 7 Tage vor dem now
  • bis zu 100 Tage nach dem now
Die Zeit wird als Zeitstempel im Format RFC3339 UTC „Zulu“ angegeben. Weitere Informationen

Hinweis: Fahrpläne ändern sich häufig. Die verfügbaren Fahrten können sich im Laufe der Zeit ändern und es gibt keine Garantie für konsistente Ergebnisse bei Vorhersagen, die weit im Voraus getroffen werden.

Alternative Routen einbeziehen "computeAlternativeRoutes": true Optional. Legen Sie „true“ fest, damit Compute Routes bis zu drei zusätzliche Routen berechnet, sofern verfügbar. Weitere Informationen
Einstellungen für den Typ des öffentlichen Verkehrsmittels festlegen "transitPreferences": { allowedTravelModes: ["BUS","SUBWAY","TRAIN","LIGHT_RAIL","RAIL"]}

Hinweis: Wenn Sie ein bevorzugtes Verkehrsmittel angeben, können die zurückgegebenen Routen je nach Effizienz der Route und Verfügbarkeit des bevorzugten Verkehrsmittels auch andere Verkehrsmittel verwenden oder sogar nur andere Verkehrsmittel.

Optional. Bevorzugte Mobilitätsformen für öffentliche Verkehrsmittel angeben Weitere Informationen
Einstellungen für die Route mit öffentlichen Verkehrsmitteln festlegen "transitPreferences": {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} Optional. Geben Sie die Einstellungen für das Transit-Routing an. Weitere Informationen

Beispiel: Route für öffentliche Verkehrsmittel abrufen

Im folgenden Beispiel wird eine Route mit öffentlichen Verkehrsmitteln mit den folgenden Parametern abgerufen:

  • Gibt die Präferenz für Zugfahrten und kurze 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
          }
        },
        {},
        {},
        {},
        {},
        {},
        {}
        ]
      }
    ]
  }
]
}