Ringkasan
Jika Anda bukan penyedia feed GTFS untuk Google Maps, integrasi Anda adalah Khusus perhentian. Untuk integrasi ini, kami perlu memahami cara Anda mengidentifikasi berbagai perhentian 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 dapat memberikan file zip yang berisi file teks dalam format CSV yang diterapkan secara global atau per integrasi:
Contoh 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Contoh 2:
- stops.txt (diterapkan ke semua integrasi)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
Spesifikasi feed perhentian (wajib diisi)
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. Ini digunakan saat melakukan panggilan ke Partner Server API dan di deep link penjualan tiket. |
stop_name |
Teks (wajib) | Nama yang dapat dibaca manusia untuk men-debug data akurasi harga, pengisian cache, dan pemetaan perhentian. |
stop_lat |
Lintang (wajib) | Lintang perhentian. |
stop_lon |
Bujur (wajib) | Bujur perhentian. |
Kami akan menggunakan proses penyerapan otomatis yang memungkinkan partner terus menyediakan file ZIP yang diperbarui saat informasi yang terdapat di dalamnya berubah. Misalnya, partner dapat memperluas inventaris yang disediakan dengan memperluas daftar perhentian. Namun, mirip dengan GTFS, stop_id harus stabil.
Spesifikasi feed set pasar (opsional)
Dengan perhentian yang dipetakan, kami membuat kumpulan pasar untuk integrasi ini (daftar yang berisi pasangan asal / tujuan populer). Dari sana, Anda memiliki opsi untuk mengurangi kumpulan pasar ini dengan menyediakan feed kumpulan pasar.
Set pasar berfungsi sebagai daftar yang diizinkan: Jika tidak ada set pasar yang diberikan, semua pasar akan diaktifkan dalam integrasi. Jika kumpulan pasar disediakan, setiap pasar yang tidak ada dalam daftar akan dinonaktifkan.
File kumpulan 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) | stop_id tujuan pasar. |
Konfigurasi Partner
Saat menggunakan integrasi khusus perhentian, kami memerlukan informasi tambahan untuk konfigurasi partner statis seperti yang diuraikan di bagian Konfigurasi Partner.
Deep Link Penjualan Tiket
Format dan parameter deep link ditentukan di Link Penjualan Tiket
Parameter Partner API
Parameter SegmentKeys untuk Partner API
(GetBulkTripOptionsRequest)
didasarkan pada spesifikasi deep link. Kita menggunakan
SegmentKeys
yang hanya menyertakan 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 SegmentKeys, satu per segmen.