{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/smarterweather-com/json-schema/smarterweather-com-reverse-geocode-response-schema.json",
  "title": "ReverseGeocodeResponse",
  "description": "Resolved place metadata for a `(lat, lon)` query against\n`GET /v1/geocode/reverse`. All fields are best-effort: `city`\nis populated when the coordinate falls inside a populated-place\npolygon; `nearest_city` is populated when the coordinate is\noutside any city polygon but within the resolution radius of\none. `state` carries the canonical NWS region label.\n\nForward-compat: additional fields may appear in this object\nwithout a sw-api release.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/smarterweather-com-geocode-api-openapi.yml#/components/schemas/ReverseGeocodeResponse",
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Populated-place name when the query coordinate falls inside\na city polygon. Empty when only `nearest_city` is set.\n"
    },
    "nearest_city": {
      "type": "string",
      "description": "Closest populated-place name when the query coordinate is\noutside any city polygon. Empty when `city` is set.\n"
    },
    "state": {
      "type": "string",
      "description": "Canonical NWS state / region label (e.g. \"Illinois\",\n\"Puerto Rico\").\n"
    },
    "county": {
      "type": "string",
      "description": "County or equivalent admin-2 area, when available.\n"
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone identifier covering the query coordinate.\n"
    }
  },
  "additionalProperties": true
}