Earth Observation API

This section contains all the endpoints related to Earth observation data, including satellite imagery, vegetation indices, and soil moisture.

GET /v1/earth/imagery
Rate Limit: 100/min Cost: ₦0.0500

Get Satellite Imagery

Get satellite imagery for a specific location and date.

Example API Call

curl -X GET "https://api.riwe.io/v1/earth/imagery" \
  -H "X-API-KEY: your_api_key_here"

Example Response

{
    "location": {
        "latitude": 9.0765,
        "longitude": 7.3986,
        "name": "Abuja, Nigeria"
    },
    "date": "2023-07-15",
    "satellite": "Sentinel-2",
    "cloud_coverage": 5.2,
    "image_url": "https://example.com/images/satellite/abuja_20230715.jpg",
    "metadata": {
        "resolution": "10m",
        "bands": [
            "RGB",
            "NIR"
        ],
        "acquisition_time": "2023-07-15T10:30:45Z"
    }
}
GET /v1/earth/soil-moisture
Rate Limit: 200/min Cost: ₦0.0300

Get Soil Moisture

Get soil moisture data for a specific location and date range.

Example API Call

curl -X GET "https://api.riwe.io/v1/earth/soil-moisture" \
  -H "X-API-KEY: your_api_key_here"

Example Response

{
    "location": {
        "latitude": 9.0765,
        "longitude": 7.3986,
        "name": "Abuja, Nigeria"
    },
    "start_date": "2023-06-01",
    "end_date": "2023-07-01",
    "depth": "surface",
    "moisture_data": [
        {
            "date": "2023-06-01",
            "value": 0.32,
            "quality": "good"
        },
        {
            "date": "2023-06-08",
            "value": 0.28,
            "quality": "good"
        },
        {
            "date": "2023-06-15",
            "value": 0.35,
            "quality": "good"
        },
        {
            "date": "2023-06-22",
            "value": 0.3,
            "quality": "good"
        },
        {
            "date": "2023-06-29",
            "value": 0.25,
            "quality": "good"
        }
    ],
    "average_moisture": 0.3,
    "min_moisture": 0.25,
    "max_moisture": 0.35,
    "trend": "decreasing"
}
GET /v1/earth/ndvi
Rate Limit: 200/min Cost: ₦0.0300

Get Vegetation Index

Get Normalized Difference Vegetation Index (NDVI) data for a specific location and date range.

Example API Call

curl -X GET "https://api.riwe.io/v1/earth/ndvi" \
  -H "X-API-KEY: your_api_key_here"

Example Response

{
    "location": {
        "latitude": 9.0765,
        "longitude": 7.3986,
        "name": "Abuja, Nigeria"
    },
    "start_date": "2023-06-01",
    "end_date": "2023-07-01",
    "ndvi_data": [
        {
            "date": "2023-06-01",
            "value": 0.72,
            "quality": "good"
        },
        {
            "date": "2023-06-08",
            "value": 0.75,
            "quality": "good"
        },
        {
            "date": "2023-06-15",
            "value": 0.78,
            "quality": "good"
        },
        {
            "date": "2023-06-22",
            "value": 0.76,
            "quality": "good"
        },
        {
            "date": "2023-06-29",
            "value": 0.74,
            "quality": "good"
        }
    ],
    "average_ndvi": 0.75,
    "min_ndvi": 0.72,
    "max_ndvi": 0.78,
    "trend": "stable"
}