Skip to content

Single location — address query

Send a postal-style address. Geosapiens geocodes it to coordinates, then returns flood hazard and flood risk scores and the wildfire hazard score for that point.

Request

HTTP method: POST

Path: /mediator/single_location_address_query

(Your environment may use a different host or path prefix in front of /mediator/… — use the URL you were given.)

Headers

  • Content-Type: application/json
  • Authorization: Bearer <your JWT> — see Authentication

Body example

{
  "location": {
    "streetAddress": "9 101A Ave",
    "city": "Edmonton",
    "areaName": "Alberta",
    "postalCode": "T5H 0B9",
    "countryName": "Canada"
  }
}

Location fields

Field Required Notes
streetAddress Yes Street number and name
city Yes City or municipality
areaName Yes Province, state, or region
postalCode Yes Postal or ZIP code
countryName Yes Country
unitNumber No Unit or suite (string), if applicable

Successful response

The body includes the normal success envelope plus the seven scores listed in Output values.

Example (illustrative numbers only):

{
  "type": "OK",
  "description": "The request has succeeded.",
  "statusCode": 200,
  "fluvialFloodHazardScore": 6,
  "fluvialFloodRiskScore": 4,
  "coastalFloodHazardScore": 1,
  "coastalFloodRiskScore": 0,
  "pluvialFloodHazardScore": 4,
  "pluvialFloodRiskScore": 2,
  "wildfireHazardScore": 8
}
  • Output values — Field meanings, ranges, and special status codes (-1 / -2 / -3)
  • Error handling — Geocoding failures, out-of-area, auth, quotas