EN/API/Measurement type
List of measurement unit groups used in SB
We have categorized measurements into groups.
For example, under the Length group, we find: meters, km, miles, yards, etc.
Under the Energy group: Joules, Kilowatt-hours, etc. Units within each group can be converted to each other using a multiplicative factor.
GET https://smartbiogas.it/api/v1/measure_groups
Result: Json with an array of results
[
{
"lca_unita_group_id": measurementUnitGroupId,
"f_group_description": "Group description"
},
{
"lca_unita_group_id": 2,
"f_group_description": "Energy"
},
{
"lca_unita_group_id": 3,
"f_group_description": "Flow rate"
},
{
"lca_unita_group_id": 4,
"f_group_description": "Length"
},
...
]
Measurement unit group details:
GET https://smartbiogas.it/api/v1/measure_type//{measurementUnitGroupId}
Example: https://smartbiogas.it/api/v1/measure_groups/2
Result: Json with a subgroup of units present in the group
{
"lca_unita_group_id": 2,
"f_group_description": "Energy",
"units": [
{
"lca_unita_misura_id": measurementUnitId,
"f_description": "Measurement unit description",
"f_um": "Measurement unit abbreviation",
"f_molt": "Multiplicative factor for conversion"
},
{
"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-hour",
"f_um": "kWh",
"f_molt": "3600000.00000000"
},
...
]
}
The multiplicative factor is used by the system to know how to multiply a specific data point to standardize readings.
Example: if a measurement of 1.5 MJ is sent, the system knows it is equivalent to 1,500,000 J; if the control point uses data in kWh, it can then divide by 3,600,000 and save the standardized data.
Direct query
It is possible to directly query measurement unit data without knowing the group via this API:
GET https://smartbiogas.it/api/v1/measure_units
And the relative call by ID: