Bu kılavuzda, Google Haritalar ve Google Arama dahil olmak üzere çeşitli Google platformlarında kullanıcılara sorunsuz bir ulaşım arama deneyimi sunmak için Google ile nasıl entegrasyon yapacağınız açıklanmaktadır. Özet olarak, temel entegrasyon özellikleri şunlardır:
- Statik verileri sağlamak için iki seçenek vardır:
- GTFS tabanlı entegrasyon: Tarife verilerinin sağlayıcısı olduğunuz durumlarda bilet uzantıları içeren bir GTFS feed'i sağlama. GTFS tabanlı entegrasyon için bazı ek şartlarımız var.
- Yalnızca durakları içeren entegrasyon: Google'ın program verilerini başka bir kaynaktan zaten aldığı durumlarda yalnızca durakların listesini sağlar.
- Dinamik veriler sağlamak için bir İş Ortağı API spesifikasyonu:
- İş ortağı yapılandırması: Markalama ve iletişim bilgileri gibi iş ortağı bilgilerini sağlama.
- İş ortağı sunucusu: İş Ortağı Sunucusu API'lerini destekleyen sunucuların uygulanması.
Travel Transport ile entegrasyon adımları
Aşağıda, Google'ın ulaşım özelliklerini destekleyen uçtan uca bir sistem oluşturmak ve test etmek için gereken adımlara genel bir bakış sunulmuştur. Entegrasyon için üç temel adım vardır:
- Katılım koşullarını inceleyin.
- Google'a statik veri feed'i sağlama.
- Fiyat ve stok durumu gibi hızlı değişen verilerin dinamik olarak sorgulanmasını sağlamak için Seyahat Ulaşım API'sini destekleme. API, durakları tanımlamak için 1. adımda sağlanan statik veri feed'indeki tanımlayıcıları (ör.
ticketing_stop_id) kullanır.
1. Katılım koşulları
Google'ın ulaşım özellikleri biriminde, fiyatlarla birlikte seyahat planları ve rezervasyon seçenekleri gösterilir. Teklifinizin listede gösterilmesi için kaliteli bir bağlantı ve eşleşen bir nihai fiyat gerekir. Daha fazla bilgi için katılım şartlarımızı inceleyin.
2. Statik verilerin feed'ini sağlama
Statik verileri sağlamak için iki seçenek vardır ve her biri belirli durumlarda geçerlidir. Hangi seçeneği kullanacağınıza karar verirken göz önünde bulundurmanız gereken temel ölçüt, rezervasyon işlevi sunmak istediğiniz toplu taşıma bağlantıları için program verilerinin sağlayıcısı olup olmadığınızdır. Google'da zaten program verileri olup olmadığını kontrol etmenin en kolay yolu, Google Haritalar'da belirli bir operatörün bağlantılarını bulmaya çalışmaktır.
| Özellik | GTFS tabanlı entegrasyon | Yalnızca durdurma entegrasyonu |
|---|---|---|
| Kullanım alanı | GTFS'yi zaten program ve bilet bilgileriyle birlikte sağlıyorsunuz. | Google, operatörün program verilerini başka bir kaynaktan zaten almıştır. |
| Gerekli veriler | GTFS kimlikleri. | Durak kimliklerinizin coğrafi koordinatlarıyla birlikte listesi. |
| Çaba (Effort) | Düşük | Orta zorlukta |
Bir operatörün GTFS feed'inin sağlayıcısıysanız 1. seçenek geçerlidir. Bu durumda, Google'a önce program bilgilerini sağlamak için bir GTFS feed'i de ayarlamanız gerekir. Ardından, GTFS tabanlı entegrasyon bölümündeki talimatları uygulayın.
Google, operatörün program verilerini farklı bir kaynaktan zaten alıyorsa 2. seçenek geçerlidir. Bu durumda, tam program bilgisine ihtiyacımız olmasa da Seyahat Taşımacılığı API'sinde kullanabileceğimiz durak kimliklerinizin bir listesini yine de göndermeniz gerekir (aşağıya bakın). Durak listesini sağlamak için Yalnızca Durak Entegrasyonu bölümündeki talimatları uygulayın.
3. Travel Transport API'yi destekleme
Google'ın, ulaşım birimindeki fiyatlarla birlikte rezervasyon iş ortağı olarak listelenmesi için iş ortaklarından en son fiyatlandırma ve müsaitlik durumu bilgilerini alabilmesi gerekir. Bunu etkinleştirmek için iş ortaklarının, iş ortağı sunucusu API'lerini uygulayan bir hizmet sağlaması gerekir.
3.1. Partner Server API'yi uygulama
İş Ortağı Sunucusu API'sinin nasıl uygulanacağıyla ilgili ayrıntıları API Referansı ve İş Ortağı Sunucusu Kılavuzu'nda bulabilirsiniz. API, Google'ın iş ortaklarından en güncel fiyatlandırma ve stok durumu bilgilerini almasına olanak tanır ve Google tarafından şu amaçlarla çağrılır:
- Geri dönen fiyatlar için hızlıca önbellek oluşturun.
- Bir kullanıcı, belirli bir tarihte rota aradığında ve önbelleğimizde fiyat içermeyen seyahat planları gösterildiğinde en son fiyatlandırmayı alma
İş ortağının fiyatların Google tarafından gösterilmesini istemesi durumunda İş Ortağı Sunucusu API'sinin uygulanması gerekir.
3.2. API doğrulama ve test
API uygulamanız tamamlanmaya yaklaştığında ve uygulamayı gerçekleştiren hizmet çalışır duruma geldiğinde lütfen transport-help@google.com adresinden sunucu bilgileriyle iletişime geçin. Böylece uygulamanızı doğrulamaya başlayabiliriz.
Gelecekte API uygulamanızı doğrulamak için otomatik araçlar sunmayı planlıyoruz ancak bu araçlar henüz kullanıma sunulmadı.