{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/thinair-co/json-schema/thinair-co-intersection-resolve-request-schema.json",
  "title": "IntersectionResolveRequest",
  "description": "Resolve a named cross-street to coordinates. The high-confidence tier (CSV) is US highways only; named non-highway streets resolve via the geocoder fallback (global, lower-confidence). For free-form streets use /v1/geocode.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/thinair-co-intersections-api-openapi.yml#/components/schemas/IntersectionResolveRequest",
  "type": "object",
  "properties": {
    "street1": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "First street of the cross-street pair."
    },
    "street2": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Second (cross) street of the pair."
    },
    "locality": {
      "type": "string",
      "maxLength": 2000,
      "description": "City / town that scopes the lookup."
    },
    "region": {
      "type": "string",
      "maxLength": 2000,
      "description": "State / province (full name or abbreviation, e.g. 'TX')."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 3,
      "description": "ISO 3166-1 alpha-2/alpha-3 country code to scope results."
    },
    "confidence_threshold": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Confidence floor (0–1) below which a CSV/geocoder hit falls through to the next resolution rung. Defaults to 0.5."
    }
  },
  "required": [
    "street1",
    "street2"
  ]
}