Genel Bakış
Google Haritalar için GTFS feed'lerinin sağlayıcısı değilseniz entegrasyonunuz yalnızca durak entegrasyonudur. Bu entegrasyon için farklı tren veya otobüs duraklarını nasıl tanımladığınızı anlamamız gerekiyor.
Genel feed spesifikasyonları
Entegrasyonu başlatırken her entegrasyon için benzersiz bir tanımlayıcı oluştururuz. Örneğin: ch_google_test (ülke kodu, iş ortağı adı, entegrasyon) veya eu_google (bölge kodu, iş ortağı adı).
İş ortakları, entegrasyon başına uygulanan CSV biçiminde metin dosyaları içeren bir dosya sağlar. Her CSV dosyası, ilgili feed spesifikasyon tablosunda belirtilen "Alan Adı" ile eşleşen sütun adlarını içeren bir başlık satırı içermelidir.
İş ortağının duraklar ve pazarlar dosyalarının yeni sürümlerini yüklemesine izin vermek için ekibimiz, oryantasyon süreci boyunca her dosya türü için bir tane olmak üzere SFTP Dropbox ayrıntılarını paylaşır.
Durdurma feed'i spesifikasyonu (zorunlu)
Durdurma dosyasında aşağıdaki sütunlar bulunmalıdır:
| Alan adı | Tür (GTFS'ye bakın) | Açıklama |
|---|---|---|
stop_id |
Kimlik (gerekli) | Bir durağı veya istasyonu tanımlayan benzersiz tanımlayıcı. Daha büyük istasyonlar yalnızca tek bir giriş içermelidir. Bu, iş ortağı sunucusu API'nize çağrı yaparken ve biletleme derin bağlantılarında kullanılır. |
stop_name |
Metin (zorunlu) | Hata ayıklama, eşlemeyi durdurma, önbelleği doldurma ve fiyat doğruluğu verileri için kullanıcılar tarafından okunabilecek bir ad. |
stop_lat |
Enlem (zorunlu) | Durağın enlemi. |
stop_lon |
Boylam (zorunlu) | Durağın boylamı. |
İş ortaklarının, içerdiği bilgiler değiştiğinde güncellenmiş ZIP dosyalarını sürekli olarak sağlayabileceği otomatik bir alım süreci kullanacağız. Örneğin, bir iş ortağı durak listesini genişleterek sağlanan envanteri artırabilir. Ancak GTFS'ye benzer şekilde stop_ids sabit olmalıdır.
Pazar grubu feed'i spesifikasyonu (isteğe bağlı)
Haritalandırılmış duraklarla, bu entegrasyon için pazar kümesini (popüler başlangıç / varış noktası çiftlerini içeren bir liste) oluştururuz. Buradan, bir pazar grubu feed'i sağlayarak bu pazar grubunu azaltma seçeneğiniz vardır.
Pazar grubu, önbellek doldurma hizmetimiz için izin verilenler listesi görevi görür. Varsayılan olarak, herhangi bir pazar grubu sağlanmazsa tüm pazarlar etkinleştirilir. Bir pazar grubu sağlarsanız yalnızca listede yer alan pazarlar sorgulanır. Kullanıcılar bu izin verilenler listesi dışındaki pazarlarda sorgu gönderirse sistemlerimiz yine de istenen pazar ve tarih için canlı sorgu gönderir ancak proaktif olarak önbelleğe almaya çalışmaz.
Pazar grubu dosyasında aşağıdaki sütunlar bulunmalıdır:
| Alan adı | Tür (GTFS'ye bakın) | Açıklama |
|---|---|---|
origin_stop_id |
Kimlik (gerekli) | Pazarın kaynağı stop_id. |
destination_stop_id |
Kimlik (gerekli) | Pazarın hedefi stop_id. |
İş Ortağı Yapılandırması
Yalnızca durdurma entegrasyonu kullanılırken İş Ortağı Yapılandırması bölümünde belirtildiği gibi statik iş ortağı yapılandırması için ek bilgiler gerekir.
Tavsiye bağlantıları spesifikasyonu
Rezervasyon bağlantısının (Ticketing link olarak da bilinir) biçimi ve parametreleri Biletleme Bağlantıları bölümünde tanımlanır.
İş ortağı API parametreleri
İş Ortağı API'si (GetBulkTripOptionsRequest) için SegmentKeys parametreleri, derin bağlantı spesifikasyonuna dayanır. Yalnızca from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time ve arrival_time'ı içeren SegmentKeys'i kullanıyoruz. ticketing_trip_id boş bırakılıyor. Segment başına bir SegmentKey belirterek tüm aktarmalar dahil rotayı tam olarak belirteceğiz.