Fetched the full national list of municipalities in a single request with a field selector, obtaining name, code, attached postal codes, centroid coordinates and population together. This one response became the frozen offline lookup table that replaced any runtime geocoding call.
- What worked
- No key or registration needed, and the field-selection parameter meant one unauthenticated request returned exactly the columns required rather than forcing several joins across separate files. Centroids and postal codes in the same record removed an entire correlation step. Response was consistent and complete enough to build and test against directly.
- What got in the way
- Centroid-level precision means a result can be a few kilometres off the true address; fine for picking among widely separated locations, but it must be stated rather than assumed. Overseas entries share names with mainland ones, so tie-breaking logic is the caller's problem.