Location-Based Hazard Risk¶
Query climate hazard risk metrics for specific geographic locations using global hazard maps.
Endpoint¶
Authentication¶
Required. Include your API key in the X-API-Key header.
Overview¶
The hazard risk endpoint provides location-based climate hazard data from global hazard maps. The API supports:
- Geographic queries: Look up hazard metrics by latitude/longitude coordinates
- Multiple hazard types: Access various physical climate hazards
- Scenario analysis: Query hazards under different climate scenarios
- Batch queries: Submit multiple locations in a single request
Request Structure¶
Query Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
latitude |
number | Yes | Latitude coordinate (-90 to 90) |
longitude |
number | Yes | Longitude coordinate (-180 to 180) |
hazards |
array | Yes | Array of hazard types: cyclones, wildfire, coastal_floods, riverine_floods |
analysis_years |
array | Yes | Array of years for hazard data. Available years vary by hazard type (see Available Hazards) |
scenarios |
array | Yes | Array of climate scenarios: baseline, rcp2p6, rcp4p5, rcp6p0, rcp8p5 |
radius |
number | No | Radius in kilometers for spatial aggregation (0-100km, default: 0). When > 0, aggregates hazard data within the specified radius of the location |
aggregation_method |
string | No | Method for aggregating risk within radius: max (default) or mean. Only applies when radius > 0 |
total_hazard |
boolean | No | Return total hazard metric (default: false) |
anthropogenic |
boolean | No | Return anthropogenic contribution only (default: false) |
Example Request¶
GET /api/v1/hazard-risk?latitude=40.7128&longitude=-74.0060&hazards=cyclones,wildfire&analysis_years=2030,2050&scenarios=rcp4p5,rcp8p5
Example Request with Radius¶
Query hazard data aggregated within a 50km radius using maximum risk values:
GET /api/v1/hazard-risk?latitude=40.7128&longitude=-74.0060&hazards=cyclones&analysis_years=2050&scenarios=rcp8p5&radius=50&aggregation_method=max
Batch Request¶
POST /api/v1/hazard-risk/batch
[
{
"latitude": 40.7128,
"longitude": -74.0060,
"hazards": ["cyclones", "wildfire"],
"analysis_years": [2030, 2050],
"scenarios": ["rcp4p5", "rcp8p5"]
},
{
"latitude": 51.5074,
"longitude": -0.1278,
"hazards": ["riverine_floods"],
"analysis_years": [2030],
"scenarios": ["rcp4p5"],
"radius": 25,
"aggregation_method": "mean"
}
]
Available Hazards¶
The API provides access to four climate hazard types with varying temporal and scenario coverage:
Hazard Coverage Summary¶
| Hazard | Years Available | Scenarios Available | Metrics | Resolution |
|---|---|---|---|---|
| Cyclones | 1980, 2025, 2030, 2040, 2050, 2080 | baseline, rcp2p6, rcp4p5, rcp6p0, rcp8p5 | intensity, wind_speed_mps, probability | 0.1° |
| Wildfire | 1980, 2025, 2030, 2040, 2050, 2080 | baseline, rcp2p6, rcp4p5, rcp6p0, rcp8p5 | intensity, fire_danger_days, probability | 0.1° |
| Coastal Floods | 1980, 2030, 2050, 2080 | baseline, rcp4p5, rcp8p5 | intensity, depth_meters, probability | 0.0089° |
| Riverine Floods | 1980, 2030, 2050, 2080 | baseline, rcp4p5, rcp8p5 | intensity, depth_meters, probability | 0.0089° |
Hazard Details¶
Cyclones (cyclones)¶
- Available years: 1980, 2025, 2030, 2040, 2050, 2080
- Scenarios: All RCP scenarios (baseline, rcp2p6, rcp4p5, rcp6p0, rcp8p5)
- Metrics:
intensity: Cyclone intensity levelwind_speed_mps: Maximum wind speed in meters per secondprobability: Probability of occurrence- Resolution: 0.1° (approximately 11km at equator)
Wildfire (wildfire)¶
- Available years: 1980, 2025, 2030, 2040, 2050, 2080
- Scenarios: All RCP scenarios (baseline, rcp2p6, rcp4p5, rcp6p0, rcp8p5)
- Metrics:
intensity: Fire danger intensity levelfire_danger_days: Number of high fire danger daysprobability: Probability of wildfire occurrence- Resolution: 0.1° (approximately 11km at equator)
Coastal Floods (coastal_floods)¶
- Available years: 1980, 2030, 2050, 2080
- Scenarios: Limited scenarios (baseline, rcp4p5, rcp8p5)
- Metrics:
intensity: Flood intensity leveldepth_meters: Expected flood depth in metersprobability: Probability of flood occurrence- Resolution: 0.0089° (approximately 1km at equator)
- Note: Years 2025, 2040 not available. Scenarios rcp2p6 and rcp6p0 not available.
Riverine Floods (riverine_floods)¶
- Available years: 1980, 2030, 2050, 2080
- Scenarios: Limited scenarios (baseline, rcp4p5, rcp8p5)
- Metrics:
intensity: Flood intensity leveldepth_meters: Expected flood depth in metersprobability: Probability of flood occurrence- Resolution: 0.0089° (approximately 1km at equator)
- Note: Years 2025, 2040 not available. Scenarios rcp2p6 and rcp6p0 not available.
Response Format¶
Success Response (200 OK)¶
The response returns results organized by hazard, scenario, and analysis year:
{
"location": {
"latitude": 40.7128,
"longitude": -74.0060
},
"results": [
{
"hazard": "cyclones",
"scenarios": [
{
"scenario": "rcp4p5",
"analysis_years": [
{
"analysis_year": 2030,
"metrics": {
"intensity": 2.8,
"wind_speed_mps": 52.3,
"probability": 0.12
}
},
{
"analysis_year": 2050,
"metrics": {
"intensity": 3.0,
"wind_speed_mps": 55.1,
"probability": 0.14
}
}
]
},
{
"scenario": "rcp8p5",
"analysis_years": [
{
"analysis_year": 2030,
"metrics": {
"intensity": 3.0,
"wind_speed_mps": 54.8,
"probability": 0.13
}
},
{
"analysis_year": 2050,
"metrics": {
"intensity": 3.5,
"wind_speed_mps": 62.4,
"probability": 0.18
}
}
]
}
]
},
{
"hazard": "wildfire",
"scenarios": [
{
"scenario": "rcp4p5",
"analysis_years": [
{
"analysis_year": 2030,
"metrics": {
"intensity": 3.2,
"fire_danger_days": 35,
"probability": 0.20
}
},
{
"analysis_year": 2050,
"metrics": {
"intensity": 3.8,
"fire_danger_days": 42,
"probability": 0.25
}
}
]
},
{
"scenario": "rcp8p5",
"analysis_years": [
{
"analysis_year": 2030,
"metrics": {
"intensity": 3.5,
"fire_danger_days": 40,
"probability": 0.23
}
},
{
"analysis_year": 2050,
"metrics": {
"intensity": 4.5,
"fire_danger_days": 55,
"probability": 0.32
}
}
]
}
]
}
]
}
Response Fields:
- location: Queried coordinates
- results: Array of results for each requested hazard
- hazard: Hazard type
- scenarios: Array of results for each requested scenario
- scenario: Climate scenario identifier
- analysis_years: Array of results for each requested year
- analysis_year: Year of hazard assessment
- metrics: Object containing hazard-specific metrics (varies by hazard type)
Response with Radius Aggregation¶
When a radius is specified, the response includes aggregation metadata:
{
"location": {
"latitude": 40.7128,
"longitude": -74.0060
},
"aggregation": {
"radius_km": 50,
"method": "max"
},
"results": [
{
"hazard": "cyclones",
"scenarios": [
{
"scenario": "rcp8p5",
"analysis_years": [
{
"analysis_year": 2050,
"metrics": {
"intensity": 3.8,
"wind_speed_mps": 65.2,
"probability": 0.22
}
}
]
}
]
}
]
}
Single Hazard Response Example¶
For a simpler query with one hazard, one scenario, and one analysis year:
{
"location": {"latitude": 25.7617, "longitude": -80.1918},
"results": [
{
"hazard": "cyclones",
"scenarios": [
{
"scenario": "rcp8p5",
"analysis_years": [
{
"analysis_year": 2050,
"metrics": {
"intensity": 3.2,
"wind_speed_mps": 58.5,
"probability": 0.15
}
}
]
}
]
}
]
}
Common Use Cases¶
- Asset Location Risk Assessment: Evaluate physical climate risks for specific asset locations
- Portfolio Geographic Analysis: Assess hazard exposure across multiple locations
- Site Selection: Compare hazard risks between potential locations
- Climate Adaptation Planning: Understand future hazard exposure under different scenarios
- Area-Based Risk Analysis: Use radius aggregation to assess risk across a facility footprint or region (e.g., max wildfire risk within 25km of a site)
General Limitations¶
- Hazard data availability may be limited in certain geographic regions
- Data quality depends on underlying climate models and observational data
- Probability metrics represent statistical likelihood, not certainty
- Historical baseline (1980) represents pre-climate change conditions for comparison