{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/thinair-co/json-schema/thinair-co-intersection-search-request-schema.json",
  "title": "IntersectionSearchRequest",
  "description": "Search for intersection candidates from a free-text cross-street query.",
  "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/IntersectionSearchRequest",
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Free-text intersection query (e.g. 'Broadway and 42nd Street')."
    },
    "locality": {
      "type": "string",
      "maxLength": 2000,
      "description": "City / town hint."
    },
    "region": {
      "type": "string",
      "maxLength": 2000,
      "description": "State / province hint."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 3,
      "description": "ISO 3166-1 alpha-2/alpha-3 country code to scope results."
    },
    "size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Maximum candidates to return (1–40). Defaults to 5 in the service layer."
    }
  },
  "required": [
    "text"
  ]
}