Posisi kendaraan digunakan untuk memberikan informasi yang dihasilkan secara otomatis tentang lokasi kendaraan, seperti dari perangkat GPS yang ada di kendaraan. Satu posisi kendaraan harus diberikan untuk setiap kendaraan yang bisa memberikannya.
Perjalanan yang saat ini ditempuh kendaraan harus diberikan melalui deskripsi perjalanan. Anda juga dapat memberikan deskripsi kendaraan, yang secara akurat mengidentifikasi kendaraan fisik yang informasinya sedang Anda berikan. Dokumentasi disediakan di bawah ini.
Stempel waktu yang menunjukkan waktu pengambilan data posisi dapat diberikan. Perhatikan bahwa hal ini berbeda dengan stempel waktu di header feed, yang merupakan waktu saat pesan ini dihasilkan oleh server.
Jalur saat ini juga dapat diberikan (sebagai stop_sequence atau stop_id). Jalur saat ini menunjukkan perhentian yang sedang dituju atau telah disinggahi oleh kendaraan.
Posisi
Kolom position berisi data lokasi dalam VehiclePosition. Lintang dan bujur wajib ada, kolom lainnya bersifat opsional. Jenis data ini berupa:
- Lintang - derajat Utara, dalam sistem koordinat WGS-84
- Bujur - derajat Timur, dalam sistem koordinat WGS-84
- Penjuru - arah laju kendaraan
- Odometer - jarak yang sudah ditempuh kendaraan
- Kecepatan - kecepatan sementara yang diukur oleh kendaraan, dalam meter per detik
Tingkat Kemacetan
Posisi kendaraan juga memungkinkan perusahaan transportasi umum untuk menentukan tingkat kemacetan yang dihadapi kendaraan saat ini. Kemacetan dapat digolongkan berdasarkan kategori berikut:
- Tingkat kemacetan yang tidak diketahui
- Melaju lancar
- Tersendat-sendat
- Macet
- Macet parah
Perusahaan transportasi umum bebas untuk mengklasifikasikan penggolongan dari setiap jenis kemacetan yang Anda buat. Panduan kami menentukan bahwa kemacetan parah hanya digunakan dalam situasi saat lalu lintas begitu padat sehingga orang-orang keluar dari kendaraan.
Status kepadatan penumpang
Posisi kendaraan juga memungkinkan perusahaan transportasi umum menentukan tingkat kepadatan penumpang untuk kendaraan. Status kepadatan penumpang dapat digolongkan berdasarkan kategori berikut:
- Kosong
- Banyak kursi kosong
- Beberapa kursi kosong
- Hanya untuk berdiri
- Berdiri sambil berdesakan
- Penuh
- Tidak menerima penumpang lagi
Kolom ini masih bersifat eksperimental, dan masih bisa berubah sewaktu-waktu. Kolom ini mungkin diadopsi secara formal di masa mendatang.
VehicleStopStatus
Status perhentian kendaraan memberikan informasi tambahan untuk status kendaraan terkait perhentian yang saat ini sedang dituju atau disinggahinya. Status ini dapat ditetapkan ke salah satu dari nilai berikut.
- Akan tiba di - kendaraan akan segera tiba di perhentian yang disebutkan
- Berhenti di - kendaraan berhenti di perhentian yang disebutkan
- Transit ke - perhentian yang disebutkan adalah perhentian berikutnya untuk kendaraan - default
Deskripsi Kendaraan
Deskripsi kendaraan menggambarkan kendaraan fisik secara akurat dan dapat berisi atribut berikut:
- ID - sistem internal identifikasi untuk kendaraan. Harus unik untuk kendaraan tersebut
- Label - label yang terlihat oleh pengguna - misalnya, nama kereta api
- Pelat nomor - pelat nomor kendaraan yang sebenarnya