{"id":19300082,"url":"https://github.com/joelacus/world-cities","last_synced_at":"2025-04-22T10:31:28.930Z","repository":{"id":200886930,"uuid":"705930832","full_name":"joelacus/world-cities","owner":"joelacus","description":"Geolocation data for all of the cities in the world as json/csv. Generate your own custom list with extra data.","archived":false,"fork":false,"pushed_at":"2024-07-24T21:37:23.000Z","size":28283,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-07-25T00:02:15.611Z","etag":null,"topics":["cities","csv","custom","dataset","geolocation","json","world-cities-database"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joelacus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-17T01:27:52.000Z","updated_at":"2024-07-24T21:37:31.000Z","dependencies_parsed_at":"2024-06-02T04:02:53.932Z","dependency_job_id":null,"html_url":"https://github.com/joelacus/world-cities","commit_stats":{"total_commits":5,"total_committers":2,"mean_commits":2.5,"dds":"0.19999999999999996","last_synced_commit":"9be7038e57ce9d7f21097818454023407a2d4cc9"},"previous_names":["joelacus/world-cities"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelacus%2Fworld-cities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelacus%2Fworld-cities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelacus%2Fworld-cities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelacus%2Fworld-cities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joelacus","download_url":"https://codeload.github.com/joelacus/world-cities/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223893037,"owners_count":17220834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cities","csv","custom","dataset","geolocation","json","world-cities-database"],"created_at":"2024-11-09T23:13:47.304Z","updated_at":"2025-04-22T10:31:28.920Z","avatar_url":"https://github.com/joelacus.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# World Cities Geolocation Data\n\nGeolocation data for all of the cities in the world as json/csv. [See Examples](#examples).\n\n`world_cities` (More precise. Villages, towns, and cities of 1000 or more in population. Bigger file size)\u003cbr\u003e\n`world_cities_5000` (Average. Towns and cities of 5000 or more in population)\u003cbr\u003e\n`world_cities_15000` (Least precise. Large towns, and cities of 15000 or more in population. Smaller file size)\n\nYou can generate your own custom list with extra data with the python script.\n\n_NPM install planned._\n\n## Custom Lists\n\nTo generate your own list, run `python get_world_cities_geo_data.py` and follow the CLI prompts.\n\nYou can choose whether you want to include cities/places with a population greater than '500', '1000', '5000', or '15000'.\n\nBasic data:\n\n-   Place name\n-   Latitude\n-   Longitude\n\nOptional additional data:\n\n-   ISO-3166 2-letter country code\n-   Full country name\n-   Geonameid\n-   State\n-   County\n-   Alternative names\n-   Timezone\n-   Population\n-   Altitude\n-   Continent\n-   Capital City\n-   Currency Code\n-   Currency Name\n-   Phone Extension\n-   Spoken Languages\n-   Country Neighbours\n\n\nA [free Geocoding API key](https://geocode.maps.co/join/) is now required to fetch 'state' and 'county' data.\n\n## Examples\n\nworld_cities.json\n\n```\n[\n  {\n    \"country\": \"GB\",\n    \"name\": \"London\",\n    \"lat\": \"51.50853\",\n    \"lng\": \"-0.12574\"\n  },\n  ...\n]\n```\n\u003cbr\u003e\n\nworld_cities.csv\n\n```\ncountry,name,lat,lng\nGB,London,51.50853,-0.12574\n...\n```\n\n\u003cbr\u003e\nworld_cities_(including_US_states).json\n\n```\n[\n  {\n    \"country\": \"US\",\n    \"state\": \"NY\",\n    \"name\": \"New York City\",\n    \"lat\": \"40.71427\",\n    \"lng\": \"-74.00597\"\n  },\n  ...\n]\n```\n\u003cbr\u003e\n\nworld_cities_(including_US_states).csv\n\n```\ncountry,state,name,lat,lng\nUS,NY,New York City,40.71427,-74.00597\n...\n```\n\u003cbr\u003e\n\ncustom json file with all data points:\n\n```\n{\n    \"name\": \"London\",\n    \"lat\": 51.50853,\n    \"lng\": -0.12574,\n    \"geonameid\": 2643743,\n    \"altnames\": {\n      \"es\": [\n        \"Londres\"\n      ],\n      \"it\": [\n        \"Londra\"\n      ],\n      ...\n    },\n    \"timezone\": \"Europe/London\",\n    \"population\": 8961989,\n    \"altitude\": \"\",\n    \"country\": \"GB\",\n    \"country_name\": \"United Kingdom\",\n    \"state\": \"England\",\n    \"county\": \"\",\n    \"capital\": \"London\",\n    \"continent\": \"EU\",\n    \"currency_code\": \"GBP\",\n    \"currency_name\": \"Pound\",\n    \"phone\": \"44\",\n    \"languages\": \"en-GB,cy-GB,gd\",\n    \"neighbours\": \"IE\"\n  }\n```\n\n## Sources\n\n[GeoNames](https://www.geonames.org/datasources/): All data except States and Counties.\n\n[Geocoding](https://geocode.maps.co/): States and Counties.\n\n## Licence\n\n[Creative Commons Attribution 4.0 License](https://creativecommons.org/licenses/by/4.0/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoelacus%2Fworld-cities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoelacus%2Fworld-cities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoelacus%2Fworld-cities/lists"}