Docs

A free, public, edge-native forward geocoder for Italian addresses. Backed by Overture Maps. Public for now — please be kind to it.

1. Quick start

curl --get "https://geocoding.qubitdata.it/v1/search" \
  --data-urlencode "q=Via Romagnosi 1, Milano"

2. Response shape

Adaptive: single best when confidence > 0.95, ranked list otherwise.

{
  "query": {
    "raw": "Via Romagnosi 1, Milano",
    "parsed": { "road": "via romagnosi", "number": "1", "city": "milano" }
  },
  "match_type": "single",
  "best": {
    "lat": 45.4684,
    "lon": 9.19054,
    "address": "Via Romagnosi 1, Milano",
    "confidence": 1.0,
    "match_type": "exact"
  }
}

When match_type is "list", a results array is included (best first, descending confidence).

3. Italian-aware parsing

V.le, P.zza, C.so, Lgt. expanded to Viale, Piazza, Corso, Lungotevere
Civic suffixes preserved: 12/A, 12 bis, snc
Diacritics stripped: Via Ètna → via etna
SS / SP road numbers stay in road name (not parsed as civic)

4. Errors

Status	Code	Meaning
400	query_too_short	q must be ≥ 3 chars
422	unparseable	parser couldn't extract road
503	index_unavailable	retry; index transiently unreachable

5. Support

Questions, integration help, enterprise terms: support@qubitdata.it