API/Tipi Misure
Elenco dei gruppi di unità di misura utilizzate in SB
Abbiamo raggruppato le misure per gruppi.
Ad esempio sotto il gruppo Lunghezze, troveremo
metri, km, miglia, yards ecc..
Sotto il gruppo Energia: Joule, Kilowatt ora ecc.. le unità all'interno di ogni gruppo possono essere convertite tra di loro tramite un fattore moltiplicativo.
GET https://smartbiogas.it/api/v1/measure_groups
Risultato: Json con un array di risultati
[
{
"lca_unita_group_id": idGruppoUnitàDiMisura,
"f_group_description": "Descrizione del gruppo"
},
{
"lca_unita_group_id": 2,
"f_group_description": "Energia"
},
{
"lca_unita_group_id": 3,
"f_group_description": "Portata"
},
{
"lca_unita_group_id": 4,
"f_group_description": "Lunghezza"
},
...
]
Dati del gruppo di unità di misura:
GET https://smartbiogas.it/api/v1/measure_type//{idGruppoUnitàDiMisura}
esempio https://smartbiogas.it/api/v1/measure_groups/2
Risultato: Json con un sotto gruppo di unità presenti nel gruppo
{
"lca_unita_group_id": 2,
"f_group_description": "Energia",
"units": [
{
"lca_unita_misura_id": idUnitàDiMisura,
"f_description": "Descrizione unità di misura",
"f_um": "Abbreviativo dell'unità di misura",
"f_molt": Fattore moltiplicativo per la conversione
},
{
"lca_unita_misura_id": 6,
"f_description": "Joule",
"f_um": "J",
"f_molt": "1.00000000"
},
{
"lca_unita_misura_id": 26,
"f_description": "MegaJoule",
"f_um": "MJ",
"f_molt": "1000000.00000000"
},
{
"lca_unita_misura_id": 25,
"f_description": "Kilowatt ora",
"f_um": "kWh",
"f_molt": "3600000.00000000"
},
...
]
]
il fattore moltiplicativo serve al sistema per sapere come moltiplicare un determinato dato per standardizzare le letture.
Esempio: se si invia una misura da 1.5 MJ, il sistema sa che equivale a 1 500 000 J, se il punto di controllo utilizza dati in Kwh allora può dividere per 3 600 000 e salvare il dato standardizzato.
Interrogazione diretta
E' possibile interrogare direttamente i dati delle unità di misura senza sapere il gruppo tramite questa API
GET https://smartbiogas.it/api/v1/measure_units
e la sua relativa passando per ID