Resolved place metadata for a `(lat, lon)` query against `GET /v1/geocode/reverse`. All fields are best-effort: `city` is populated when the coordinate falls inside a populated-place polygon; `nearest_city` is populated when the coordinate is outside any city polygon but within the resolution radius of one. `state` carries the canonical NWS region label. Forward-compat: additional fields may appear in this object without a sw-api release.
CompanyWeatherDataForecastingClimate
Properties
Name
Type
Description
city
string
Populated-place name when the query coordinate falls inside a city polygon. Empty when only `nearest_city` is set.
nearest_city
string
Closest populated-place name when the query coordinate is outside any city polygon. Empty when `city` is set.
state
string
Canonical NWS state / region label (e.g. "Illinois", "Puerto Rico").
county
string
County or equivalent admin-2 area, when available.
timezone
string
IANA timezone identifier covering the query coordinate.
{
"$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
}
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.