Route für öffentliche Verkehrsmittel abrufen

Entwickler im Europäischen Wirtschaftsraum (EWR)

Eine ÖPNV-Route 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 für eine Transitstrecke in der Regel mehr als ein Verkehrsmittel erforderlich ist, unterscheidet sich die Art und Weise, wie Sie die Route anfordern, und einige Teile der Antwort.

Unterschiede zwischen ÖPNV-Routen und anderen Routen

Routen für öffentliche Verkehrsmittel, die Sie durch Festlegen von travelMode auf TRANSIT anfordern, unterscheiden sich von Routen mit anderen Mobilitätsformen. Sie können nicht alle Objekte und Optionen anfordern und die Antwort enthält im Vergleich zu anderen Routen unterschiedliche Felder.

In der Routes API ist ein Schritt immer eine Navigationsanweisung für alle Arten von Reisen. Jede Navigationsanweisung ist also ein Schritt. Eine Antwort für Transitrouten ähnelt Routen mit anderen Fortbewegungsmitteln, es gibt jedoch einige wichtige Unterschiede:

Unterschiede bei Anfragen Unterschiede bei den Antworten
Sie können keine Zwischenziele angeben. Enthält Details zum öffentlichen Nahverkehr.
Keine verbrauchsarmen Routen verfügbar Enthält Metadaten für jede Transportart, die die Zusammenfassung der Schritte für diese Transportart im stepsOverview enthält. Verwenden Sie die Feldmaske stepsOverview, um diese Metadaten anzufordern.
Es kann nicht angegeben werden, wie und ob Verkehrsdaten einbezogen werden sollen.
Zu vermeidende Routenfunktionen können nicht angegeben werden
Sie können nur transitPreferences angeben. Weitere Informationen finden Sie unter TransitPreference.

Route für öffentliche Verkehrsmittel abrufen

  1. Legen Sie Start- und Zielort fest.
  2. Legen Sie den Wert travelMode auf TRANSIT fest.
  3. Fügen Sie die entsprechenden Feldmasken hinzu, um die gewünschte Antwort zu erhalten. Weitere Informationen finden Sie unter Erforderliche Felder für ÖPNV-Routen anfordern.
  4. Legen Sie bei Bedarf optionale Parameter fest. Weitere Informationen

Felder für Transitrouten anfordern

Fordern Sie die benötigten Felder für die Transitstrecke mit Feldmasken an. In der folgenden Tabelle finden Sie einige vorgeschlagene Antworten für eine Transitstrecke und die Feldmaske, die Sie verwenden müssen, um sie anzufordern.

So fordern Sie diese Informationen an Diese Feldmaske verwenden
Alle Routendetails. *
Details zum öffentlichen Nahverkehr für Routenabschnitte. legs
Geschätzter Fahrpreis für jeden Schritt der Route und lokalisierter geschätzter Fahrpreis. travelAdvisory
Lokalisierter Text für Dauer und Entfernung localizedValues

Parameter für eine ÖPNV-Route festlegen

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

Aktivität Diesen Parameter verwenden Hinweise
Öffentliches Verkehrsmittel auswählen travelMode: "TRANSIT" Erforderlich. Weitere Informationen
Ankunfts- oder Abfahrtszeit festlegen arrivalTime: new Date(yyyy-mm-ddThh:mm:ssZ)

ODER

departureTime: new Date(yyyy-mm-ddThh:mm:ssZ)		 Optional. Sie können entweder die Ankunfts- oder die Abfahrtszeit angeben. Wenn keine Zeit angegeben ist, wird für departureTime standardmäßig die aktuelle Ausführungszeit (now) verwendet. Ankunfts- und Abfahrtszeiten können nur innerhalb des folgenden Zeitfensters festgelegt werden, wobei die aktuelle Ausführungszeit (now) als Referenz dient:
  • bis einschließlich 7 Tage vor dem now
  • bis einschließlich 100 Tage nach now
Die Zeit wird als Date-Objekt angegeben.

Hinweis: Fahrpläne für öffentliche Verkehrsmittel ändern sich häufig. Die verfügbaren Fahrten können sich im Laufe der Zeit ändern. Es gibt keine Garantie, dass Vorhersagen, die weit im Voraus erstellt werden, konsistente Ergebnisse liefern.
Ausweichrouten einbeziehen computeAlternativeRoutes: true Optional. Wenn diese Option auf „true“ gesetzt ist, berechnet computeRoutes bis zu drei zusätzliche Routen, sofern verfügbar. Weitere Informationen
Einstellungen für den Verkehrsmitteltyp angeben transitPreference: {allowedTransitModes: ["BUS", "SUBWAY", "TRAIN", "LIGHT_RAIL", "RAIL"]}

Hinweis: Wenn Sie eine bevorzugte Transportart angeben, können die zurückgegebenen Routen je nach Effizienz der Route und Verfügbarkeit der bevorzugten Transportart auch andere Transportarten verwenden oder nur andere Transportarten verwenden.

 Optional. Geben Sie bevorzugte Verkehrsmittel an. Weitere Informationen
Einstellungen für die Route mit öffentlichen Verkehrsmitteln festlegen transitPreference: {routingPreference: "LESS_WALKING|FEWER_TRANSFERS"} Optional. Einstellungen für Routen mit öffentlichen Verkehrsmitteln festlegen Weitere Informationen

Beispielanfrage

Das folgende Beispiel zeigt, wie man eine Transitroute anfordert:

const request = {
  origin: 'Hunters Point San Francisco, CA 94124',
  destination: '201 Marine Dr, San Francisco, CA 94129',
  travelMode: 'TRANSIT',
  departureTime: new Date(),
  transitPreference: {
    allowedTransitModes: ['BUS', 'SUBWAY', 'TRAIN', 'LIGHT_RAIL', 'RAIL'],
    routingPreference: 'FEWER_TRANSFERS', // Alternatively, 'LESS_WALKING'.
  },
  fields: ['path', 'legs', 'travelAdvisory', 'localizedValues'],
};