Salt Durdurulan Entegrasyon

Genel Bakış

Google Haritalar için GTFS feed'lerinin sağlayıcısı değilseniz entegrasyonunuz yalnızca durak şeklindedir. Bu entegrasyon için farklı tren veya otobüs duraklarını nasıl tanımladığınızı anlamamız gerekir.

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ı, dünya genelinde veya entegrasyon başına uygulanan CSV biçimindeki metin dosyalarını içeren bir ZIP dosyası sağlayabilir:

Örnek 1:

  • ch_google_test_stops.txt
  • ch_google_test_markets.txt

Örnek 2:

  • stops.txt (tüm entegrasyonlara uygulanır)
  • eu_google_integration1_markets.txt
  • eu_google_integration2_markets.txt

Duraklatma feed'i spesifikasyonu (zorunlu)

Durdurma dosyası aşağıdaki sütunları içermelidir:

Alan adı Tür (GTFS'ye bakın) Açıklama
stop_id Kimlik (gerekli) Bir durağı veya istasyonu tanımlayan benzersiz tanımlayıcı. Büyük istasyonlar yalnızca tek bir giriş içermelidir. Bu, iş ortağı sunucu API'nize çağrı yapılırken ve biletleme derin bağlantılarında kullanılır.
stop_name Metin (zorunlu) Durak eşleme, önbelleğe doldurma ve fiyat doğruluğu verilerinde hata ayıklama için kullanıcı tarafından okunabilen bir ad.
stop_lat Enlem (zorunlu) Durağın enlemi.
stop_lon Boylam (zorunlu) Durağın boylamı.

İş ortaklarının, içindeki bilgiler değiştiğinde sürekli olarak güncellenmiş ZIP dosyaları sağlayabileceği otomatik bir besleme süreci kullanacağız. Örneğin, bir iş ortağı durak listesini genişleterek sağlanan envanteri genişletebilir. Ancak GTFS'ye benzer şekilde, stop_ids sabit olmalıdır.

Pazar grubu feed spesifikasyonu (isteğe bağlı)

Haritalanmış duraklarla bu entegrasyon için pazar grubunu (popüler başlangıç / varış çiftlerini içeren bir liste) oluştururuz. Buradan, bir pazar grubu feed'i sağlayarak bu pazar grubunu azaltabilirsiniz.

Pazar yeri grubu, izin verilenler listesi gibi çalışır: Pazar yeri grubu sağlanmazsa entegrasyonda tüm pazarlar etkinleştirilir. Bir pazar grubu sağlanırsa listede bulunmayan tüm pazarlar devre dışı bırakılır.

Pazar grubu dosyası aşağıdaki sütunları içermelidir:

Alan adı Tür (GTFS'ye bakın) Açıklama
origin_stop_id Kimlik (gerekli) Pazarın stop_id kaynağı.
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.

Derin bağlantının biçimi ve parametreleri Bilet bağlantıları bölümünde tanımlanmıştır.

İş Ortağı API parametreleri

Partner API (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'yi içeren SegmentKeys kullanırız. ticketing_trip_id boş bırakılır. Her segment için bir tane olmak üzere birden fazla SegmentKey belirterek tüm aktarımlar dahil olmak üzere rotayı tam olarak belirtiriz.