Skip to main content
POST
Route Risk Analysis

Overview

The Route Risk Analysis API evaluates potential threats and hazards along a specified path or route. This endpoint analyzes various risk factors including geopolitical events, environmental hazards, infrastructure conditions, and real-time threat data to provide comprehensive risk assessments.

Authentication

This endpoint supports anonymous access for basic risk assessments, though authenticated requests receive more detailed analysis.

Request Body

array
required
Array of coordinate points defining the route to analyze. Each point should contain latitude and longitude.
array
Optional array of specific risk types to analyze. If not provided, all risk types are assessed.Available types: geopolitical, environmental, infrastructure, crime, traffic, weather
object
Optional time window for temporal risk analysis
string
default:"medium"
Analysis resolution: low, medium, high
  • low: Basic risk assessment with major threats only
  • medium: Standard assessment with moderate detail
  • high: Comprehensive assessment with fine-grained analysis

Example Requests

Response

array
Array of risk assessment points along the route
object
Overall route risk summary
array
Detailed threat information
array
Risk mitigation recommendations

Example Response

Risk Types

Geopolitical Risks

  • Political demonstrations and protests
  • Civil unrest and conflicts
  • Border tensions and restrictions
  • Government instability

Environmental Risks

  • Natural disasters (earthquakes, floods, storms)
  • Extreme weather conditions
  • Environmental hazards (pollution, radiation)
  • Climate-related threats

Infrastructure Risks

  • Road closures and construction
  • Bridge and tunnel conditions
  • Public transportation disruptions
  • Utility outages

Crime Risks

  • High crime areas
  • Recent criminal activity
  • Security incidents
  • Theft and violence hotspots

Traffic Risks

  • Congestion patterns
  • Accident-prone areas
  • Rush hour impacts
  • Special event traffic

Weather Risks

  • Current weather conditions
  • Weather forecasts
  • Seasonal weather patterns
  • Extreme weather alerts

Status Codes

OK
Risk analysis completed successfully
Bad Request
Invalid route points or request parameters
Unauthorized
Invalid or missing API key (for authenticated features)
Too Many Requests
Rate limit exceeded
Internal Server Error
Server error during risk analysis

Error Response

Integration Examples

JavaScript/Web

Python

Next Steps