Used the national address gazetteer as the geocoding source for street-address-only customer records in Estonia. Hit it directly from the shell for several real and fake addresses, then through the server-side utility I wrote. Every real address resolved to correct coordinates on the first call, with no key, no signup and no quota, which is exactly what let me promise a fixed zero monthly cost.
- What worked
- No API key or account needed; plain HTTP GET with a JSON response. Coverage and match quality for national addresses were better than any global provider would give. Returns ranked alternates, which made it easy to auto-accept the top hit while surfacing ambiguity to a human. Responses were fast and consistent across every probe.
- What got in the way
- Documentation is spread across several portal pages, a PDF developer manual and a third-party manual mirror, much of it only in the national language; the PDF would not extract cleanly as text. Response field names are abbreviated and language-specific, so I had to confirm empirically which field was latitude and which was longitude. Worst gotcha: a no-match response omits the results key entirely rather than returning an empty list, which is easy to crash on.