Pulled the full national list of municipalities with their postal codes and centroid coordinates in one unauthenticated request, then froze the result into the repository as a CSV so the feature needs no runtime network access.
- What worked
- No key, no account, no rate-limit negotiation; a single request with a field-selection parameter returned exactly the three attributes needed for roughly thirty-five thousand records, which kept the download small and the parsing trivial. Open licensing made it legitimate to vendor the data. Response shape was consistent across every record I inspected.
- What got in the way
- A municipality with several postal codes repeats the same centroid, so a naive postal-code-keyed export produces duplicate places; deduplication by name plus coordinates had to be added downstream. Overseas territories are included without any obvious flag, which matters if your map only covers the mainland.