https://github.com/joelacus/world-cities
Geolocation data for all of the cities in the world as json/csv. Generate your own custom list with extra data.
https://github.com/joelacus/world-cities
cities csv custom dataset geolocation json world-cities-database
Last synced: 3 months ago
JSON representation
Geolocation data for all of the cities in the world as json/csv. Generate your own custom list with extra data.
- Host: GitHub
- URL: https://github.com/joelacus/world-cities
- Owner: joelacus
- Created: 2023-10-17T01:27:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-24T21:37:23.000Z (12 months ago)
- Last Synced: 2024-07-25T00:02:15.611Z (12 months ago)
- Topics: cities, csv, custom, dataset, geolocation, json, world-cities-database
- Language: Python
- Homepage:
- Size: 27 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# World Cities Geolocation Data
Geolocation data for all of the cities in the world as json/csv. [See Examples](#examples).
`world_cities` (More precise. Villages, towns, and cities of 1000 or more in population. Bigger file size)
`world_cities_5000` (Average. Towns and cities of 5000 or more in population)
`world_cities_15000` (Least precise. Large towns, and cities of 15000 or more in population. Smaller file size)
You can generate your own custom list with extra data with the python script.
_NPM install planned._
## Custom Lists
To generate your own list, run `python get_world_cities_geo_data.py` and follow the CLI prompts.
You can choose whether you want to include cities/places with a population greater than '500', '1000', '5000', or '15000'.
Basic data:
- Place name
- Latitude
- Longitude
Optional additional data:
- ISO-3166 2-letter country code
- Full country name
- Geonameid
- State
- County
- Alternative names
- Timezone
- Population
- Altitude
- Continent
- Capital City
- Currency Code
- Currency Name
- Phone Extension
- Spoken Languages
- Country Neighbours
A [free Geocoding API key](https://geocode.maps.co/join/) 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
...
```
custom json file with all data points:
```
{
"name": "London",
"lat": 51.50853,
"lng": -0.12574,
"geonameid": 2643743,
"altnames": {
"es": [
"Londres"
],
"it": [
"Londra"
],
...
},
"timezone": "Europe/London",
"population": 8961989,
"altitude": "",
"country": "GB",
"country_name": "United Kingdom",
"state": "England",
"county": "",
"capital": "London",
"continent": "EU",
"currency_code": "GBP",
"currency_name": "Pound",
"phone": "44",
"languages": "en-GB,cy-GB,gd",
"neighbours": "IE"
}
```
## Sources
[GeoNames](https://www.geonames.org/datasources/): All data except States and Counties.
[Geocoding](https://geocode.maps.co/): States and Counties.
## Licence
[Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/)