api.invoket.com

{
  "properties": {
    "data": {
      "properties": {
        "coverage": {
          "properties": {
            "complete": {
              "type": "boolean"
            },
            "reason": {
              "description": "Why the verdict is degraded, present when 'complete' is false: fewer than 20 fully-covered years in the sample, or a target season not covered at all — value, percentile, rank and return_period_years are then null rather than computed on a partial sample",
              "type": "string"
            }
          },
          "required": [
            "complete"
          ],
          "type": "object"
        },
        "grid": {
          "properties": {
            "distance_km": {
              "type": "number"
            },
            "lat": {
              "type": "number"
            },
            "lon": {
              "type": "number"
            }
          },
          "required": [
            "distance_km",
            "lat",
            "lon"
          ],
          "type": "object"
        },
        "lat": {
          "type": "number"
        },
        "location": {
          "description": "Echo of the resolved place when city=/location= was used — name, ISO country, admin1 code and the exact GeoNames coordinates; absent when lat/lon were passed directly",
          "type": "object"
        },
        "lon": {
          "type": "number"
        },
        "method": {
          "description": "Always 'empirical' in v1: rank within the sample, no extreme-value (GEV) fit",
          "type": "string"
        },
        "percentile": {
          "description": "Empirical percentile of the target year within the historical sample (rank / sample_years)",
          "type": [
            "number",
            "null"
          ]
        },
        "rank": {
          "type": [
            "integer",
            "null"
          ]
        },
        "return_period_years": {
          "description": "Empirical recurrence interval in years of a season at least this extreme, by Weibull plotting position (finite even for the record)",
          "type": [
            "number",
            "null"
          ]
        },
        "sample_years": {
          "description": "Number of fully-covered historical years in the sample; always reported (a verdict on fewer than 20 years is flagged coverage.complete=false)",
          "type": "integer"
        },
        "season": {
          "type": "string"
        },
        "stat": {
          "type": "string"
        },
        "unit": {
          "type": "string"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        },
        "variable": {
          "type": "string"
        },
        "year": {
          "type": "integer"
        }
      },
      "required": [
        "coverage",
        "lat",
        "lon",
        "method",
        "percentile",
        "rank",
        "return_period_years",
        "sample_years",
        "season",
        "stat",
        "unit",
        "value",
        "variable",
        "year"
      ],
      "type": "object"
    },
    "provenance": {
      "properties": {
        "dataset": {
          "description": "Stable machine identifier of the dataset that served the response: era5 (Copernicus ERA5 reanalysis). Branch on this field rather than parsing provenance.source, which carries a human-readable label whose wording is not part of the contract.",
          "type": "string"
        },
        "fetched_at": {
          "type": "string"
        },
        "freshness": {
          "properties": {
            "as_of": {
              "type": "string"
            },
            "kind": {
              "type": "string"
            }
          },
          "required": [
            "as_of",
            "kind"
          ],
          "type": "object"
        },
        "source": {
          "type": "string"
        }
      },
      "required": [
        "dataset",
        "fetched_at",
        "freshness",
        "source"
      ],
      "type": "object"
    }
  },
  "required": [
    "data",
    "provenance"
  ],
  "type": "object"
}