https://github.com/zeke/all-the-cities

🌆 All the 138,398 cities of the world with a population of at least 1000 inhabitants, in a big JSON array.
https://github.com/zeke/all-the-cities

geo

Last synced: 5 days ago
JSON representation

🌆 All the 138,398 cities of the world with a population of at least 1000 inhabitants, in a big JSON array.

• Host: GitHub
• URL: https://github.com/zeke/all-the-cities
• Owner: zeke
• License: mit
• Created: 2016-03-25T02:01:09.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2022-05-25T16:30:16.000Z (over 2 years ago)
• Last Synced: 2024-11-27T15:45:10.633Z (17 days ago)
• Topics: geo
• Language: JavaScript
• Homepage: http://npm.im/all-the-cities
• Size: 11.5 MB
• Stars: 281
• Watchers: 4
• Forks: 42
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# all-the-cities

All the 138,398 cities of the world with a population of at least 1000 inhabitants, in a big JSON array that is ready to be imported in MongoDB for `geoSpatialSearch`.

Derived from the [cities-with-1000](https://www.npmjs.com/package/cities-with-1000) npm package, which in turn came from [geonames.org data](http://download.geonames.org/export/dump/).

## Installation

Download node at [nodejs.org](http://nodejs.org) and install it, if you haven't already.

```sh

npm install all-the-cities --save

```

## Usage

```js

const cities = require('all-the-cities');

cities.filter(city => city.name.match('Albuquerque'));

/*

 [{

   cityId: '5454711',

   name: 'Albuquerque',

   country: 'US',

   altCountry: '',

   muni: '',

   muniSub: '',

   featureClass: 'P',

   featureCode: 'PPLA2',

   adminCode: 'NM',

   population: 545852,

   loc: {

     type: 'Point',

     coordinates: [-106.65114, 35.084] 

   }

 }, {

   cityId: '5476960',

   name: 'Los Ranchos de Albuquerque',

   country: 'US',

   altCountry: '',

   muni: '',

   muniSub: '',

   featureClass: 'P',

   featureCode: 'PPL',

   adminCode: 'NM',

   population: 6024,

   loc: {

     type: 'Point',

     coordinates: [-106.6428, 35.16199]

   }

 }]

*/

```

## Fields available to import

```js

id - Id of the city (same in openWeatherMap)

name

altName

country

featureCode

adminCode

population

loc: { type: 'Point', coordinates: [0, 0] }

for **GEO JSON data**, a particular format is needed in MongoDB Schema as written in loc field above

```

## Tests

```sh

npm install

npm test

```

## Dependencies

None

## Dev Dependencies

- [cities-with-1000](https://github.com/nabilashraf/cities1000): lat/lon, names of cities with over 1000 people

- [tape](https://github.com/substack/tape): tap-producing test harness for node and browsers

- [split2](https://github.com/mcollina/split2): split a Text Stream into a Line Stream, using Stream 3

- [through2](https://github.com/rvagg/through2): A tiny wrapper around Node streams2 Transform to avoid explicit subclassing noise

## License

MIT