Sözlük

Bu sözlükte, Transport Partner Integration (Ulaşım İş Ortağı Entegrasyonu) belgelerinde kullanılan temel terimler tanımlanmaktadır.

Rezervasyon jetonu: Google'ın arama sonuçları ile iş ortağının rezervasyon sayfası arasında fiyat ve seyahat planı tutarlılığını korumaya yardımcı olmak için biletleme derin bağlantısında iletilebilen, iş ortağı tarafından oluşturulan isteğe bağlı bir dizedir.

Canonical JSON Mapping: Bir proto mesajını JSON nesnesine dönüştürmek için Protocol Buffers tarafından tanımlanan belirli bir kural grubu. Bu entegrasyon, isteklerin ve yanıtların doğru şekilde biçimlendirilmesi için bu eşlemenin belirli seçeneklerle kullanılmasını gerektirir.

GTFS (Genel Toplu Taşıma Feed Spesifikasyonu): Toplu taşıma kurumlarının yolculara tarife, rota ve ücret bilgileri sağlamak için kullandığı standart bir veri biçimi. Bu entegrasyonda, Google'a statik veri sağlamanın iki yolundan biridir.

GTFS tabanlı entegrasyon: Kendi program verilerini Google'a GTFS feed'i olarak sağlayan iş ortakları için bir entegrasyon yöntemidir. Bu, Google'ın operatörün programlarına sahip olmadığı durumlarda kullanılır.

known_itineraries: İş ortaklarının yanıtlarını optimize etmek için Google'dan bilinen seyahat planlarının listesini almasına olanak tanıyan bir iş ortağı yapılandırması seçeneği.

Pazar Yeri Seti: (Yalnızca durdurma entegrasyonu için) İş ortağı tarafından, fiyatlandırma sağlayacağı belirli bir başlangıç-hedef çiftleri (pazarlar) listesini tanımlamak için sağlanan isteğe bağlı bir feed. Sağlanırsa izin verilenler listesi olarak işlev görür.

İş Ortağı API'si / İş Ortağı Sunucusu API'si: İş ortaklarının Google'a gerçek zamanlı fiyatlandırma ve müsaitlik durumu gibi dinamik veriler sağlamak için uygulaması gereken API'ler kümesi.

Fiyat Kalitesi Testi: Google'ın tarayıcılarının, kullanıcılara gösterilen fiyatların iş ortağı API'si aracılığıyla sağlanan fiyatlarla eşleştiğini doğrulamak için iş ortağının web sitesindeki seyahat planlarından örnek aldığı sürekli bir süreçtir.

QPS (Saniyedeki Sorgu Sayısı): Google'ın iş ortağı API sunucusuna istek gönderme ortalama hızı (bir sorgu bir istektir). Bu oran, biraz daha yüksek veya düşük trafik dönemleriyle birlikte dalgalanabilir.

SegmentKey: Kalkış, varış ve hizmet tarihleri/saatleri dahil olmak üzere bir yolculuğun tek bir ayağını benzersiz şekilde tanımlamak için İş Ortağı API'sinde kullanılan bir nesne.

service_date: Bir toplu taşıma hizmetinin çalıştığı belirli tarih, YYYYMMDD biçiminde. Benzersiz bir gezi örneğini belirtmek için diğer tanımlayıcılarla birlikte kullanılır.

Yalnızca durdurma entegrasyonu: Program verilerinin kaynağı olmayan iş ortakları için bir entegrasyon yöntemi. Bu, Google'ın operatörün programlarını başka bir kaynaktan zaten aldığı durumlarda kullanılır. İş ortaklarının yalnızca durak kimliklerinin bir listesini sağlaması gerekir.

ticketing_stop_id: İş ortağının bir durak veya istasyon için benzersiz tanımlayıcısı. Bu kimlik, statik veri feed'inde (GTFS veya yalnızca durak) sağlanır ve Partner API'de ve biletleme derin bağlantılarında kullanılır.

ticketing_trip_id: (GTFS tabanlı entegrasyon için) İş ortağının, GTFS feed'inin trips.txt dosyasında sağlanan belirli bir yolculuk için benzersiz tanımlayıcısı. Yalnızca GTFS tabanlı entegrasyonlar.

Biletleme Derin Bağlantısı: Kullanıcıyı Google'ın arama sonuçlarından belirli bir seyahat planı için rezervasyon yapmaya yönelik olarak iş ortağının web sitesine yönlendiren URL. URL, seçilen geziyle ilgili kodlanmış ayrıntılar içerir.

TripOptionsErrorType: Bir isteğin neden başarısız olduğu hakkında daha ayrıntılı bilgi sağlamak için İş Ortağı API'sinde döndürülebilen belirli bir hata türleri grubu.

UNSPECIFIED Enum Değeri: Protocol Buffers kullanılırken herhangi bir enum tanımında gerekli olan ilk değer (0 sayısal değeriyle). Bu değer, varsayılan değer olarak kullanılır ve bir istekte alındığında genellikle hata olarak değerlendirilmelidir.