Struktur Data

Overview

Mertani menyimpan setiap data sensor yang dikirimkan oleh perangkat dalam format terstruktur. Setiap entri data dilengkapi dengan timestamp untuk memastikan akurasi waktu pencatatan serta memudahkan proses analisis historis.

Struktur ini dirancang agar:

Konsisten untuk berbagai jenis sensor
Mudah diproses oleh sistem integrasi
Fleksibel untuk penambahan sensor baru

Struktur Data Sensor

Field Sensor

Setiap sensor memiliki struktur berikut:

timestamp (String - ISO 8601)

Menunjukkan waktu kapan data dicatat. Format ISO 8601 itu standar internasional, misalnya:

2025-11-20T00:00:00+07:00

Artinya:

2025-11-20 → tanggal
T → pemisah tanggal & waktu
00:00:00 → jam (HH:mm:ss)
+07:00 → zona waktu (WIB)

id (string)

Identitas unik dari sensor. Contoh:

Y789-flLev

Biasanya berisi:

kode device
jenis sensor (misalnya: flLev = water level)

value (number)

Nilai hasil pembacaan sensor. Contoh:

25.5

Karakteristik:

Bertipe numerik (integer atau float)
Tidak mengandung satuan
Representasi murni dari hasil pengukuran

unit (string)

Menunjukkan satuan dari nilai sensor.

cm

Contoh satuan yang umum:

cm → centimeter
% → persen (humidity)
°C → derajat Celsius

Contoh Data sensor

Berikut contoh data sensor yang dikirim dalam satu request:

1 {
2   "timestamp": "2025-11-20T00:00:00+07:00",
3   "sensors": [
4     {
5       "id": "Y789-flLev",
6       "value": 25.5,
7       "unit": "cm"
8     },
9     {
10       "id": "Y789-arHum",
11       "value": 80,
12       "unit": "%"
13     },
14     {
15       "id": "Y789-arTemp",
16       "value": 32,
17       "unit": "°C"
18     }
19   ]
20 }

1	{
2	"timestamp": "2025-11-20T00:00:00+07:00",
3	"sensors": [
4	{
5	"id": "Y789-flLev",
6	"value": 25.5,
7	"unit": "cm"
8	},
9	{
10	"id": "Y789-arHum",
11	"value": 80,
12	"unit": "%"
13	},
14	{
15	"id": "Y789-arTemp",
16	"value": 32,
17	"unit": "°C"
18	}
19	]
20	}