Metadata

Metadata adalah pasangan kunci-nilai tambahan yang Anda lekatkan pada workspace, group, channel, dan device (dan akun, oleh administrator). Metadata dipakai untuk catatan, lokasi, gedung dan lantai, dan sumber data widget Peta dan Building Overview.

Di halaman detail, tab Metadata punya dua tampilan:

Entri: tabel Key, Tipe, Nilai, dan waktu diubah, dengan tombol Tambah metadata, ubah, dan hapus.
JSON: penyuntingan mentah.

Tipe entri

Tipe	Nilai
Text	Teks.
Number	Bilangan.
Boolean	True atau false.
JSON	Objek atau array JSON dengan validasi.
Location	Titik di peta `{lat, lng}`. Klik atau geser penanda.
Perimeter	Area di peta: `polygon` (3 sampai 200 titik), `circle` (pusat dan radius meter), atau `rectangle` (batas).

Format penyimpanan:

{
  "lokasi": { "value": { "lat": -6.2088, "lng": 106.8456 }, "type": "location" },
  "area-gudang": {
    "value": { "shape": "circle", "center": { "lat": -6.2088, "lng": 106.8456 }, "radius": 150 },
    "type": "perimeter"
  },
  "building": { "value": "A", "type": "text" },
  "floor": { "value": "1", "type": "text" }
}

Bentuk perimeter lain:

{"shape": "rectangle", "bounds": {"south": -6.21, "west": 106.84, "north": -6.20, "east": 106.85}}
{"shape": "polygon", "points": [{"lat": -6.208, "lng": 106.845}, {"lat": -6.209, "lng": 106.847}, {"lat": -6.207, "lng": 106.848}]}

lat harus antara -90 dan 90, dan lng antara -180 dan 180; entri di luar rentang dilewati.

Perilaku server

Entri bertipe (kunci hanya value, type, dan opsional updatedAt) divalidasi menurut tipenya. Nilai tidak sah ditolak dengan galat 422.
updatedAt dicap oleh server. Nilainya dipertahankan bila nilai dan tipe tidak berubah.
Entri bebas lama (bukan {value, type}) tetap diterima dan ditampilkan, tetapi widget Peta hanya membaca entri bertipe.

Dipakai di mana

Widget Peta: entri location menjadi penanda, entri perimeter digambar sebagai area. Lihat Dashboards.
Widget Building Overview: membaca entri teks atau angka dengan kunci building dan floor (kunci bisa diatur di widget).
Filter dan pencarian internal Anda sendiri lewat API.