Ringkasan
Jika Anda bukan penyedia feed GTFS untuk Google Maps, integrasi Anda adalah Khusus penghentian. Untuk integrasi ini, kami perlu memahami cara Anda mengidentifikasi berbagai halte kereta atau bus.
Spesifikasi feed umum
Saat memulai integrasi, kami membuat ID unik untuk setiap
integrasi, misalnya: ch_google_test (kode negara, nama partner, integrasi) atau eu_google (kode wilayah, nama partner).
Partner menyediakan file yang berisi file teks dalam format CSV yang diterapkan per integrasi. Setiap file CSV harus berisi baris header dengan nama kolom yang cocok dengan "Nama Kolom" yang ditentukan dalam tabel spesifikasi feed yang sesuai.
Untuk mengizinkan partner mengupload versi baru file perhentian dan pasar, tim kami akan membagikan detail dropbox SFTP, satu untuk setiap jenis file selama proses aktivasi.
Spesifikasi feed perhentian (wajib)
File perhentian harus berisi kolom berikut:
| Nama Kolom | Jenis (lihat GTFS) | Deskripsi |
|---|---|---|
stop_id |
ID (wajib) | ID unik yang mengidentifikasi perhentian atau stasiun. Stasiun yang lebih besar hanya boleh berisi satu entri. ID ini digunakan saat melakukan panggilan ke Partner Server API dan di deep link tiket. |
stop_name |
Teks (wajib) | Nama yang dapat dibaca manusia untuk men-debug pemetaan penghentian, pengisian cache, dan data akurasi harga. |
stop_lat |
Lintang (wajib) | Lintang perhentian. |
stop_lon |
Bujur (wajib) | Bujur perhentian. |
Kami akan menggunakan proses penyerapan otomatis di mana partner dapat terus-menerus memberikan file ZIP yang diperbarui saat informasi yang ada di dalamnya berubah. Misalnya, partner dapat memperluas inventaris yang disediakan dengan memperpanjang daftar perhentian. Namun, seperti GTFS, stop_id harus stabil.
Spesifikasi feed set pasar (opsional)
Dengan perhentian yang dipetakan, kita menghasilkan set pasar untuk integrasi ini (daftar yang berisi pasangan asal / tujuan populer). Dari sana, Anda memiliki opsi untuk mengurangi set pasar ini dengan memberikan feed set pasar.
Set pasar berfungsi sebagai daftar yang diizinkan untuk layanan pengisian cache kami. Secara default, jika tidak ada set pasar yang diberikan, semua pasar akan diaktifkan. Jika Anda memberikan set pasar, hanya pasar yang disertakan dalam daftar yang akan dikueri. Jika pengguna membuat kueri pasar di luar daftar yang diizinkan ini, sistem kami akan tetap mengirim kueri live untuk pasar dan tanggal tertentu yang diminta, tetapi kami tidak akan mencoba melakukan caching secara proaktif.
File set pasar harus berisi kolom berikut:
| Nama Kolom | Jenis (lihat GTFS) | Deskripsi |
|---|---|---|
origin_stop_id |
ID (wajib) | Asal stop_id pasar. |
destination_stop_id |
ID (wajib) | Tujuan stop_id pasar. |
Konfigurasi Partner
Saat menggunakan integrasi khusus penghentian, kami memerlukan informasi tambahan untuk konfigurasi partner statis seperti yang diuraikan di bagian Konfigurasi Partner.
Spesifikasi link rujukan
Format dan parameter link pemesanan (juga disebut Ticketing link) ditentukan dalam Link Tiket
Parameter Partner API
Parameter SegmentKeys untuk Partner API
(GetBulkTripOptionsRequest)
didasarkan pada spesifikasi deep link. Kami menggunakan
SegmentKeys termasuk
hanya from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date,
boarding_time, dan arrival_time, sehingga ticketing_trip_id kosong. Kita akan
menentukan rute sepenuhnya termasuk semua transfer dengan menentukan beberapa
SegmentKey, satu per segmen.