Skip to content

Geolocation data for all of the cities in the world as json/csv. Generate your own custom list with extra data.

Notifications You must be signed in to change notification settings

joelacus/world-cities

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

World Cities Geolocation Data

Geolocation data for all of the cities in the world as json/csv. See Examples.

You can generate your own custom list with extra data with the python script.

NPM install coming soon.

Custom Lists

To generate your own list, run python get_world_cities.py and follow the CLI prompts.

Available data:

  • ISO-3166 2-letter country code
  • Full country name
  • State
  • County
  • City/place name
  • Alternative names
  • Latitude
  • Longitude
  • Timezone
  • Population
  • Altitude

You can choose whether you want to include cities/places with greater than '1000', '5000', or '15000' in population.

A free Geocoding API key is now required to fetch 'state' and 'county' data.

Examples

world_cities.json

[
  {
    "country": "GB",
    "name": "London",
    "lat": "51.50853",
    "lng": "-0.12574"
  },
  ...
]

world_cities.csv

country,name,lat,lng
GB,London,51.50853,-0.12574
...

world_cities_(including_US_states).json

[
  {
    "country": "US",
    "state": "NY",
    "name": "New York City",
    "lat": "40.71427",
    "lng": "-74.00597"
  },
  ...
]

world_cities_(including_US_states).csv

country,state,name,lat,lng
US,NY,New York City,40.71427,-74.00597
...

Sources

GeoNames: Country Code, City/Place Name, Alternative Names, Latitude, Longitude, Timezone, Population, and Altitude.

Geocoding: States and Counties.

annexare: Full Country Names.

Licence

Creative Commons Attribution 4.0 License

About

Geolocation data for all of the cities in the world as json/csv. Generate your own custom list with extra data.

Topics

Resources

Stars

Watchers

Forks

Languages