GeoDB Cities API

Portuguese Now Available

GeoDB now supports base Portuguese (pt) and its Brazilian variant (pt_BR) as possible language translations, where data is available. If Brazilian Portuguese is requested but unavailable, the service will then attempt to get the base Portuguese version. If this too is missing, the service will fall back to English (as is currently done for other languages).

To find out the set of currently supported languages (and the codes to use), see the Get Languages API.

Other Enhancements

  • For operations returning collection results, you can now optionally suppress generation of HATEOAS paging links. If your code doesn't rely on these links, do this to receive a more compact (faster) response. See the new hateoasMode param described in the API docs.

Bug Fixes

  • Denmark regions are now correctly mapped.

Free Instance Changes

In an effort to maintain great performance on the Free instance while balancing CPU/bandwidth costs, we will soon be instituting a slight change to the available cities on this instance. Specifically, we will be limiting the total set of cities to only those with a population of at least 10000 (based on GeoNames data).

If you require data on cities smaller than this, consider upgrading to one of the paid plans on the Pro instance.

More details once the change has been made, sometime in the next week or two.

Moving Up In The API World

GeoDB has now been featured in RapidAPI's Top 50 Most Popular APIs. Big thanks to our loyal users for making this happen! We are actively working on changes under the hood to make the service even more performant and scalable. Stay tuned!

How To Get City Tourist Attractions

Getting a city's GPS location, population, and elevation is all well and good, but what about when you're building:

  • A history app that shows a timeline of significant events?
  • A travel app that needs to show famous landmarks and tourist attractions?
  • Just a fun app that shows all the famous people born in a given city?

All of this and more is possible by integrating with WikiData, the machine-consumable version of Wikipedia.

GeoDB now offers WikiData integration by tying all countries and regions, as well as most cities, to a unique WikiData entity id.

Want to delve in? See our latest tutorial walking you through how to find the tourist attractions in New York City.

Display Results In Multiple Languages!

Besides English, you can now display cities, regions, and countries in one of the following languages:

  • French
  • German
  • Italian
  • Russian
  • Spanish

For details, please go to the API Reference sections which have been updated to describe the new languageCode param.

The translations are based on WikiData and dependent on the completeness of the data there. (If you see something missing or wrong, please correct it in WikiData. The PRO instance will receive the correction during its daily refresh cycle.)

Let us know what you think!

Other Enhancements

  • WikiData Integration (more on this later)
  • For languages based on Latin characters, you can now display results back without accent marks. See the new asciiMode param described in the API docs.
  • Getting a country's details now also returns its flag image link.

Bug Fixes

  • The namePrefix filter now ignores diacritical marks for languages using Latin characters.
  • The mapping of cities to regions has been corrected.

View older posts »