Statistics
Analytics bisnis berbasis event — data pengenalan wajah, orang, kendaraan, plat nomor, dan estimasi kerumunan. Tersedia dalam tampilan real-time maupun historis dengan rentang waktu yang fleksibel.
Pengenalan
Halaman Statistics (/statistics) menyajikan ringkasan analitik bisnis yang diolah dari event yang terdeteksi oleh sistem. Berbeda dengan halaman Live Events yang menampilkan event satu per satu secara real-time, Statistics mengagregasi ribuan event menjadi metrik yang bermakna — grafik tren, distribusi per stream, periode puncak, dan statistik komparatif.
Data Statistics mencakup seluruh tipe analitik yang berjalan di atas Visionaire: dari pengenalan wajah, perhitungan dan perilaku orang, pemantauan kendaraan, pengenalan plat nomor, hingga estimasi kerumunan. Anda dapat melihat data hari ini saja, atau menelusuri historis hingga beberapa bulan ke belakang, lalu mengekspornya ke PDF untuk pelaporan.
Perbedaan Statistics dengan Live Events
| Aspek | Statistics (/statistics) | Live Events (/events) |
|---|---|---|
| Tujuan | Analisis tren & pelaporan bisnis | Monitoring deteksi secara langsung |
| Rentang waktu | Hari ini hingga beberapa bulan lalu | Hanya "sekarang" (streaming) |
| Koneksi | REST API (request–response) | WebSocket persisten |
| Format tampilan | Chart, tabel agregat, kartu metrik | Feed kartu event individual |
| Export | PDF tersedia untuk semua tipe | Tidak tersedia |
| Granularitas | Harian, mingguan, bulanan, per jam | Per-event (milidetik) |
Kapan Menggunakan Statistics
| Skenario | Rekomendasi |
|---|---|
| Memantau tren kunjungan harian/mingguan | Statistics → People Analytics |
| Melacak efektivitas identifikasi wajah | Statistics → Face Recognition |
| Menganalisis pola keluar-masuk kendaraan | Statistics → Vehicle Analytics |
| Memantau kepadatan area secara periodik | Statistics → Crowd Estimation |
| Audit kendaraan berdasarkan plat nomor | Statistics → LPR |
| Laporan eksekutif dalam format PDF | Semua tipe → Ekspor PDF |
Statistics membutuhkan setidaknya satu analitik aktif pada stream yang dipilih. Jika tidak ada data, pastikan stream telah dikonfigurasi dengan analitik yang sesuai melalui halaman Configuration.
Tipe Statistics yang Tersedia
Lenz Dashboard menyediakan lima kategori utama Statistics. Pilih salah satu sesuai analitik yang berjalan di deployment Anda:
Face Recognition
Statistik pengenalan wajah: total pengenalan, rasio dikenal/tidak dikenal, distribusi per stream, tren deret waktu, dan periode puncak aktivitas.
People Analytics
Statistik lalu lintas orang: counting (masuk/keluar), density (kepadatan area), dwelling (durasi tinggal), distribusi stream, dan analisis tren jangka panjang.
Vehicle Analytics
Statistik kendaraan: vehicle counting, density, dwelling, serta speed analytics. Cocok untuk area parkir, gerbang masuk, dan jalan utama.
Crowd Estimation
Statistik estimasi jumlah orang di area terbuka: total kerumunan, tren per jam, dan distribusi di berbagai zona kamera.
LPR
Statistik License Plate Recognition: volume plat terdeteksi, distribusi per stream, dan analisis periode aktif. Tersedia untuk LPR, LPR2, dan LPR3.
Tipe Statistics yang tersedia di dashboard Anda bergantung pada lisensi analitik yang aktif. Jika suatu tipe tidak muncul di dropdown, berarti analitik tersebut tidak terpasang atau belum dikonfigurasi pada stream aktif.
Cara Menggunakan
Pilih Tipe Analitik
Buka halaman Statistics dari sidebar, lalu klik dropdown Analitik di bagian atas halaman. Pilih salah satu tipe analitik yang tersedia — misalnya People Analytics atau Face Recognition.
Saat tipe analitik diubah, semua pilihan sebelumnya (Stream, rentang waktu) akan di-reset. Ini memastikan data yang ditampilkan selalu konsisten dengan tipe analitik yang dipilih.
Daftar analitik yang muncul di dropdown hanya berisi analitik yang benar-benar aktif di sistem Anda. Analitik yang tidak terdeteksi pada stream manapun tidak akan ditampilkan.
Pilih Rentang Waktu
Gunakan komponen Date Range Picker untuk menentukan periode analisis. Anda dapat memilih:
- Satu hari (misalnya: hari ini, kemarin)
- Rentang beberapa hari (misalnya: 7 hari terakhir, bulan ini)
- Rentang kustom hingga beberapa bulan ke belakang
Rentang waktu yang dipilih akan disimpan di URL (?dateFrom=...&dateTo=...) sehingga tautan halaman dapat dibagikan dengan filter yang sudah terkonfigurasi.
Pilih Stream
Klik dropdown Stream untuk memilih satu atau beberapa stream kamera yang ingin Anda analisis. Anda juga dapat mencari stream berdasarkan nama atau Site menggunakan kolom pencarian di dalam dropdown.
Untuk melihat data agregat dari seluruh stream, pilih Pilih Semua di bagian atas dropdown.
Jika deployment berjalan dalam mode Federation, Anda perlu memilih Instance terlebih dahulu sebelum dapat memilih Stream. Pilihan Instance tersedia di filter paling kiri.
Tampilkan Statistics
Klik tombol Tampilkan Statistik untuk memulai pengambilan data. Sistem akan mengirimkan request ke API dengan filter yang sudah Anda tentukan, lalu merender chart dan kartu ringkasan.
Tombol ini hanya aktif ketika analitik, stream, dan rentang waktu sudah dipilih. Perubahan pada filter waktu tidak otomatis me-refresh data — Anda perlu klik ulang Tampilkan Statistik untuk menerapkan filter baru.
Ekspor ke PDF (Opsional)
Setelah data ditampilkan, tombol Ekspor PDF akan aktif. Klik untuk mengunduh laporan PDF yang berisi semua chart dan metrik dari sesi filter yang sedang aktif.
PDF digenerate oleh backend dalam bahasa yang sesuai dengan preferensi bahasa dashboard Anda (Indonesia atau Inggris).
Untuk People Analytics dan Vehicle Analytics, pastikan Anda sudah memilih tab mode (Counting, Dwelling, atau Density) sebelum mengekspor. PDF akan berisi data sesuai tab yang aktif.
Fitur Umum Semua Tipe Statistics
Fitur berikut tersedia di seluruh tipe Statistics dan berlaku secara konsisten:
Filter Waktu Fleksibel
Pilih rentang tanggal bebas dari hari ini hingga beberapa bulan lalu. Filter tersimpan di URL sehingga bisa dibagikan atau di-bookmark.
Agregasi Multi-Level
Data ditampilkan dalam agregasi harian, mingguan, dan bulanan. Beberapa tipe (seperti People Analytics) juga menyediakan tampilan per jam.
Distribusi per Stream
Lihat kontribusi masing-masing kamera secara terpisah. Identifikasi stream dengan aktivitas tertinggi dan terendah dalam satu tampilan.
Analisis Waktu Puncak
Setiap tipe Statistics menyertakan identifikasi otomatis periode puncak (tersibuk) dan periode sepi berdasarkan rentang waktu yang dipilih.
Ekspor PDF
Unduh laporan berformat PDF yang siap disajikan. Didukung untuk: FR, FRA, LPR, People Analytics, Vehicle Analytics, Crowd Estimation, dan PPE.
State Tersimpan di URL
Filter aktif (analitik, stream, tanggal) tersimpan di query string URL. Anda dapat membagikan tautan dengan filter yang sudah terkonfigurasi.
Daftar Analytic Type ID
Setiap tipe analitik diidentifikasi dengan analytic_id yang unik. Tabel berikut menjadi referensi untuk query API maupun konfigurasi:
| Kategori | Nama Tampilan | analytic_id |
|---|---|---|
| Face Recognition | Face Recognition | NFV4-FR |
| Face Recognition | Face Recognition Attributes | NFV4-FRA |
| Face Recognition | Face Recognition Attributes (WZMND) | NFV4H-WZMND-FR |
| Face Recognition | Face Recognition Attributes (MOBLE) | NFV4H-MOBLE-FR |
| People Analytics | People Analytics | NFV4-MPA |
| People Analytics | People Analytics Attributes | NFV4-MPAA |
| People Analytics | People Analytics Attributes 2 | NFV4-MPA2 |
| Vehicle Analytics | Vehicle Analytics | NFV4-MVA |
| Vehicle Analytics | Vehicle Analytics Attributes | NFV4-MVAA |
| Vehicle Analytics | Vehicle Analytics Speed | NFV4-MVAS |
| LPR | License Plate Recognition | NFV4-LPR |
| LPR | License Plate Recognition v2 | NFV4-LPR2 |
| LPR | License Plate Recognition v3 | NFV4-LPR3 |
| Crowd Estimation | Crowd Estimation | NFV4-CE |
| PPE Detection | Personal Protective Equipment | NFV4-PPE |
Tidak semua analytic_id tersedia di setiap deployment. Daftar analitik yang aktif dapat diambil dari endpoint GET /api/visionaire/analytic_list atau GET /api/visionaire_active_analytic_list.
Pola Umum API Statistics
Semua data Statistics diambil dari satu endpoint induk dengan sub-path per tipe analitik.
Endpoint Induk
GET /api/statisticsQuery Parameter Umum
| Parameter | Tipe | Deskripsi |
|---|---|---|
stream_id | string | ID stream, pisahkan dengan koma untuk beberapa stream |
filter[stream_id] | string | Alias stream ID (beberapa endpoint menggunakan format ini) |
filter[timestamp_from] | string (ISO 8601) | Awal rentang waktu, contoh: 2025-01-01T00:00:00+07:00 |
filter[timestamp_to] | string (ISO 8601) | Akhir rentang waktu, contoh: 2025-01-31T23:59:59+07:00 |
start_date | string (YYYY-MM-DD) | Tanggal mulai (beberapa endpoint menggunakan format ini) |
end_date | string (YYYY-MM-DD) | Tanggal akhir |
analytic_id | string | ID tipe analitik, misalnya NFV4-FR, NFV4-MPA |
Contoh Request
# Statistik Face Recognition untuk stream tertentu, rentang 7 hari
GET /api/statistics?analytic_id=NFV4-FR&stream_id=stream-abc123&start_date=2025-01-01&end_date=2025-01-07
# Dengan autentikasi Token
curl -H "Authorization: Bearer <Token>" \
"https://your-lenz-host/api/statistics?analytic_id=NFV4-MPA&stream_id=stream-xyz&start_date=2025-04-01&end_date=2025-04-30"Mode Federation
Jika deployment menggunakan mode Federation (multi-instance), sertakan parameter tambahan:
# Dengan instance spesifik
GET /api/statistics?analytic_id=NFV4-FR&instance=instance-id-001&stream_id=...
# Agregasi lintas instance (tanpa instance spesifik)
GET /api/statistics?analytic_id=NFV4-FR&is_aggregated=true&stream_id=...Endpoint Ekspor PDF
Laporan PDF dihasilkan melalui endpoint terpisah:
GET /api/event-historyParameter ekspor yang relevan:
| Parameter | Tipe | Deskripsi |
|---|---|---|
category | string | Kategori ekspor: fr, fra, lpr, mpa-counting, mpa-density, mpa-dwelling, mva-counting, ce, ppe, dll. |
stream_ids | string[] | Array ID stream yang dipilih |
start_date | string (YYYY-MM-DD) | Tanggal mulai |
end_date | string (YYYY-MM-DD) | Tanggal akhir |
lang | string | Bahasa laporan: id (Indonesia) atau en (Inggris) |
timezone | string | Zona waktu, default: Asia/Jakarta |
Detail endpoint per tipe analitik (sub-path, schema response, contoh payload) tersedia di halaman masing-masing tipe Statistics di bawah.
Tips & Troubleshooting
Selanjutnya
Pilih tipe Statistics yang ingin Anda pelajari lebih lanjut:
Face Recognition
Pelajari metrik, chart, dan cara query data statistik pengenalan wajah.
People Analytics
Panduan lengkap statistik lalu lintas orang: counting, density, dan dwelling.
Vehicle Analytics
Statistik kendaraan termasuk counting, density, dwelling, dan speed.
Crowd Estimation
Memahami statistik estimasi kerumunan dan cara interpretasi datanya.
LPR
Statistik License Plate Recognition dan perbedaan antara LPR, LPR2, dan LPR3.
API Reference
Dokumentasi lengkap seluruh endpoint Statistics API: parameter query, schema response, kode error, dan contoh ekspor PDF.
API Reference — Tracking
Endpoint untuk Face Tracking (pelacakan pergerakan individu berdasarkan face_id) dan Plate Tracking (pelacakan kendaraan berdasarkan nomor plat LPR).
API Reference — Statistics
Endpoint untuk mengambil data metrik agregat per domain analitik — Face Recognition, People Analytics, Vehicle Analytics, Crowd Estimation, dan LPR.