Now live: Australia 🇦🇺 and New Zealand 🇳🇿 Try it out

Updates

on everything Geocodio

When a Place Has Many Names: Meet Geocodio’s Gazetteer Append

The answer to what a place is called isn’t always simple, and it may not match what you write on a mailing envelope. Geocodio’s new gazetteer append adds the town, county, and local council to addresses in the US, UK, Canada, Mexico, Australia, and New Zealand. 

When we launched in the UK, addresses there had a few surprises for us. We learned that there are three different kinds of counties and that the town or city name you’d write on a mailing envelope can often be different from the physical geographic town.

As we chewed through that, we realized that these things pop up in other countries, too. Geocodio’s standard results return an address the way you’d write it on a mailing envelope, plus the administrative county, yet that didn’t leave space for the many different ways someone might describe a place.

For example, Connecticut abolished counties in 1960, and they requested the Census Bureau stop returning them in 2019 and return Planning Regions instead. Yet they’re still used in everyday speech and for some financial compliance purposes.

And what about places with names in multiple languages?

All of that combined to lead us to creating a new gazetteer append: for when what place called isn’t a simple answer.

What does the Geocodio gazetteer add?

What the gazetteer adds depends on the country:

  • United Kingdom: Geographic town or village, historical and ceremonial counties (note: administrative counties are returned in the base response), and the local council, plus the county council in two-tier England. It also returns Welsh and Scottish Gaelic names where they're published, and UPRNs and USRNs for rooftop matches in Great Britain.

  • United States: the incorporated town, or the nearest populated place outside one. In Connecticut, it also adds the county people still use. For example, if you send us a Stamford address, the Western Connecticut Planning Region will be given as the county in the base response, and the gazetteer adds Fairfield County.

  • Canada: the city, town, or village, or the nearest named place outside one. For example, Wakefield, Québec, comes back as an unincorporated place, so you know it isn't a municipality of its own.

  • Mexico: the localidad and the municipio, or the alcaldía in Mexico City, each with its INEGI clave.

  • Australia: the council, as a Local Government Area with its ABS code.

  • New Zealand: the town and the council. For example, Te Papa returns Wellington as the town and Wellington City as the territorial authority.

The gazetteer guide walks through what you get in each country.

No charge for null results

You'll only be charged if there's data to return. For example, if you request gazetteer for Canberra, you won't be charged, as the Australian Capital Territory has no local government.

Let’s dive into the UK for a moment

The gazetteer is the most relevant in the UK. Chapel Stile in the Lake District shows just how many layers a UK address can have.

On an envelope, you wouldn’t write Chapel Stile, but Ambleside. And the “county” it belongs to depends on whether you want the ceremonial county (Cumbria), the historic county (Westmorland), or the local authority (Westmorland and Furness).

One address in the Lake District, five place names. The post town comes with every result, and the gazetteer adds the other four.

Go ahead and try it for yourself

Start using Gazetteer

The gazetteer append is available now through the Geocodio API for all of our endpoints: forward geocoding (starting from an address) or reverse geocoding (starting from coordinates) for single, batch, CSV list, and distance requests. You can add gazetteer to the fields parameter of your request on its own or with other appends.

curl "https://api.geocod.io/v2.1/geocode?q=Winchester+Cathedral,+The+Close,+Winchester+SO23+9LS&country=GB&fields=gazetteer&api_key=YOUR_API_KEY"

curl "https://api.geocod.io/v2.1/reverse?q=54.4560,-3.0880&fields=gazetteer&api_key=YOUR_API_KEY"

Spreadsheet uploads. The gazetteer append is also available through the spreadsheet upload tool. During the upload process, choose Gazetteer in Step 2 (Data Appends).

Cost

The gazetteer, like all data appends, is available at all plan levels.

The gazetteer append adds one lookup per address, however many of the slots it fills (as long as they aren’t all null). So an address with fields=gazetteer uses two credits. If there isn’t any relevant data to return, you aren’t charged.

Like other data appends, it’s included in the flat cost of an Unlimited subscription. On-premises customers will receive it with their next release.

Learn more

Don't miss what's new

Geocodio ships new features and data updates regularly. We'll only email you with the good stuff, nothing else.

Thanks for subscribing! Check your inbox to confirm.

A delightfully boring cookie banner

1 optional cookie from us
2 embeds blocked by default
0 ad tracking / data brokers

Geocodio would like to set one first-party cookie to remember how you found this site. Accepting also unblocks embedded videos and calendars, which set their own cookies.

Read the privacy policy