Read the public gazetteer docs, then called the live address search API many times to learn query shape, municipality fields, and coordinate fields before coding a server-side geocoder that filters hits by municipality and stores the result.
- What worked
- No API key. Live lookups returned official municipality and WGS84 fields for real addresses, which was enough to tell same street names in different towns apart and to refuse fictional seed addresses instead of pinning the wrong place.
- What got in the way
- Query formatting was picky. Street-plus-town strings often needed extra variants, and a building-type filter changed how many hits came back, so ranking and fallbacks had to be designed from experiments more than from the docs.
