{"openapi":"3.1.0","info":{"title":"Italian Geocoding Worker","version":"0.0.1","description":"Forward geocoding for Italian addresses sourced from Overture Maps."},"servers":[{"url":"/"}],"x-index-release":"2026-04-15.0","paths":{"/v1/search":{"get":{"summary":"Forward geocode an Italian address","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":3}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":5}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Query too short"},"422":{"description":"Unparseable"},"503":{"description":"Index unavailable"}}}},"/v1/health":{"get":{"summary":"Service health","responses":{"200":{"description":"OK"}}}},"/v1/openapi.json":{"get":{"summary":"OpenAPI document","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Result":{"type":"object","required":["lat","lon","address","confidence","match_type"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"address":{"type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1},"match_type":{"type":"string","enum":["exact","civic_mismatch","partial"]}}},"SearchResponse":{"type":"object","required":["query","match_type"],"properties":{"query":{"type":"object","properties":{"raw":{"type":"string"},"parsed":{"type":"object","properties":{"road":{"type":"string"},"number":{"type":"string"},"city":{"type":"string"},"postcode":{"type":"string"}}}}},"match_type":{"type":"string","enum":["single","list"]},"best":{"$ref":"#/components/schemas/Result","nullable":true},"results":{"type":"array","items":{"$ref":"#/components/schemas/Result"}}}}}}}