apyhub
Back
▣ GEOLOCATION · STANDARD DATA

US Climate Exposure API

What it does

Climate Exposure helps you look up climate risk exposure for a geographic point. Send lat and lon, and optionally set radius_m to define the surrounding area to evaluate. The response returns a structured exposure result for that coordinate.

Use Climate Exposure when you need location-aware context inside mapping, insurance, real-estate, environmental, or asset-risk workflows. It fits cases where a user enters an address, a property is plotted on a map, or an internal system needs to assess exposure around a site before showing next-step actions.

The request schema is simple: latitude and longitude are required, and radius_m defaults to 2000 with a supported range from 100 to 50000. That makes it easy to query a tight local area or widen the search radius when your analysis needs a larger buffer.

The output schema is flexible and returned as a JSON object, so you can integrate the exposure result into your own risk model, dashboard, or downstream enrichment pipeline.

GET
Coordinate climate exposure
https://api.eu.apyhub.com/dosvak/coordinate-climate-exposure

QUICKSTART

GUIDE

Quickstart

Look up climate exposure for a latitude/longitude pair, using the default radius.

curl -X GET "https://api.eu.apyhub.com/dosvak/coordinate-climate-exposure?lat=34.0522&lon=-118.2437&radius_m=2000" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with additional top-level fields, but the schema does not declare any specific response properties.

{
  "input": {
    "lat": 34.0522,
    "lon": -118.2437,
    "radius_m": 2000
  },
  "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"
  },
  "geospatial_ready": false,
  "geospatial_exposure": null,
  "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 climate exposure information for a coordinate-based lookup using latitude and longitude, with an optional search radius in meters.

Query Parameter(s)

AttributeTypeMandatoryDescription
latNumberYesLatitude coordinate. Minimum -90, maximum 90.
lonNumberYesLongitude coordinate. Minimum -180, maximum 180.
radius_mIntegerNoSearch radius in meters. Default 2000. Minimum 100, maximum 50000.

Response

Returns a JSON object whose exact top-level fields are not defined in the schema. The response is an object with additional properties allowed, but the schema does not specify any named response fields.

ParameterTypeMandatoryDescription
▣ 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.