@geomelon/data-query

Loader and query interface for Geomelon per-country data packages (@geomelon/<country>). Every generated country package depends on this and re-exports a ready-made dataset instead of a bare JSON array.

Usage

const spain = require('@geomelon/spain')

spain.cities({ name: 'Barcel' })          // prefix match, checks every translation too
spain.cities({ minPopulation: 1000000 })
spain.cities({ regionId: 'region-1', limit: 10 })
spain.city('Q1492')                       // by Geomelon id or Wikidata id
spain.regions({ name: 'Cataluña' })
spain.country                             // country-level fields
spain.meta                                // generatedAt, recordCount, license, source

Or build a dataset directly from a raw payload (e.g. downloaded separately, or from a package whose main you didn't use):

import { createGeomelonDataset } from '@geomelon/data-query'
import data from '@geomelon/spain/data.json'

const spain = createGeomelonDataset(data)

Filters

cities(filter?): | field | type | matches | |---|---|---| | name | string | case-insensitive prefix match against the primary name and every translation | | regionId | string | exact match | | minPopulation / maxPopulation | number | inclusive range | | language | string | city has a translation in this language | | settlementType | string | exact match against one of the city's settlement types | | limit | number | caps the result count |

regions(filter?) supports name and limit.

License

MIT (this package's code). The data shipped inside each @geomelon/<country> package is CC0-1.0 — see that package's own LICENSE.