A new set of API endpoints in MeDAS (METOS Device Agnostic Solution) facilitates easy data upload from external devices to the FieldClimate system.
Batch File Upload
1. Reserve a Device Number
What does it mean: Before connecting a device, you need a unique device number assigned to it.
How to do it: Use the Reserve Device Endpoint:
POST https://api.fieldclimate.com/v2/medas/external-devices/stations
2. Choose and Configure Sensors
What does it mean: Devices come with different types of sensors (e.g., soil moisture, air temperature, humidity, among others.). You need to configure them properly.
How to do it: Check Available Sensors - Retrieve a list of supported sensors for the device:
GET https://api.fieldclimate.com/v2/medas/external-devices/sensors
Select the Sensors: Choose the ones you need for your data collection. For example, let's select Air temperature (200000) and Relative Humidity(200001).
3. Create the Device with Geo location and Sensors
What does it mean: The device needs to be registered with its location (latitude and longitude) and the configured sensors:
Device Details
'device_external_id' – Unique identifier for the external device. 'device_external_brand' – Brand or manufacturer of the device. 'device_description' – Brief description of the device's purpose or type. 'measurement_interval' – Frequency at which the device collects data.
Position
'longitude' – Geographic coordinate specifying east-west position. 'latitude' – Geographic coordinate specifying north-south position. 'altitude' (elevation) – Height above sea level. 'timezone_code' – Standardized code representing the device's time zone. 'continent' – Continent where the device is located. 'country' – Country where the device is located or operates.
Sensors
Any array of sensor codes representing the types of sensors attached to the device. Each code corresponds to a specific measurement compatibility (e.g., temperature, humidity, soil moisture).
How to do it: Use the Create Device API to set up the device as shown below:
POST - https://api.fieldclimate.com/v2/medas/external-devices/stations/F201586D
Sample:
{
"device_external_id": "some_id",
"device_external_brand": "Brand ABC",
"device_description": "This is the description of this device",
"config": {
"measurement_interval": 15
},
"position": {
"longitude": 47.2121,
"latitude": 15.6499,
"altitude": 100,
"timezone_code": "Europe/Vienna",
"continent": "EU",
"country": "AU"
},
"sensors": [
200000,
200001
]
}
4. Verify Device Configuration
What does it mean: Ensure the device has been set up correctly with the right sensors.
How to do it: Call the Check Device Configuration API to validate that 1) Device is properly registers, 2) Sensors are correctly assigned and 3) Location details are accurate:
GET https://api.fieldclimate.com/v2/medas/external-devices/stations/F201586D
5. Create a Measurement Data File
What does it mean: Based on the sensors selected, you need to map the sensor fields and create a CSV file to upload bulk data for the device.
How to do it: User the sensor fields API to check all the mandatory fields for the sensor:
For Air Temperature sensor
GET https://api.fieldclimate.com/v2/medas/external-devices/sensors/200000/sensor-fields
For Relative Humidity sensor
GET https://api.fieldclimate.com/v2/medas/external-devices/sensors/200001/sensor-fields
In our example, your file would appear somewhat like this if you wish to upload one hour of raw data:
6. Upload the Measurement File
What does it mean: Once the file is ready, you need to upload it so the system can process the sensor data. Ensure that the file contains all necessary information, columns and format in which our system expects it to be.
How to do it: Use the Upload Measurement File API:
POST https://api.fieldclimate.com/v2/medas/external-devices/measurements/F201586D/batch
INFO: If the file is successfully uploaded, it will be queued for processing. You will get the following email once the processing is completed: Processing Time: The processing can take from few seconds to 15 minutes to make the data available, depending on the size of the file
7. Checking Data on FieldClimate
What does it mean: once the upload and processing has been completed, the data will be available on FieldClimate.
How to do it: To check the data associated with the device, login onto your FieldClimate account at https://fieldclimate.com, look up for the device in the station list located in the upper right corner of the page and click on it to load the station data, as shown in the screenshot below:
INFO: If you have a disease model subscription or want to subscribe to one, the disease model data will also be available if your device contains all the sensors required for each disease model. More details you find at https://metos.global/en/disease-models/.