Qodex.ai

getRisksMetered

GET https://{{base_url}}/v1/getRisksMetered/?latitude={{latitude}}&longitude={{longitude}}

Returns risk data for either the specified latitude & longitude coordinates or for the specified address. Specify either latitute and longitude or the address query params.

Accepts either the public or private api keys.

Query parameters:

  1. latitude: latitude of the project as a
  2. longitude: longitude as a number
    - or -
  3. address: Address of the project as a string.

Results

  1. globalRiskScore: risk score (0-100) based on the global environmental and global societal risk scores.
  2. globalEnvironmentalRiskScore: risk score (0-100) based on the flood, storm events, earthquakes, wildfires and drought risk scores, weighted against their annual estimated damage.
  3. globalSocietalScore: risk score (0-100) based on the air pollution, crime, socioeconomic, healthcare infrastructure and nuclear risk scores.
  4. socioEconomicScore: county risk score (0-100) based on educational attainment, median household income, poverty, unemployment and income inequality data.
  5. stormScore: county risk score (0-100) based on the tornado, hail, snow, hurricane and blizzard risk scores.
  6. wildfireScore: block risk score (0-100) based on the local wildfire hazard potential (FSim) and the expected increase in summer temperatures under a moderate climate scenario.
  7. crimeScore: block group risk score (0-100) based on the violent and property crime rates in the Census block group corresponding to the provided coordinates. The data is either observed or predicted using our proprietary machine learning algorithm.
  8. droughtScore: block risk score (0-100) based on cumulative drought indexes at the location for the last 20 years.
  9. floodScore: risk score (0-100) associated with local FEMA Flood Maps enriched using our elevation algorithms.
  10. volScore: block risk score (0-100) based on the distance to the nearest volcano and its eruptive potential.
  11. nuclearScore: block risk score (0-100) based on nearby nuclear reactors characteristics and their distance to the provided coordinates.
  12. earthquakeScore: block risk score (0-100) based on the intensity of the earthquake happening with a 2% probability over 50 years.
  13. airQualityScore: block risk score (0-100) based on daily median and max Air Quality Indexes (AQIs) at the nearest monitor.
  14. healthcareScore: block risk score (0-100) based on distance to local hospitals, their characteristics, and additional health practitioner data.

socioEconomicData: includes the data used to generate the socioeconomic risk score. Variable names including ‘raw’ present original values (i.e. in dollars, percent, or without unit in the case of educational attainment). Other variables describe the same phenomenon. but have been converted to a 0-100 scale.

stormData: Data related to tornadoes, hurricanes, snow and hail storms:

  1. riskScoreTornadoes: sub-score related to Tornadoes, based on their past frequency and intensity at the provided location.
  2. riskScoreHurricanes: sub-score related to Hurricanes, based on their (recent) frequency and intensity at the provided location.
  3. riskScoreHailStorms: sub-score related to hail events, based on their past frequency and intensity at the provided location.
  4. riskScoreSnowStorms: sub-score related to snowstorms, based on their past frequency and intensity at the provided location.
  5. riskScoreBlizzard: sub-score related to blizzard events, based on their past frequency and intensity at the provided location.
  6. tornadoesFujitaCount: number of tornadoes recorded at the provided location, over a given Fujita scale threshold. In this list, aboveFujitaScale1 is a count of all tornadoes whose intensity was equal or greater than 1 on the Fujita scale.
  7. tornadoesFujitaScore: county tornado risk score (0-100) based on all recorded events over the selected threshold. In this list, aboveFujitaScale2 is a risk score based only on events whose intensity was equal or greater than 2 on the Fujita scale.
  8. hailCountSizes: number of hail events recorded at the provided location, where hail size was over a given threshold.
    1. allSizes: count of hail events having hit the county
    2. size05in: count of hail events with a hail size >= 0.5 inch
    3. size075in: count of hail events with a hail size >= 0.75 inch
    4. size1in: count of hail events with a hail size >= 1 inch
    5. size15in: count of hail events with a hail size >= 1.5 inch
  9. HailScoreSizes: The risk score associated with each size range. For example, size1in means risk score for hail events of size 1in and higher.
  10. snowCountInches: count of snow events where snowfall exceeded a given threshold
    1. snowfall4in: Count of historical snow events where the 24-hour snowfall exceeded 4 inches.
    2. snowfall8in: Exceeded 8 inches.
    3. snowfall12in: Exceeded 12 inches.
    4. snowScoreInches: County risk score (0-100) based on the frequency and intensity of snow events where snowfall exceeded a given threshold in the county including the provided location.
    5. snowfall4in: county risk score (0-100) based on the frequency and intensity of snow events where snowfall exceeded 4 inches in 24 hours.
    6. snowfall8in: exceeded 8 inches in 24 hours.
    7. snowfall12in: exceeded 12 inches in 24 hours.
    8. snowAlarmThreshold: the local 24-hour snowstorm warning threshold used in scoring, inspired from local snowstorm thresholds provided by the National Weather Service.
    9. totalSnowAllTime: total snowfall recorded.
  11. snowScoreInches: The risk score associated with each size range. For example, snowfall8in means risk score for hail events of size 8in and higher.
  12. hurricaneScoresKt: county hurricane scores (0-100), based on the intensity and frequency of hurricanes with wind speed over a selected threshold.
    1. allEvents: risk score (0-100) based on all recorded tropical and extratropical depressions, storms, and hurricanes.
    2. stormIntensity34kt: risk score based on recorded events over 34 knots (storms and hurricanes)
    3. hurricaneIntensity64kt: risk score based on recorded events over 64 knots (hurricanes)
  13. stormsEventsByWindSpeed: list of recorded storm events with wind speed over a selected threshold.
    1. hn34: all events
    2. hn34-64: storms (wind speed >=34 kt but < 64kt)
    3. hn64: hurricanes (wind speed >= 64kt)

