Genel Toplu Taşıma Feed Spesifikasyonu (GTFS), toplu taşıma tarifeleri ve ilişkili coğrafi bilgiler için kullanılan mevcut bir biçimdir. GTFS tabanlı entegrasyon, Travel Transport entegrasyonunun 1. adımını tamamlamak için GTFS'yi ve Google Transit Ticketing uzantılarını kullanır. Böylece statik veri feed'i sağlanır.
Partner Server API, 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'inin olması gerekir.
Geçerli bir GTFS feed'i sağlamak için lütfen aşağıdaki adımları uygulayın.
GTFS statik feed'i oluşturma
Kullanıcıların GTFS tabanlı entegrasyonu kullanarak şehirler arası seyahatler için rota ve tarife arayıp bulabilmesini sağlamak amacıyla iş ortaklarından bir GTFS feed'i gerekir. GTFS feed verileri programlar, rotalar ve bilet bilgileri hakkında statik bilgiler içerir. Bu bilgiler daha sonra Google tarafından iş ortağı API'sine bağlanmak için kullanılır.
1. Transit hesabı oluşturma
Henüz tamamlamadıysanız lütfen Google Transit'i kullanmaya başlayın bölümüne gidin ve bir hesap isteğinde bulunmak için formu kullanın. İnceleme tamamlandıktan sonra bir hesap oluşturulur ve GTFS kontrol paneli kullanılabilir hale gelir. Kontrol paneline erişme ve onu yapılandırmayla ilgili ayrıntılar için Transit İş Ortağı Kontrol Paneli'ne erişme bölümüne bakın.
2. Uzantılarla GTFS feed'inizi oluşturma
Google Transit Bilet uzantılarının gerekli bölümlerini ekleyerek GTFS feed'ini oluşturun (daha fazla bilgi için GTFS uzantıları bölümüne bakın). En iyi kullanıcı deneyimini sunmak için lütfen GTFS kalite şartları ve en iyi uygulamaları okuyup uygulayın.
3. Feed'inizi adlandırma
Önerilen feed adlandırma kuralı: agency-region-country_code, ör. gbus-ca-us veya bölge gerekli değilse agency-country_code (ör. gbus-br). Test feed'leri için önerilen feed adlandırma kuralı şöyledir:
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 verilerinizi yayınlama kılavuzundaki adımları uygulayın. Veriler her yüklendiğinde, otomatik doğrulama uygulanır (30 dakikayı bulabilir) ve bir doğrulama raporu oluşturulur. Sonraki adıma geçmeden önce lütfen hataları düzeltin.
5. Önizleme ortamını iste
GTFS verileri doğrulamadan başarıyla geçtikten sonra önizleme ortamını etkinleştirmek için Özel önizleme kullanarak feed verilerinizi test etme bölümündeki talimatları uygulayın. Etkinleştirildiğinde, 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 yapmak için de kullanılabilir.
6. Başlatma KG incelemesi isteme
Önizleme ortamında sorunlu uyarılar ve veri kalitesi sorunları giderildikten sonra, genel lansmandan önce son bir Google KG incelemesi yapılması gerekir. KG inceleme süreci ile bulunan sorunlar kontrol panelinde görünür, çözülmemiş tüm sorunlar ele alındığında 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 bölümüne bakın.