▣ 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

http://localhost:8080/dosvak/coordinate-climate-exposure

QUICKSTART

GUIDE

Quickstart

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

curl -X GET "http://localhost:8080/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

API key

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)

Attribute	Type	Mandatory	Description
lat	Number	Yes	Latitude coordinate. Minimum `-90`, maximum `90`.
lon	Number	Yes	Longitude coordinate. Minimum `-180`, maximum `180`.
radius_m	Integer	No	Search 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.

Parameter	Type	Mandatory	Description

Query parameters

Name

Type

Description

latREQUIRED

number

—

lonREQUIRED

number

—

radius_mOPTIONAL

integer

—

DEFAULT 2000

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