Statistics: Vehicle Analytics

Pengenalan

Bayangkan petugas lalu lintas yang berdiri di persimpangan dengan empat catatan: berapa kendaraan lewat ke tiap arah, berapa lama kendaraan berhenti di zona tertentu, seberapa padat ruas jalan, dan seberapa cepat kendaraan melaju. Statistik Vehicle Analytics mengotomatiskan keempat catatan itu dari event analitik kendaraan Visionaire, lengkap dengan jenis kendaraan, merek, dan warna.

Pada Statistics, seluruh varian analitik kendaraan digabung dalam satu analitik registry dengan ID MVA (label Vehicle Analytics) yang memiliki empat Logika: Penghitungan (counting, bawaan), Dwelling (dwelling), Kepadatan (density), dan Kecepatan (speed). Lenz menyertakan satu dashboard Bawaan untuk masing-masing logika.

Cara Menggunakan

Membaca Dashboard Bawaan Counting

Buka dashboard Bawaan Vehicle Analytics untuk logika Counting

Di daftar Dashboard, buka kartu Bawaan Vehicle Analytics (MVAA) dengan akhiran Counting. Scorecard Total vehicles berdampingan dengan line chart Vehicles over time by direction; bagian Stream Distribution, heatmap Vehicles by hour, bar Vehicle type by direction pada In & Out Breakdown, dan Tab Attributes (Direction, Vehicle type, Brand, Color, Advanced attrs, Area, Analytic variant) melengkapinya.

Bandingkan jenis kendaraan per arah

Bar Vehicle type by direction menumpuk dua dimensi (Direction dan Vehicle type) sehingga Anda dapat membaca, misalnya, berapa motor masuk dibanding mobil keluar. Klik ikon info widget untuk melihat spesifikasi query-nya.

Cari jam paling dan paling tidak ramai

Bagian Busiest & Quietest Hours membandingkan Total vehicles per jam: bar horizontal Busiest hours (10 jam dengan angka tertinggi) dan Quietest hours (10 terendah), lalu tabel Busiest hours by stream dan Quietest hours by stream yang memecahnya per stream. Karena granularitasnya Per jam, rentang tanggal maksimal 31 hari.

Membaca Dashboard Bawaan Dwelling

Dashboard Bawaan Dwelling untuk kendaraan mengikuti susunan yang sama dengan People Analytics: scorecard Visits, Avg/Min/Max dwell duration, donat Dwell duration distribution (Short/Medium/Long/Very long visits), line Dwell duration over time, tabel Area details (Visits dan durasi min/rata-rata/maks per area), distribusi per stream, heatmap Visits by hour, dan kontainer Longest & Shortest Stays (bar Longest stays by area dan Shortest stays by area, ranked top/bottom 10, plus tabel Dwell time by stream and area per day) sebelum Tab Attributes. Metrik perilaku pengunjung (Entered, Lookers, Passersby, Solo/Group) tidak tersedia untuk kendaraan — hanya durasi tinggal murni.

Membaca Dashboard Bawaan Density

Dashboard Bawaan Density untuk kendaraan mengikuti susunan yang sama dengan People Analytics, dengan subjek kendaraan (vehicles/frame) alih-alih orang: scorecard Total detections, Avg density, Peak density, Lowest density; line Detections over time dan Vehicles per frame over time; Stream Distribution dan Area Analysis dengan metrik per-frame; bagian Crowding Threshold (Time occupied, Time above threshold, Frames above threshold, Frames observed, N bawaan 10 lewat selektor At least); dan Peak Time Analysis dengan heatmap Detections by hour serta Avg density by hour (vehicles/frame). Lihat People Analytics untuk penjelasan detail tiap bagian.

Membaca Dashboard Bawaan Speed

Baca profil kecepatan

Dashboard Speed membuka dengan Vehicles measured, Avg speed, Min speed, dan Max speed (km/h). Donat Speed distribution membagi kendaraan ke pita Slow (0-30) km/h, Medium (31-60) km/h, Fast (61-100) km/h, dan Very fast (>100) km/h; line chart Speed over time memplot rata-rata, minimum, dan maksimum per hari.

Bandingkan stream, jam, dan atribut

Tabel Stream details merinci keempat metrik per stream, heatmap Avg speed by hour menunjukkan jam dengan kecepatan rata-rata tertinggi, dan Tab Attributes memuat tab Averages (rata-rata per nilai atribut) dan Over time untuk Vehicle type, Brand, Color, Advanced attrs, Area, dan Analytic variant.

Metrik & Dimensi

Logika Penghitungan (counting)

Dimensi khusus logika ini: direction (Direction, string).

Logika Dwelling (dwelling)

Logika Kepadatan (density)

Sama seperti People Analytics, logika ini menghitung kepadatan per frame: berapa kendaraan yang terdeteksi dalam satu frame kamera. Frame yang sama sekali tidak mendeteksi kendaraan dikeluarkan dari metrik per-frame.

Logika Kecepatan (speed)

Dimensi bersama

Semua filter memakai operator in. Granularitas: hour, day, week, month, quarter, year, atau kosong. Batas rentang: 31 hari (hour), 365 hari (day), 730 hari (lainnya). Pengelompokan Harian mengikuti hari kalender lokal site (bawaan WIB/Asia Jakarta, dapat dikonfigurasi per deployment) untuk Penghitungan, Dwelling, dan Kepadatan — bukan lagi jendela 07:00–07:00 seperti sebelumnya. Logika Kecepatan tidak terpengaruh perubahan ini.

Komponen Library

Seperti pada People Analytics, bagian Busiest & Quietest Hours, Longest & Shortest Stays, dan Crowding Threshold pada dashboard Bawaan disusun manual dengan kontrol Urutan (Semua/N teratas/N terbawah, untuk Bar dan Tabel) dan selektor At least untuk metrik berparameter — bukan komponen Library satu klik.

Contoh Query API

Komposisi pita kecepatan per hari (setara komponen Distribusi pita kecepatan):

{
  "analytic": "MVA",
  "sub_mode": "speed",
  "metrics": ["slow_count", "medium_count", "fast_count", "very_fast_count"],
  "dimensions": [],
  "granularity": "day",
  "time_range": { "start": "2026-09-12", "end": "2026-09-18" },
  "filters": {
    "stream_id": { "op": "in", "value": ["stream-gate-02"] }
  },
  "viz_kind": "bar",
  "viz_config": { "stacked": true }
}

Sepuluh jenis kendaraan teratas per arah selama sebulan:

{
  "analytic": "MVA",
  "sub_mode": "counting",
  "metrics": ["total_vehicles"],
  "dimensions": ["direction", "vehicle_type"],
  "granularity": "",
  "time_range": { "start": "2026-08-20", "end": "2026-09-18" },
  "limit": 10,
  "viz_kind": "bar"
}

Kendaraan per frame di setiap area selama sebulan, ranked 10 area terpadat (setara komponen Perbandingan Area dengan metrik density):

{
  "analytic": "MVA",
  "sub_mode": "density",
  "metrics": ["avg_estimation", "peak_estimation"],
  "dimensions": ["area"],
  "granularity": "",
  "time_range": { "start": "2026-08-20", "end": "2026-09-18" },
  "viz_kind": "bar",
  "viz_config": { "rank": "top", "rankCount": 10, "orientation": "horizontal" }
}

Endpoint legacy GET /api/statistics/mva/{counting,dwelling,density,speed} dan /api/statistics/mvaa/* masih tersedia; lihat API Reference.

Tips & Troubleshooting

Selanjutnya