Genel Toplu Taşıma Feed Spesifikasyonu (GTFS), toplu taşıma tarifeleri ve ilgili coğrafi bilgiler için mevcut bir biçimdir. GTFS tabanlı entegrasyon, seyahat ve ulaşım entegrasyonunun 1. adımını (statik verilerin feed'ini sağlama) tamamlamak için GTFS'yi ve Google Transit Ticketing uzantılarını kullanır.
İş Ortağı Sunucusu API'si, GTFS tarafından sağlanan ticketing_trip_id gibi tanımlayıcıları kullanır. Bu nedenle, API'nin kullanılabilmesi için geçerli bir GTFS feed'i olması gerekir.
Geçerli bir GTFS feed'i sağlamak için lütfen aşağıdaki adımları uygulayın.
Statik GTFS feed'i oluşturma
Kullanıcıların GTFS tabanlı entegrasyonu kullanarak şehirler arası seyahat için rotaları ve programları arayıp bulabilmesi için iş ortaklarından GTFS feed'i gerekir. GTFS feed'i verileri, tarifeler, rotalar ve biletleme bilgileriyle ilgili statik bilgiler içerir. Bu bilgiler daha sonra Google tarafından iş ortağı API'sine bağlanmak için kullanılır.
1. Toplu taşıma hesabı oluşturma
Henüz tamamlanmadıysa lütfen Google Transit'i kullanmaya başlama başlıklı makaleye gidin ve hesap isteğinde bulunmak için formu kullanın. İnceleme tamamlandıktan sonra bir hesap oluşturulur ve GTFS gösterge tablosu kullanıma sunulur. Kontrol paneline erişme ve kontrol panelini yapılandırma hakkında ayrıntılı bilgi için Transit İş Ortağı Kontrol Paneli'ne erişme başlıklı makaleyi inceleyin.
2. Uzantılarla GTFS feed'inizi oluşturma
Google Transit Ticketing uzantılarının gerekli bölümlerini içeren GTFS feed'inizi oluşturun (GTFS uzantıları bölümünde daha fazla ayrıntı verilmiştir). En iyi kullanıcı deneyimini sağlamak için lütfen GTFS kalite koşullarını ve en iyi uygulamaları okuyup uygulayın.
3. Feed'inizi adlandırma
Önerilen feed adlandırma kuralı şöyledir:
agency-region-country_code (ör. gbus-ca-us) veya bölge gerekmiyorsa agency-country_code (ör. gbus-br). Test feed'leri için önerilen feed adlandırma kuralı:
test-agency-country_code (ör. test-gbus-ca-us veya
test-gbus-br).
4. Feed'inizi yükleme ve güncelleme
GTFS verilerinizi yüklemek ve güncellemek için GTFS feed'i verilerinizi yayınlama rehberini inceleyin. Veriler her yüklendiğinde otomatik doğrulama işlemine tabi tutulur (30 dakika sürer) ve doğrulama raporu oluşturulur. Lütfen bir sonraki adıma geçmeden önce hataları düzeltin.
5. Önizleme ortamı isteğinde bulunma
GTFS verileri doğrulama işleminden başarıyla geçtikten sonra önizleme ortamının etkinleştirilmesi için Gizli önizlemeyi kullanarak feed verilerinizi test etme başlıklı makaledeki talimatları uygulayın. Etkinleştirildikten sonra, yüklenen feed verileri, izin verilen kullanıcıların Google Haritalar'ında görünür. Bu noktada, GTFS verileri artık API sunucusuyla test için de kullanılabilir.
6. Lansman QA incelemesi isteme
Önizleme ortamında sorunlu uyarılar ve veri kalitesi sorunları giderildikten sonra, herkese açık lansmandan önce son bir Google kalite güvence incelemesi yapılması gerekir. Kalite güvencesi inceleme süreciyle bulunan sorunlar kontrol panelinde görünür. Tüm bekleyen sorunlar giderildikten sonra GTFS kullanıma hazır olur.
7. Feed'i başlatma
Feed'i herkese açık hale getirme talimatları için Feed'inizi başlatma başlıklı makaleyi inceleyin.