- Resource: TransitObject
- PassengerType
- TicketStatus
- ConcessionCategory
- TicketRestrictions
- PurchaseDetails
- TicketCost
- TicketLeg
- TicketSeat
- FareClass
- TripType
- ActivationStatus
- Status
- DeviceContext
- Metode
Sumber daya: TransitObject
Representasi JSON |
---|
{ "classReference": { object ( |
Kolom | |
---|---|
class |
Salinan kolom yang diwarisi dari class induk. Kolom ini diambil selama GET. |
ticket |
Nomor tiket. Ini adalah ID unik untuk tiket dalam sistem operator transportasi umum. |
passenger |
Jumlah penumpang. |
passenger |
Nama penumpang yang diberikan tiket. Kolom |
trip |
ID ini digunakan untuk mengelompokkan tiket jika pengguna telah menyimpan beberapa tiket untuk perjalanan yang sama. |
ticket |
Status tiket. Untuk status yang memengaruhi tampilan, gunakan kolom |
custom |
Status kustom yang akan digunakan untuk nilai status tiket saat |
concession |
Kategori konsesi untuk tiket. |
custom |
Kategori konsesi kustom yang akan digunakan jika |
ticket |
Informasi tentang jenis batasan yang ada dalam penggunaan tiket ini. Misalnya, pada hari apa tujuan harus digunakan, atau rute mana yang diizinkan untuk diambil. |
purchase |
Detail pembelian untuk tiket ini. |
ticket |
Satu segmen tiket berisi informasi keberangkatan dan kedatangan beserta informasi boarding dan tempat duduk. Jika lebih dari satu segmen harus ditentukan, gunakan kolom |
ticket |
Setiap tiket dapat berisi satu atau beberapa segmen. Setiap segmen berisi informasi keberangkatan dan kedatangan beserta informasi boarding dan tempat duduk. Jika hanya satu segmen yang akan ditentukan, gunakan kolom |
hex |
Warna latar belakang kartu. Jika tidak menetapkan warna dominan, gambar utama akan digunakan, dan jika tidak ada gambar utama yang ditetapkan, warna dominan logo akan digunakan. Formatnya adalah #rrggbb dengan rrggbb adalah triplet RGB heksadesimal, seperti |
trip |
Wajib. Jenis perjalanan yang diwakili oleh objek transportasi umum ini. Digunakan untuk menentukan judul kartu dan/atau simbol yang akan digunakan antara asal dan tujuan. |
id |
Wajib. ID unik untuk objek. ID ini harus unik di semua objek dari penerbit. Nilai ini harus mengikuti format issuer ID.identifier yang pertama diterbitkan oleh Google, dan yang kedua dipilih oleh Anda. ID unik hanya boleh berisi karakter alfanumerik, '.', '_', atau '-'. |
class |
Wajib. Class yang terkait dengan objek ini. Class harus memiliki jenis yang sama dengan objek ini, harus sudah ada, dan harus disetujui. ID Class harus mengikuti format issuer ID.identifier yang pertama diterbitkan oleh Google, dan yang kedua dipilih oleh Anda. |
version |
Tidak digunakan lagi |
state |
Wajib. Status objek. Kolom ini digunakan untuk menentukan cara objek ditampilkan di aplikasi. Misalnya, objek |
barcode |
Jenis dan nilai kode batang. |
messages[] |
Array pesan yang ditampilkan di aplikasi. Semua pengguna objek ini akan menerima pesan terkait. Jumlah maksimum kolom ini adalah 10. |
valid |
Jangka waktu objek ini akan menjadi |
locations[] |
Catatan: Kolom ini saat ini tidak didukung untuk memicu notifikasi geografis. |
has |
Menunjukkan apakah objek memiliki pengguna. Kolom ini ditetapkan oleh platform. |
smart |
Nilai yang akan dikirimkan ke terminal bersertifikasi Smart Tap melalui NFC untuk objek ini. Kolom tingkat kelas |
has |
Apakah objek ini saat ini ditautkan ke satu perangkat. Kolom ini ditetapkan oleh platform saat pengguna menyimpan objek, yang menautkannya ke perangkat mereka. Dimaksudkan untuk digunakan oleh partner tertentu. Hubungi dukungan untuk mendapatkan informasi tambahan. |
disable |
Menunjukkan apakah notifikasi harus disembunyikan secara eksplisit. Jika kolom ini disetel ke benar (true), notifikasi tentang masa berlaku kepada pengguna akan disembunyikan, terlepas dari kolom Saat ini, setelan ini hanya dapat disetel untuk penawaran. |
info |
Tidak digunakan lagi. Sebagai gantinya, gunakan textModulesData. |
image |
Data modul gambar. Jumlah maksimum kolom yang ditampilkan adalah 1 dari tingkat objek dan 1 untuk tingkat objek class. |
text |
Data modul teks. Jika data modul teks juga ditentukan di class, keduanya akan ditampilkan. Jumlah maksimum kolom yang ditampilkan adalah 10 dari objek dan 10 dari class. |
links |
Menautkan data modul. Jika data modul link juga ditentukan di class, keduanya akan ditampilkan. |
app |
Link aplikasi atau situs opsional yang akan ditampilkan sebagai tombol di bagian depan kartu. Jika AppLinkData disediakan untuk class yang sesuai, hanya objek AppLinkData yang akan ditampilkan. |
activation |
Status aktivasi objek. Wajib jika |
rotating |
Jenis dan nilai kode batang yang berputar. |
device |
Konteks perangkat yang terkait dengan objek. |
hero |
Gambar banner opsional yang ditampilkan di bagian depan kartu. Jika tidak ada, gambar utama kelas, jika ada, akan ditampilkan. Jika banner besar kelas juga tidak ada, tidak ada yang akan ditampilkan. |
grouping |
Informasi yang mengontrol cara kartu dikelompokkan. |
pass |
Teruskan batasan untuk objek. Mencakup pembatasan perilaku NFC dan screenshot. |
save |
Pembatasan pada objek yang perlu diverifikasi sebelum pengguna mencoba menyimpan kartu. Perhatikan bahwa batasan ini hanya akan diterapkan selama waktu penyimpanan. Jika pembatasan berubah setelah pengguna menyimpan kartu, batasan baru tidak akan diterapkan ke kartu yang sudah disimpan. |
linked |
linkedObjectId adalah daftar objek lain seperti tiket acara, loyalitas, penawaran, generik, kartu voucher, transportasi umum, dan boarding pass yang harus disertakan secara otomatis ke objek transportasi umum ini. Jika pengguna telah menyimpan kartu multi-trip ini, linkedObjectIds ini akan otomatis dikirim ke dompet pengguna (kecuali jika pengguna menonaktifkan setelan untuk menerima kartu tertaut tersebut). Pastikan objek yang ada di linkedObjectIds sudah dimasukkan - jika tidak, panggilan akan gagal. Setelah ditautkan, objek tertaut tidak dapat dibatalkan tautannya. Anda tidak dapat menautkan objek milik penerbit lain. Ada batas jumlah objek yang dapat ditautkan ke satu objek. Setelah batas tercapai, objek tertaut baru dalam panggilan akan diabaikan secara otomatis. ID objek harus mengikuti format issuer ID.identifier dengan yang pertama diterbitkan oleh Google dan yang kedua dipilih oleh Anda. |
notify |
Apakah pembaruan kolom pada objek ini harus memicu notifikasi atau tidak. Jika ditetapkan ke NOTIFY, kami akan mencoba memicu notifikasi pembaruan kolom kepada pengguna. Notifikasi ini hanya akan dikirim kepada pengguna jika kolom tersebut merupakan bagian dari daftar yang diizinkan. Jika disetel ke DO_NOT_NOTIFY atau NOTIFICATION_SETTINGS_UNSPECIFIED, tidak ada notifikasi yang akan dipicu. Setelan ini bersifat sementara dan harus disetel dengan setiap permintaan PATCH atau UPDATE. Jika tidak, notifikasi tidak akan dipicu. |
value |
Data modul nilai tambah opsional. Maksimum sepuluh pada objek. |
PassengerType
Enum | |
---|---|
PASSENGER_TYPE_UNSPECIFIED |
|
SINGLE_PASSENGER |
|
singlePassenger |
Alias lama untuk |
MULTIPLE_PASSENGERS |
|
multiplePassengers |
Alias lama untuk |
TicketStatus
Enum | |
---|---|
TICKET_STATUS_UNSPECIFIED |
|
USED |
|
used |
Alias lama untuk |
REFUNDED |
|
refunded |
Alias lama untuk |
EXCHANGED |
|
exchanged |
Alias lama untuk |
ConcessionCategory
Enum | |
---|---|
CONCESSION_CATEGORY_UNSPECIFIED |
|
ADULT |
|
adult |
Alias lama untuk |
CHILD |
|
child |
Alias lama untuk |
SENIOR |
|
senior |
Alias lama untuk |
TicketRestrictions
Representasi JSON |
---|
{ "routeRestrictions": { object ( |
Kolom | |
---|---|
route |
Batasan tentang rute yang dapat diambil. Misalnya, ini mungkin string "Khusus kereta CrossCountry yang direservasi". |
route |
Detail selengkapnya tentang |
time |
Batasan mengenai waktu penggunaan tiket ini. |
other |
Pembatasan tambahan yang tidak termasuk dalam kategori "rute" atau "waktu". |
PurchaseDetails
Representasi JSON |
---|
{
"purchaseReceiptNumber": string,
"purchaseDateTime": string,
"accountId": string,
"confirmationCode": string,
"ticketCost": {
object ( |
Kolom | |
---|---|
purchase |
Nomor/ID tanda terima untuk melacak pembelian tiket melalui organisasi yang menjual tiket. |
purchase |
Tanggal/waktu pembelian tiket. Ini adalah tanggal/waktu format tambahan ISO 8601, dengan atau tanpa offset. Waktu dapat ditentukan hingga presisi nanodetik. Offset dapat ditentukan dengan presisi detik (meskipun detik offset bukan bagian dari ISO 8601). Contoh:
Tanpa informasi offset, beberapa fitur lengkap mungkin tidak tersedia. |
account |
ID akun yang digunakan untuk membeli tiket. |
confirmation |
Kode konfirmasi untuk pembelian. ID ini mungkin sama untuk beberapa tiket yang berbeda dan digunakan untuk mengelompokkan tiket. |
ticket |
Biaya tiket. |
TicketCost
Representasi JSON |
---|
{ "faceValue": { object ( |
Kolom | |
---|---|
face |
Harga asli tiket. |
purchase |
Harga pembelian tiket yang sebenarnya, setelah pajak dan/atau diskon. |
discount |
Pesan yang menjelaskan jenis diskon apa pun yang diterapkan. |
TicketLeg
Representasi JSON |
---|
{ "originStationCode": string, "originName": { object ( |
Kolom | |
---|---|
origin |
Kode stasiun asal. Ini diperlukan jika |
origin |
Nama stasiun asal. Ini diperlukan jika |
destination |
Kode stasiun tujuan. |
destination |
Nama tujuan. |
departure |
Tanggal/waktu keberangkatan. Ini diperlukan jika tidak ada interval waktu validitas yang ditetapkan pada objek transit. Ini adalah tanggal/waktu format diperluas ISO 8601, dengan atau tanpa offset. Waktu dapat ditentukan hingga presisi nanodetik. Offset dapat ditentukan dengan presisi detik (meskipun detik offset bukan bagian dari ISO 8601). Contoh:
Bagian tanggal/waktu tanpa offset dianggap sebagai "tanggal/waktu lokal". Ini harus berupa tanggal/waktu setempat di stasiun asal. Misalnya, jika keberangkatan terjadi pada jam 20 pada 5 Juni 2018 di stasiun asal, bagian tanggal/waktu lokal harus Tanpa informasi offset, beberapa fitur lengkap mungkin tidak tersedia. |
arrival |
Tanggal/waktu kedatangan. Ini adalah tanggal/waktu format tambahan ISO 8601, dengan atau tanpa offset. Waktu dapat ditentukan hingga presisi nanodetik. Offset dapat ditentukan dengan presisi detik (meskipun detik offset bukan bagian dari ISO 8601). Contoh:
Bagian tanggal/waktu tanpa offset dianggap sebagai "tanggal/waktu lokal". Ini harus berupa tanggal/waktu lokal di stasiun tujuan. Misalnya, jika peristiwa terjadi pada jam ke-20 tanggal 5 Juni 2018 di stasiun tujuan, bagian tanggal/waktu lokal harus Tanpa informasi offset, beberapa fitur lengkap mungkin tidak tersedia. |
fare |
Deskripsi/nama singkat tarif untuk segmen perjalanan ini. Misalnya, "Sekali Saja Penggunaan". |
carriage |
Nama/nomor kereta atau kapal yang harus dinaiki penumpang. |
platform |
Platform atau gerbang tempat penumpang dapat naik gerbong. |
zone |
Zona naik di dalam peron. |
ticket |
Kursi yang direservasi untuk penumpang. Jika lebih dari satu kursi akan ditentukan, gunakan kolom |
ticket |
Kursi yang dipesan untuk penumpang. Jika hanya satu kursi yang akan ditentukan, gunakan kolom |
transit |
Nama operator transportasi umum yang mengoperasikan segmen perjalanan ini. |
transit |
Stasiun pengakhir atau tujuan kereta/bus/dll. |
TicketSeat
Representasi JSON |
---|
{ "fareClass": enum ( |
Kolom | |
---|---|
fare |
Kelas tarif kursi yang dibeli tiketnya. |
custom |
Kelas tarif kustom yang akan digunakan jika tidak ada |
coach |
ID gerbong atau gerbong kereta tempat kursi bertiket berada. Misalnya, "10" |
seat |
ID lokasi kursi bertiket. Misalnya, "42". Jika tidak ada ID spesifik, gunakan |
seat |
Penetapan kursi penumpang. Misalnya, "tidak ada kursi tertentu". Untuk digunakan jika tidak ada ID spesifik yang akan digunakan di |
FareClass
Enum | |
---|---|
FARE_CLASS_UNSPECIFIED |
|
ECONOMY |
|
economy |
Alias lama untuk |
FIRST |
|
first |
Alias lama untuk |
BUSINESS |
|
business |
Alias lama untuk |
TripType
Enum | |
---|---|
TRIP_TYPE_UNSPECIFIED |
|
ROUND_TRIP |
|
roundTrip |
Alias lama untuk |
ONE_WAY |
|
oneWay |
Alias lama untuk |
ActivationStatus
Status aktivasi objek. Kolom ini mencakup status aktivasi jika aset berharga mendukung aktivasi.
Representasi JSON |
---|
{
"state": enum ( |
Kolom | |
---|---|
state |
|
Negara Bagian
Enum | |
---|---|
UNKNOWN_STATE |
|
NOT_ACTIVATED |
Tidak Diaktifkan, ini adalah status default |
not_activated |
Alias lama untuk |
ACTIVATED |
Diaktifkan |
activated |
Alias lama untuk |
DeviceContext
Konteks perangkat yang terkait dengan objek.
Representasi JSON |
---|
{ "deviceToken": string } |
Kolom | |
---|---|
device |
Jika ditetapkan, informasi penukaran hanya akan ditampilkan ke perangkat tertentu setelah objek diaktifkan. ID ini tidak boleh digunakan sebagai ID yang stabil untuk melacak perangkat pengguna. Nilai ini dapat berubah di berbagai kartu untuk perangkat yang sama atau bahkan di berbagai aktivasi untuk perangkat yang sama. Saat menyetelnya, pemanggil juga harus menetapkan hasLinkedDevice pada objek yang diaktifkan. |
Metode |
|
---|---|
|
Menambahkan pesan ke objek transportasi umum yang dirujuk oleh ID objek yang diberikan. |
|
Menampilkan objek transportasi umum dengan ID objek yang diberikan. |
|
Menyisipkan objek transportasi umum dengan ID dan properti yang diberikan. |
|
Menampilkan daftar semua objek transportasi umum untuk ID penerbit yang diberikan. |
|
Memperbarui objek transportasi umum yang dirujuk oleh ID objek yang diberikan. |
|
Memperbarui objek transportasi umum yang dirujuk oleh ID objek yang diberikan. |