Mulai Cepat API Traffic Monitor

Panduan mulai cepat ini membaca angka lalu lintas suatu lokasi jalan dari perangkat Traffic Monitor. Anda memerlukan curl dan sekitar sepuluh menit. Angka pada jawaban di bawah adalah nilai contoh.

Sebelum Anda Mulai

Mintalah Admin perangkat membuat akun API di dasbor (halaman Akun API) dengan:

• peran Pemantau di lokasi yang ingin Anda baca;
• cakupan read (tambahkan export untuk mengunduh log sebagai file);
• tanggal berakhir.

Nomor polisi adalah data pribadi: akun hanya melihatnya dengan cakupan personal_data, yang hanya dapat diberikan oleh pemilik perangkat. Panduan ini berjalan tanpa cakupan itu.

Admin memberikan token (<API_KEY> di bawah), alamat perangkat (<BOX_HOST>) dan salinan sertifikat perangkat (box.pem, dari Unduh sertifikat perangkat di halaman Akun API) beserta sidik jari SHA-256-nya: periksa seperti yang ditunjukkan Sertifikat Perangkat. Autentikasi dan Cakupan menjelaskan masing-masing.

Cari Lokasi Anda

curl --cacert box.pem \
  -H "Authorization: Bearer <API_KEY>" \
  "https://<BOX_HOST>/api/v1/sites"

{
  "items": [
    {
      "id": 1,
      "name": "North Plant",
      "timezone": "Asia/Jakarta",
      "created": "2026-10-01T02:00:00Z",
      "version": 4,
      "my_role": "viewer",
      "location": { "lat": -6.2, "lon": 106.8 },
      "area": null,
      "zones": 3
    }
  ]
}

Simpan id lokasi (di sini 1). Kamera lokasi ada di GET /api/v1/cameras.

Baca Ikhtisar Lalu Lintas

Mintalah satu periode dengan from dan to (RFC 3339; %2B adalah tanda + dari selisih zona waktu):

curl --cacert box.pem \
  -H "Authorization: Bearer <API_KEY>" \
  "https://<BOX_HOST>/api/traffic/v1/sites/1/overview?from=2026-11-01T00:00:00%2B07:00&to=2026-11-02T00:00:00%2B07:00"

{
  "vehicles": 18452,
  "by_class": { "car": 7311, "motorcycle": 9870, "bus": 212, "truck": 1003, "bicycle": 56 },
  "flow_per_min": 12.8,
  "speeds_measured": 15207,
  "mean_speed_kmh": 38.6,
  "p85_speed_kmh": 51.0,
  "plates_read_pct": 0.0,
  "incidents": { "speeding": 41, "wrong_way": 3, "stopped": 5, "congestion": 2, "watchlist": 0 },
  "congested_now": [
    { "camera_id": 21, "lane": "Lane 2", "occupancy": 82.0, "since": "2026-11-02T09:41:00Z" }
  ]
}

Kecepatan adalah perkiraan untuk manajemen lalu lintas; angka ini tidak dapat menjadi dasar penegakan hukum. Untuk volume per jam atau hari, panggil GET /api/traffic/v1/sites/1/trend; untuk jam puncak, histogram kecepatan dan porsi kelas, GET /api/traffic/v1/sites/1/analytics.

Baca Log Kendaraan

curl --cacert box.pem \
  -H "Authorization: Bearer <API_KEY>" \
  "https://<BOX_HOST>/api/traffic/v1/sites/1/logs?from=2026-11-01T00:00:00%2B07:00&to=2026-11-02T00:00:00%2B07:00&limit=50"

{
  "items": [
    {
      "id": "21:90311",
      "time": "2026-11-02T09:44:12Z",
      "camera_id": 21,
      "line": "count",
      "direction": "in",
      "lane": "Lane 1",
      "class": "car",
      "colour": "white",
      "speed_kmh": 42.5,
      "plate": null,
      "media": null,
      "photo": null
    }
  ],
  "next_before": "2026-11-02T09:44:09Z"
}

Setiap baris adalah satu kendaraan yang melintasi garis hitung. Tanpa cakupan personal_data, plate dan photo bernilai null. Untuk halaman berikutnya, kirim next_before sebagai before. Saring dengan class dan camera; unduh periode itu sebagai file dengan GET /api/traffic/v1/sites/1/logs/export?format=csv dan cakupan export.

Insiden (melaju terlalu cepat, melawan arah, kendaraan berhenti, kemacetan, temuan daftar pantau) ada di GET /api/traffic/v1/sites/1/incidents.

Umpan DATEX II

Pusat manajemen lalu lintas dapat menarik pengukuran lokasi sebagai XML DATEX II v3 dengan token umpannya sendiri, tanpa akun API: GET /api/traffic/v1/feeds/datex/1/measured-data dengan Authorization: Bearer <FEED_TOKEN>. Admin lokasi membuat token umpan di dasbor. Dokumen yang tersedia adalah measurement-sites, measured-data dan situations.

Langkah Berikutnya

• Kirim lintasan dan insiden ke sistem Anda tanpa perlu menanyakan berulang kali: Webhook (jenis peristiwa seperti traffic.passage, traffic.speeding dan traffic.congestion, serta ringkasan berkala).
• Selaraskan daftar pantau nomor polisi dengan sistem lain lewat kiriman daftar pantau bertanda tangan (POST /api/traffic/v1/feeds/watchlist/{site}), yang dijelaskan di referensi.
• Setiap operasi dan kolom: referensi API Traffic Monitor dan referensi API platform.