Arama bağlantısı biçimi

Arama bağlantıları için iş ortakları aramaya özel bir temel URL sağlar (bkz. İş Ortağı Yapılandırması). Aşağıdaki sorgu parametrelerini destekliyoruz:

Alan adı Ayrıntılar
from_stop_id

(Tekrarlanabilir) Gezinin başlayabileceği durakların tanımlayıcısı.

Kalkış istasyonlarının stop_id değerleri.
to_stop_id

(Tekrarlanabilir) Gezinin sona erebileceği durakların tanımlayıcısı.

Hedef istasyonların stop_id değerleri.
search_date

(Tarih) Gezinin hizmet günü.

Bu alan, aşağıdaki biçim dizesiyle tarihi içerir:

YYYYMMDD
lang

(IETF BCP 47, isteğe bağlı) Rezervasyon sitesinin seçili dilini belirtmek için kullanılan alan.

Bu alanın değeri, IETF BCP 47'ye uygundur (ör. en-US).

Seçilen dil kullanılamıyorsa veya alan iletilmiyorsa rezervasyon sitesi, yedek bir dil kullanmalıdır.
cur

(ISO 4217, isteğe bağlı) Fiyatların gösterileceği para birimini belirtmek için kullanılan alan.

Bu alanın değeri ISO 4217'ye uygundur (ör. USD).

Seçilen para birimi gösterilemiyorsa veya alan iletilmiyorsa rezervasyon sitesi, yedek para birimi kullanmalıdır.
utm_source

(Dize, İsteğe Bağlı) Trafiği gönderen üst düzey siteyi belirtmek için kullanılan alan.

Olası değerler google_search ve google_maps'dir.

Tekrarlanabilir tüm parametreler JSON dizisi olarak belirtilir. from_stop_id ve to_stop_id için birden fazla değer, başlangıç ve varış noktası yerleşim birimlerindeki birden fazla istasyonu ifade eder.

Örnekler

Bu örnekte, kullanıcı locality1 ile locality2 arasındaki trenleri sorguluyor:

  • locality1, stop_id f1 ve f2 olan istasyonlarla eşlenir.
  • locality2, stop_id t1 ve t2 olan istasyonlarla eşlenir.
  • Hizmet tarihi 20190716.

Bu örnekte, temel URL https://example.com'dır.

Tüm bu bilgiler ışığında, parametreler için aşağıdaki değerleri kullanın:

Alan adı Ayrıntılar
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

Kodlamadan sonraki nihai URI şu şekildedir:

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

Kullanıcı, açılış sayfasında 20190716 tarihinde f1 ve f2 istasyonlarından kalkıp t1 ve t2 istasyonlarına varan seyahat planlarını görebilir. Tüm istasyon kombinasyonları desteklenir:

  • f1 - t1 arası
  • f1 - t2 arası
  • f2 - t1 arası
  • f2 - t2 arası