API

This page describes the API methods that can be used with the "hittegolven" use-case api.

Tree Detection

POST http://localhost:5000/temperatures/treedetection

This endpoint detects trees based on an ArcGis tile that is posted to it.

Request Body

Name	Type	Description
images	object	A list of objects containing an "image" key with a base64 encoded ArcGis image tile as value.

200 Returns the detected trees with a certainty score and the pixel location inside the tile.

{
    "detections": [
        {
            "box": {
                'top_left': {
                    'lat': 1.03,
                    'lon': 2.01,
                },
                'bottom_right': {
                    'lat': 1.05,
                    'lon': 2.08,
                }
            },
            "score": 0.25
        },
        ...
    ]
}

Locust prevention

GET http://localhost:5000/temperatures/locustdetection

This endpoint shows the goodness of fit for a farmers land in regards to it being a breeding ground for locusts.

Path Parameters

Name	Type	Description
	string

200 Returns all the farmers in the database and their danger_level regarding locusts.

{
    "risks": [
        {
            "lat": 1.05,
            "lon": 50.03,
            "danger_level": "mild",
            "messages": [
                {
                    "issue": "Note: the average surface temperature is NOT ideal for hoppers",
                    "solution":"Field may be not very ideal for hoppers. \
                            Nonetheless the farmer should do the following to make it even less ideal: \
                            Have poultry; use synthetic/organic fertilizer; plant trees/bushes; cover soil permanently with vegetation \
                            OR leave strip of bare ground (2-3m wide) around fields (note: latter is vulnerable to soil erosion); \
                            plant sorghum around fields of millet."
                }
            ]
        }
    ]
}

Sources

HTTP Status Codes Cheatsheet