Graniot API
  • Welcome!
  • Quick Start
  • Embedded Maps
  • Reference
    • API Reference
      • Accounts
      • Farms
        • Farm Managers
      • Parcels
        • Satellite Data
        • Plants
        • Crops
        • Weather Forecast
        • Historical weather data
      • Crops Families
      • Notes
  • Satellite Sources
    • Satellite Data Overview
    • Available Data Sources
      • Sentinel-2
      • PlanetScope
      • SkySat
      • Pleiades
      • Pléiades Neo
      • Maxar
Powered by GitBook
On this page
  1. Reference
  2. API Reference
  3. Parcels

Historical weather data

This API provides historical weather data on a daily basis, including comprehensive meteorological data for a specific location. Here's a description of each field within the response:

PreviousWeather ForecastNextCrops Families

Last updated 4 months ago

  • date: The related date in format YYYY-MM-DD.

  • relative_humidity_2m: Relative humidity at 2 meters above ground expressed in percentile.

  • rain_sum: Sum of daily rain.

  • et0_fao_evapotranspiration: The daily sum of ET₀ Reference Evapotranspiration of a well watered grass field.

  • temperature_2m_max: Maximum daily air temperature at 2 meters above ground.

  • temperature_2m_min: Minimum daily air temperature at 2 meters above ground.

  • temperature_2m_mean: Mean daily air temperature at 2 meters above ground.

Retrieve Historical Weather Data for a Parcel

get

Fetches aggregated historical weather data (daily rainfall, relative humidity, evapotranspiration, min/max/mean temperature) The query parameters are from and to (in YYYY-MM-DD format). from must be before or equal to to, and both must not be in the future.

Path parameters
idstringRequired
Query parameters
fromstring · dateRequired

Start date (YYYY-MM-DD). Must be <= to.

tostring · dateRequired

End date (YYYY-MM-DD). Must be >= from.

Responses
200
Successful response containing aggregated weather data.
application/json
400
Bad Request - Invalid or missing parameters.
get
GET /api/parcels/{id}/historical-weather-data/?from=2025-06-13&to=2025-06-13 HTTP/1.1
Host: 
Accept: */*
{
  "status": "success",
  "data": [
    {
      "date": "2024-12-23",
      "relative_humidity_2m": 51.12,
      "rain_sum": 0,
      "et0_fao_evapotranspiration": 2.1,
      "temperature_2m_max": 16.1,
      "temperature_2m_min": 4.3,
      "temperature_2m_mean": 9.8,
      "rain_acc": 0
    },
    {
      "date": "2024-12-24",
      "relative_humidity_2m": 61.88,
      "rain_sum": 0,
      "et0_fao_evapotranspiration": 1.82,
      "temperature_2m_max": 17.3,
      "temperature_2m_min": 5.2,
      "temperature_2m_mean": 9.6,
      "rain_acc": 0
    }
  ]
}