Panduan ini menjelaskan cara berintegrasi dengan Google untuk memberikan pengalaman penelusuran transportasi yang lancar kepada pengguna di berbagai platform Google, termasuk Google Maps dan Google Penelusuran. Pada tingkat tinggi, spesifikasi integrasi utama mencakup:
- Dua opsi untuk memberikan data statis:
- Integrasi berbasis GTFS: Menyediakan feed GTFS dengan ekstensi tiket, untuk kasus saat Anda adalah penyedia data jadwal. Kami memiliki beberapa persyaratan tambahan untuk integrasi berbasis GTFS.
- Integrasi khusus penghentian: Hanya memberikan daftar perhentian, untuk kasus saat Google sudah memiliki data jadwal dari sumber lain.
- Spesifikasi Partner API untuk menyediakan data dinamis:
- Konfigurasi partner: Memberikan informasi partner seperti branding dan detail kontak.
- Server partner: Menerapkan server yang mendukung API Server Partner.
Langkah-langkah untuk berintegrasi dengan Transportasi Perjalanan
Berikut adalah ringkasan langkah-langkah yang diperlukan untuk membangun dan menguji sistem end-to-end untuk mendukung fitur transportasi Google. Ada tiga langkah utama untuk integrasi:
- Meninjau persyaratan partisipasi.
- Menyediakan feed data statis ke Google.
- Mendukung Travel Transport API untuk mengaktifkan kueri dinamis data yang berubah cepat seperti harga dan ketersediaan. API ini menggunakan
ID yang disediakan oleh feed data statis dari langkah 1, misalnya
ticketing_stop_iduntuk mengidentifikasi perhentian.
1. Persyaratan Partisipasi
Unit fitur transportasi Google menampilkan itinerari dan opsi pemesanan dengan harga. Untuk menampilkan penawaran Anda dalam daftar, link berkualitas baik dan harga akhir yang cocok diharapkan. Untuk mengetahui detail selengkapnya, tinjau persyaratan partisipasi kami.
2. Menyediakan feed data statis
Ada dua opsi untuk memberikan data statis, yang masing-masing berlaku dalam keadaan tertentu. Kriteria utama untuk memutuskan opsi mana yang akan digunakan adalah apakah Anda adalah penyedia data jadwal untuk koneksi transportasi umum yang ingin Anda tawarkan fungsi pemesanan. Cara termudah untuk memeriksa apakah Google sudah memiliki data jadwal adalah dengan mencoba menemukan koneksi untuk operator tertentu di Google Maps.
| Fitur | Integrasi berbasis GTFS | Integrasi khusus penghentian |
|---|---|---|
| Kasus penggunaan | Anda sudah menyediakan GTFS dengan informasi jadwal dan tiket. | Google sudah memiliki data jadwal untuk operator dari sumber lain. |
| Data yang diperlukan | ID GTFS. | Daftar ID perhentian Anda, dengan koordinat geografisnya. |
| Upaya | Rendah | Sedang |
Opsi 1 berlaku jika Anda adalah penyedia data GTFS untuk operator. Dalam hal ini, Anda juga harus menyiapkan feed GTFS untuk menyediakan informasi jadwal ke Google terlebih dahulu. Kemudian, ikuti petunjuk di bagian Integrasi berbasis GTFS.
Opsi 2 berlaku jika Google sudah menerima data jadwal untuk operator dari sumber lain. Dalam hal ini, kami tidak memerlukan informasi jadwal lengkap, tetapi kami tetap memerlukan daftar ID perhentian Anda yang dapat kami gunakan di Travel Transport API (lihat di bawah). Untuk memberikan daftar perhentian, ikuti petunjuk di bagian Integrasi Khusus Perhentian.
3. Mendukung Travel Transport API
Agar tercantum sebagai partner pemesanan dengan harga di Unit Transportasi, Google harus dapat mengambil informasi harga & ketersediaan terbaru dari partner. Untuk mengaktifkannya, partner diwajibkan untuk menyediakan layanan yang menerapkan Partner Server API.
3.1. Mengimplementasikan Partner Server API
Detail tentang cara menerapkan Partner Server API dapat ditemukan di Referensi API dan di panduan server Partner. API memungkinkan Google mendapatkan informasi harga dan ketersediaan terbaru dari partner, dan akan dipanggil oleh Google untuk:
- Buat cache untuk menampilkan harga dengan cepat.
- Mendapatkan harga terbaru saat pengguna mengklik itinerari tertentu.
Penerapan Partner Server API diperlukan jika partner ingin harga ditampilkan oleh Google.
3.2. Validasi & pengujian API
Setelah penerapan API Anda hampir selesai dan layanan yang menerapkannya sudah berjalan, hubungi transport-help@google.com dengan memberikan informasi server agar kami dapat mulai memvalidasi penerapan Anda.
Pada masa mendatang, kami berencana menawarkan alat otomatis untuk memvalidasi penerapan API Anda, tetapi alat ini belum tersedia.