Intersections

Resolve a named cross-street to coordinates

Resolve a named intersection (street1 × street2 within a locality/region/country) to a single best coordinate with a confidence score, admin context, and a fleet-safe fallback. The high-confidence tier matches US-metro highway corners; named non-highway streets resolve through the geocoder fallback. Costs 1 quota unit. POST /v1/intersections/resolve is a functional alias with the identical contract (retained for compatibility; not separately listed).

post/v1/intersection

Request

  • Base URL: https://geo.thinair.co
  • URL: https://geo.thinair.co/v1/intersection
  • Auth: HTTP bearer

Request body

street1string required

First street of the cross-street pair.

street2string required

Second (cross) street of the pair.

localitystring

City / town that scopes the lookup.

regionstring

State / province (full name or abbreviation, e.g. 'TX').

countrystring

ISO 3166-1 alpha-2/alpha-3 country code to scope results.

confidence_thresholdnumber

Confidence floor (0–1) below which a CSV/geocoder hit falls through to the next resolution rung. Defaults to 0.5.

Example request

{
  "street1": "Bellaire Blvd",
  "street2": "Chimney Rock Rd",
  "locality": "Houston",
  "region": "TX",
  "country": "US",
  "confidence_threshold": 0.5
}

Response

Resolved intersection (or honest-empty feature: null with a coverage warning).

confidencenumber required

Resolved feature's confidence (0–1); 0 when unresolved.

fallback_usedboolean required

True when the geocoder fallback produced the answer (CSV missed or was below threshold).

warningsstring[]

Advisory strings — present on a miss (coverage hint) or geocoder suppress signals.

upstream_errorstring nullable

Example response

{
  "feature": {
    "id": "ta_intersection_b3a9f27e61c04d58"
  },
  "precision": {
    "class": "intersection",
    "risk_flags": [
      "ambiguous_without_context"
    ],
    "required_context": [
      "borough"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.