Format linku wyszukiwania

W przypadku linków do wyszukiwania partnerzy podają podstawowy adres URL wyszukiwania (patrz Konfiguracja partnera). Obsługujemy te parametry zapytania:

Nazwa pola Szczegóły
from_stop_id

(Powtarzalny) Identyfikator przystanków, na których może się rozpocząć podróż.

Wartości stop_id stacji odjazdu.
to_stop_id

(Powtarzalny) Identyfikator przystanków, na których może zakończyć się podróż.

Wartości stop_id stacji docelowych.
search_date

(Date) Dzień podróży, w którym usługa jest świadczona.

To pole zawiera datę w tym formacie:

YYYYMMDD
lang

(IETF BCP 47, opcjonalnie) Pole używane do określania wybranego języka witryny rezerwacyjnej.

Wartość tego pola jest zgodna z IETF BCP 47, np. en-US.

Jeśli wybrany język jest niedostępny lub pole nie zostało przekazane, witryna rezerwacyjna powinna użyć języka zastępczego.
cur

(ISO 4217, opcjonalnie) Pole używane do określania waluty, w której powinny być wyświetlane ceny.

Wartość tego pola jest zgodna z normą ISO 4217, np. USD.

Jeśli wybranej waluty nie można wyświetlić lub pole nie zostało przekazane, witryna rezerwacji powinna użyć waluty zastępczej.
utm_source

(Ciąg znaków, opcjonalnie) Pole używane do wskazywania witryny najwyższego poziomu, która wysłała ruch.

Możliwe wartości to google_search i google_maps.

Wszystkie powtarzalne parametry są podawane jako tablica JSON. W przypadku parametrów from_stop_id i to_stop_id wiele wartości oznacza wiele stacji w miejscowościach początkowej i docelowej.

Przykłady

W tym przykładzie użytkownik wyszukuje pociągi na trasie locality1–locality2:

  • locality1 odpowiada stacjom z stop_id f1 i f2.
  • locality2 odpowiada stacjom z stop_id t1 i t2.
  • Data usługi to 20190716.

W tym przykładzie podstawowy adres URL to https://example.com.

Na podstawie tych informacji użyj tych wartości parametrów:

Nazwa pola Szczegóły
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

Oto końcowy identyfikator URI po zakodowaniu:

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

Na stronie docelowej użytkownik będzie mógł wyświetlić trasy odjeżdżające ze stacji f1 i f2 w dniu 20190716 oraz przyjeżdżające do stacji t1 i t2. Obsługiwane są wszystkie kombinacje stacji:

  • Od f1 do t1
  • Od f1 do t2
  • Od f2 do t1
  • Od f2 do t2