Intersections

Search for street intersections

Search for street-intersection candidates from a free-text cross-street query, scoped by optional locality/region/country. Returns ranked candidates plus a GeoJSON FeatureCollection. Costs 1 quota unit.

post/v1/intersections/search

Request

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

Request body

textstring required

Free-text intersection query (e.g. 'Broadway and 42nd Street').

localitystring

City / town hint.

regionstring

State / province hint.

countrystring

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

sizeinteger

Maximum candidates to return (1–40). Defaults to 5 in the service layer.

Example request

{
  "text": "Bellaire Blvd and Chimney Rock Rd",
  "locality": "Houston",
  "region": "TX",
  "country": "US",
  "size": 5
}

Response

Intersection search results.

warningsstring[]
upstream_errorstring nullable

Example response

{
  "features": [
    {
      "id": "ta_intersection_b3a9f27e61c04d58"
    }
  ]
}

Changes

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