apyhub
GEOLOCATION

US Climate Risk Score API

What it does

Climate Score returns a climate score for a specific latitude and longitude. Send lat and lon as query parameters, and get a structured response for that coordinate lookup.

Use Climate Score when you need to attach climate context to a place, compare locations, or add environmental scoring to a mapping workflow. It fits applications like site selection, location ranking, travel planning, and analytics dashboards that work with geographic coordinates.

The input is simple: lat must be a number between -90 and 90, and lon must be a number between -180 and 180. The endpoint responds with a JSON object, so you can process the result directly in your application without additional parsing steps.

If your product already works with coordinates, Climate Score gives you a lightweight way to enrich each point with climate-related data in a consistent API response.

GET
Coordinate climate score
http://localhost:8080/dosvak/coordinate-climate-score

QUICKSTART

GUIDE

Quickstart

Get the climate score for a specific latitude and longitude.

curl -X GET "http://localhost:8080/dosvak/coordinate-climate-score?lat=34.0522&lon=-118.2437" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with additional properties. The schema does not declare fixed response fields, so the exact keys may vary.

{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437
  },
  "risk": {
    "county_fips": "06037",
    "county_name": "Los Angeles County",
    "state_name": "California",
    "flood_risk": "5.289",
    "heat_risk": "0.0",
    "drought_risk": "0.0",
    "wildfire_risk": "0.0",
    "storm_risk": "5.204",
    "risk_score": "2.36305"
  },
  "attribution": [
    {
      "source": "NOAA NCEI",
      "dataset": "Storm Events Database",
      "license": "U.S. federal government data",
      "url": "https://www.ncei.noaa.gov/pub/data/swdi/stormevents/csvfiles/",
      "notice": "Climate risk scores are derived from NOAA storm event history and are not official NOAA risk ratings."
    },
    {
      "source": "U.S. Census Bureau TIGER/Line",
      "dataset": "TIGER/Line County Boundaries 2024",
      "license": "Public domain / U.S. federal government work",
      "url": "https://www2.census.gov/geo/tiger/TIGER2024/COUNTY/",
      "notice": "Derived from U.S. Census Bureau TIGER/Line boundary data; not endorsed or certified by the Census Bureau."
    }
  ]
}{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437
  },
  "risk": {
    "county_fips": "06037",
    "county_name": "Los Angeles County",
    "state_name": "California",
    "flood_risk": "5.289",
    "heat_risk": "0.0",
    "drought_risk": "0.0",
    "wildfire_risk": "0.0",
    "storm_risk": "5.204",
    "risk_score": "2.36305"
  },
  "attribution": [
    {
      "source": "NOAA NCEI",
      "dataset": "Storm Events Database",
      "license": "U.S. federal government data",
      "url": "https://www.ncei.noaa.gov/pub/data/swdi/stormevents/csvfiles/",
      "notice": "Climate risk scores are derived from NOAA storm event history and are not official NOAA risk ratings."
    },
    {
      "source": "U.S. Census Bureau TIGER/Line",
      "dataset": "TIGER/Line County Boundaries 2024",
      "license": "Public domain / U.S. federal government work",
      "url": "https://www2.census.gov/geo/tiger/TIGER2024/COUNTY/",
      "notice": "Derived from U.S. Census Bureau TIGER/Line boundary data; not endorsed or certified by the Census Bureau."
    }
  ]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the climate score for a coordinate pair supplied as query parameters. The request takes latitude and longitude and responds with a JSON object; the detailed response fields are not yet defined in the schema.

Query Parameter(s)

AttributeTypeMandatoryDescription
latNumberYesLatitude in decimal degrees. Minimum -90, maximum 90.
lonNumberYesLongitude in decimal degrees. Minimum -180, maximum 180.

Response

Returns a JSON object. The schema does not define fixed top-level response fields; additionalProperties: true means the response shape may include properties beyond those captured in the schema.

Query parameters

Name
Type
Description
latREQUIRED
number
lonREQUIRED
number
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.