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 npm package, which in turn came from geonames.org data.

Installation

Download node at nodejs.org and install it, if you haven't already.

1npm install all-the-cities --save

Usage

1const cities = require('all-the-cities');
2
3cities.filter(city => city.name.match('Albuquerque'));
4
5/*
6 [{
7   cityId: '5454711',
8   name: 'Albuquerque',
9   country: 'US',
10   altCountry: '',
11   muni: '',
12   muniSub: '',
13   featureClass: 'P',
14   featureCode: 'PPLA2',
15   adminCode: 'NM',
16   population: 545852,
17   loc: {
18     type: 'Point',
19     coordinates: [-106.65114, 35.084] 
20   }
21 }, {
22   cityId: '5476960',
23   name: 'Los Ranchos de Albuquerque',
24   country: 'US',
25   altCountry: '',
26   muni: '',
27   muniSub: '',
28   featureClass: 'P',
29   featureCode: 'PPL',
30   adminCode: 'NM',
31   population: 6024,
32   loc: {
33     type: 'Point',
34     coordinates: [-106.6428, 35.16199]
35   }
36 }]
37*/

Fields available to import

1
2id - Id of the city (same in openWeatherMap)
3name
4altName
5country
6featureCode
7adminCode
8population
9loc: { type: 'Point', coordinates: [0, 0] }
10
11for **GEO JSON data**, a particular format is needed in MongoDB Schema as written in loc field above
12

Tests

1npm install
2npm test

Dependencies

None

Dev Dependencies

• cities-with-1000: lat/lon, names of cities with over 1000 people
• tape: tap-producing test harness for node and browsers
• split2: split a Text Stream into a Line Stream, using Stream 3
• through2: A tiny wrapper around Node streams2 Transform to avoid explicit subclassing noise

License

MIT