volcanoData: data related to the volcano risk assessment.

  1. nearestVolcano: name of nearest volcano
  2. volcanoDistance: distance to the nearest volcano.

airQualData: data related to the air quality risk assessment

  1. nearestHubStation: nearest air quality monitor's name
  2. nearestHubDistance: distance to the nearest air quality monitor.
  3. medianAQI: median daily AQI.
  4. maxAQI: max daily AQI recorded.
  5. AQIValues2019: Max AQI values recorded for each month in 2019, starting with January.

droughtData: Data related to the drought risk assessment

  1. droughtIndex2000To2019: Yearly drought index in the Census block corresponding to the provided location, starting with 2000 and ending with 2019.
  2. numberWeeksAbnormallyDry: Number of weeks during which the county including the provided location was at least abnormally dry between 2000 and 2019.
  3. numberWeeksModerateDrought: Number of weeks during which the county including the provided location was at least under Moderate Drought between 2000 and 2019.
  4. numberWeeksSevereDrought: Number of weeks during which the county including the provided location was at least under Severe Drought between 2000 and 2019.

wildfireData: data related to the wildfire risk assessment.

  1. avgTempIncrease: average summer temperature expected increase under a moderate climate scenario (RCP4.5) for two Regional Climate Models, between 1950-2005 and 2006-2100.
  2. burnRiskDistribution: proportion of the county including the provided location subject to a very high, high, moderate, low or very low wildfire hazard potential.

floodData: data related to the flood risk assessment.

  1. averageAltitude: average elevation collected in the Census block including the provided location. Only available in coastal areas.
  2. expectedSeaLevelRise: expected sea level rise between 2020 and 2050 under a pessimistic climate scenario at the nearest gauge.
  3. isCoastalArea: dummy variable equal to 1 if the county is coastal (and hence if elevation data is available).

earthquakeData: data related to the earthquake risk assessment.

  1. earthquakeMercalliIndex: mercalli intensity of the earthquake happening with a 2% probability over 50 years at the census block resolution

Other:

  1. distanceNearestHospital: distance to the nearest hospital.
  2. hospitalsPerInhabitants: number of residents per hospital available at the county resolution.
  3. nearestNuclearPPDistance: distance to the nearest nuclear reactor.

crimeData: data related to the crime risk assessment.

  1. source: indicates whether the data was observed or predicted.
  2. medianHouseholdIncome: median household income in the block group including the provided location
  3. percentUnemployed: unemployment rate in the block group including the provided location
  4. population: total population in the block group including the provided location
  5. populationDensity: population density in the block group including the provided location
  6. povertyRate: poverty rate in the block group including the provided location
  7. policeDepartmentsNearby: number of police departments within 5 miles.
  8. violentCrimeNumber: yearly number of violent crimes observed or predicted in the block group including the provided location (including simple assaults).
  9. vehicleTheftNumber : yearly number of motor vehicle thefts observed or predicted in the block group including the provided location.
  10. vandalismNumber: yearly number of vandalism acts observed or predicted in the block group including the provided location.
  11. propertyCrimeScore: block group risk score (0-100) based on the observed or predicted property crime rate.
  12. violentCrimeScore: block group risk score (0-100) based on the observed or predicted violent crime rate.
  13. vehiculeTheftScore: block group risk score (0-100) based on the observed or predicted motor vehicle thefts per 1,000 residents.

Request Params

KeyDatatypeRequiredDescription
latitudestring
longitudestring

HEADERS

KeyDatatypeRequiredDescription
Apikeystring