Glosarium ini mendefinisikan istilah utama yang digunakan dalam dokumentasi Integrasi Partner Transportasi.
Token Pemesanan: String opsional yang dibuat partner yang dapat diteruskan di deep link tiket untuk membantu menjaga konsistensi harga dan itinerari antara hasil penelusuran Google dan halaman pemesanan partner.
Pemetaan JSON Kanonis: Kumpulan aturan tertentu yang ditentukan oleh Protocol Buffers untuk mengonversi pesan proto menjadi objek JSON. Integrasi ini memerlukan penggunaan pemetaan ini dengan opsi tertentu agar permintaan dan respons diformat dengan benar.
GTFS (General Transit Feed Specification): Format data standar yang digunakan oleh lembaga transportasi umum untuk memberikan informasi jadwal, rute, dan tarif kepada penumpang. Dalam integrasi ini, cara ini adalah salah satu dari dua cara untuk memberikan data statis ke Google.
Integrasi berbasis GTFS: Metode integrasi untuk partner yang menyediakan data jadwal mereka sendiri ke Google dalam feed GTFS. Hal ini digunakan saat Google belum memiliki jadwal operator.
known_itineraries: Opsi dalam Konfigurasi Partner yang memungkinkan partner menerima daftar itinerari yang diketahui dari Google untuk mengoptimalkan respons mereka.
Set Pasar: (Untuk integrasi Khusus penghentian) Feed opsional yang disediakan oleh partner untuk menentukan daftar spesifik pasangan asal-tujuan (pasar) yang akan mereka berikan harganya. Jika diberikan, parameter ini berfungsi sebagai daftar yang diizinkan.
Partner API / Partner Server API: Kumpulan API yang harus diterapkan partner untuk memberikan data dinamis kepada Google, seperti harga dan ketersediaan real-time.
Pengujian Kualitas Harga: Proses berkelanjutan saat crawler Google mengambil sampel itinerari di situs partner untuk memverifikasi bahwa harga yang ditampilkan kepada pengguna cocok dengan harga yang diberikan melalui Partner API.
QPS (Kueri Per Detik): Kecepatan rata-rata saat Google mengirim permintaan (satu kueri adalah satu permintaan) ke server Partner API. Rasio ini dapat berfluktuasi, dengan periode traffic yang sedikit lebih tinggi atau lebih rendah.
SegmentKey: Objek yang digunakan di Partner API untuk mengidentifikasi satu perjalanan secara unik, termasuk asal, tujuan, dan tanggal/waktu layanan.
service_date: Tanggal tertentu saat layanan transportasi beroperasi, dengan
format YYYYMMDD. ID ini digunakan bersama dengan ID lain untuk
menentukan instance perjalanan yang unik.
Integrasi hanya berhenti: Metode integrasi untuk partner yang bukan sumber data jadwal. Metode ini digunakan saat Google sudah menerima jadwal operator dari sumber lain. Partner hanya perlu memberikan daftar ID perhentian mereka.
ticketing_stop_id: ID unik partner untuk perhentian atau stasiun.
ID ini diberikan di feed data statis (GTFS atau Khusus perhentian) dan
digunakan di Partner API dan deep link tiket.
ticketing_trip_id: (Untuk integrasi berbasis GTFS) ID unik partner
untuk perjalanan tertentu, yang disediakan dalam file trips.txt di feed GTFS
mereka. Khusus integrasi berbasis GTFS.
Deep Link Tiket: URL yang mengarahkan pengguna dari hasil penelusuran Google ke situs partner untuk memesan itinerari tertentu. URL berisi detail yang dienkode tentang perjalanan yang dipilih.
TripOptionsErrorType: Kumpulan jenis error tertentu yang dapat ditampilkan di Partner API untuk memberikan informasi yang lebih mendetail tentang alasan permintaan gagal.
Nilai Enum UNSPECIFIED: Nilai pertama yang diperlukan (dengan nilai numerik
0) dalam definisi enum apa pun saat menggunakan Protocol Buffers. Nilai ini berfungsi sebagai nilai
default dan umumnya harus diperlakukan sebagai error jika diterima dalam permintaan.