Read New Zealand weather and river observations

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "dataset": {
      "type": "string",
      "enum": [
        "severe_weather_warnings",
        "forecast",
        "current_conditions",
        "marine_forecast",
        "rainfall",
        "river_flow_level",
        "monitoring_sites"
      ],
      "description": "Choose severe_weather_warnings for official severe weather alerts; forecast, current_conditions or marine_forecast for point and marine forecasts; rainfall or river_flow_level for regional council gauge totals and flows; monitoring_sites to discover council monitoring stations."
    },
    "location": {
      "description": "Named NZ location (e.g. Auckland, Wellington, Christchurch, Queenstown) for forecasts or rainfall sites.",
      "type": "string",
      "maxLength": 100
    },
    "region": {
      "description": "NZ council identifier, required for rainfall, river_flow_level and monitoring_sites: gwrc (Wellington), hbrc (Hawke's Bay), marlborough, northland, tasman; auckland (monitoring_sites only).",
      "type": "string",
      "maxLength": 100
    },
    "site": {
      "description": "Gauge or site name to match (case-insensitive substring) for rainfall, river_flow_level or monitoring_sites.",
      "type": "string",
      "maxLength": 150
    },
    "measurement": {
      "description": "River measurement for river_flow_level: level (stage), flow (discharge), or any (default).",
      "default": "any",
      "type": "string",
      "enum": [
        "level",
        "flow",
        "any"
      ]
    },
    "latitude": {
      "description": "Latitude for custom point forecast coordinates (-48 to -33).",
      "type": "number",
      "minimum": -48,
      "maximum": -33
    },
    "longitude": {
      "description": "Longitude for custom point forecast coordinates (165 to 180).",
      "type": "number",
      "minimum": 165,
      "maximum": 180
    },
    "hours": {
      "description": "Hourly window: forecasts and rainfall totals 1–72; river_flow_level reads at most the last 6 hours. Defaults: 1 for current_conditions, 24 otherwise.",
      "type": "integer",
      "minimum": 1,
      "maximum": 72
    },
    "days": {
      "description": "Multi-day forecast outlook horizon (1–7 days). Converts to hourly forecast window.",
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "limit": {
      "default": 20,
      "description": "Maximum results to return (1–50, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "dataset",
    "limit"
  ],
  "additionalProperties": false
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "data": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "executionId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "creditsCharged": {
          "type": "number",
          "minimum": 0
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "summary",
        "data",
        "creditsCharged"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "additionalProperties": false
        },
        "usage": {
          "type": "object",
          "properties": {
            "credits_charged": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            "credits_remaining": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "credits_charged"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "error"
      ],
      "additionalProperties": false
    }
  ]
}