A low-memory, structured loader for the GeoNames.org cities-500 dataset.
npm install cities-500-structured[![View code coverage on codecov][codecov-badge]][codecov]
[codecov]: https://codecov.io/gh/adamaveray/geonames
[codecov-badge]: https://codecov.io/gh/adamaveray/geonames/branch/main/graph/badge.svg
A low-memory, structured loader for the GeoNames.org cities-500 dataset.
The package provides a generator that outputs each record in the data set, structured & parsed – ints & floats are converted to numbers, lists are converted to string[] arrays, and dates are converted to Date objects. See the schema for details.
The data file is bundled with the package so can be used offline, and the package uses no dependencies.
The default export function provides a [generator][] which can be iterated to access each record without storing the entire dataset in memory:
``js
import cities500 from 'cities-500-structured';
for (const record of cities500()) {
// record is an object containing that record's detailsRecord #${record.geonameId}: "${record.name}"
console.log(, record);``
}
[generator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Iterators_and_Generators#generator_functions
---
Module under MIT License, geo data via [GeoNames.org][geonames], [CC BY 4.0][cc].
[geonames]: http://download.geonames.org/export/dump/
[cc]: https://creativecommons.org/licenses/by/4.0/