Format für Suchlinks

Für Suchlinks stellen Partner eine suchspezifische Basis-URL bereit (siehe Partnerkonfiguration). Wir unterstützen die folgenden Abfrageparameter:

Feldname Details
from_stop_id

(Wiederholbar) Die Kennung der Haltestellen, an denen die Fahrt beginnen kann.

Die Werte der stop_ids der Abfahrtsbahnhöfe.
to_stop_id

(Wiederholbar) Die Kennung der Haltestellen, an denen die Fahrt enden kann.

Die Werte der stop_id der Zielstationen.
search_date

(Datum) Betriebstag der Fahrt.

Dieses Feld enthält das Datum mit dem folgenden Formatstring:

YYYYMMDD
lang

(IETF BCP 47, optional) Feld zur Angabe der ausgewählten Sprache der Buchungswebsite.

Der Wert dieses Felds entspricht IETF BCP 47, z.B. en-US.

Wenn die ausgewählte Sprache nicht verfügbar ist oder das Feld nicht übergeben wird, sollte auf der Buchungswebsite eine Fallback-Sprache verwendet werden.
cur

(ISO 4217, optional) Feld zur Angabe der Währung, in der Preise angezeigt werden sollen.

Der Wert dieses Felds entspricht ISO 4217, z.B. USD.

Wenn die ausgewählte Währung nicht angezeigt werden kann oder das Feld nicht übergeben wird, sollte auf der Buchungswebsite eine Fallback-Währung verwendet werden.
utm_source

(String, optional) Feld, das verwendet wird, um die Website der obersten Ebene anzugeben, von der der Traffic gesendet wurde.

Die möglichen Werte sind google_search und google_maps.

Alle wiederholbaren Parameter werden als JSON-Array angegeben. Für from_stop_id und to_stop_id stehen mehrere Werte für mehrere Stationen am Start- und Zielort.

Beispiele

In diesem Beispiel fragt der Nutzer nach Zügen von locality1 nach locality2:

  • locality1 entspricht Sendern mit den stop_ids f1 und f2.
  • locality2 entspricht Sendern mit den stop_ids t1 und t2.
  • Das Servicedatum ist 20190716.

In diesem Beispiel lautet die Basis-URL https://example.com.

Unter Berücksichtigung all dieser Informationen verwenden Sie die folgenden Werte für die Parameter:

Feldname Details
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

Nach der Codierung sieht der endgültige URI so aus:

https://example.com?from_stop_id=%5B%22f1%22,%22f2%22%5D&to_stop_id=%5B%22t1%22,%22t2%22%5D&search_date=20190716

Auf der Landingpage kann der Nutzer Routen ab den Bahnhöfen f1 und f2 am 20190716 mit Ankunft an den Bahnhöfen t1 und t2 aufrufen. Alle Senderkombinationen werden unterstützt:

  • Von f1 bis t1
  • Von f1 bis t2
  • Von f2 bis t1
  • Von f2 bis t2