npmpackage.info

Gathering detailed insights and metrics for worldcities

worldcities - 0.1.8 | npmpackage.info

worldcities

A convenient wrapper for the GeoNames database of world cities data.

0.1.8

Unlicense

TypeScript

7.29 MB

Installations

npm install worldcities

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Node Version

14.19.0

NPM Version

9.5.1 Pull Requests

Open

13

Total

24

Closed

2

Merged

9

Issues

Open

1

Total

5

Closed

4

Releases

Unable to fetch releases

Languages

TypeScript

JavaScript

Shell

TypeScript (51.27%)

JavaScript (45.02%)

Shell (3.72%)

Developer

OpenDataFormats

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

Unlicense License

10 Stars

59 Commits

5 Forks

1 Watchers

14 Branches

3 Contributors

Updated on Apr 01, 2024

Maintainers

View All 3 Contributors

Package Meta Information

Latest Version

0.1.8

Package Id

worldcities@0.1.8

Unpacked Size

7.29 MB

Size

2.07 MB

File Count

528

NPM Version

9.5.1

Node Version

14.19.0

Published on

Mar 15, 2023

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

World Cities

24,343 world cities and 252 countries.

A convenient wrapper for the GeoNames database of world cities data.

The data from the GeoNames tab seperated values files are parsed and normalized into a JSON object for quick lookup and distance calculations. The data for each city's country is also normalized, indexed by ISO_3166-1 country code, paired with the country's flag's SVG, GeoJSON of its boundaries, and relative URL to Wikipedia page.

Usage

Query for a city by GPS

1const WorldCities = require('worldcities');
2const city = WorldCities.getNearestCity(5.42282298420212, 100.33753796627954);
3
4// City {
5//   latitude: 5.41123,
6//   longitude: 100.33543,
7//   name: 'George Town',
8//   population: 300000,
9//   timezone: 'Asia/Kuala_Lumpur',
10//   country: Country {
11//     areaSquareMeters: 329750,
12//     callingCode: '60',
13//     capital: 'Kuala Lumpur',
14//     continent: 'AS',
15//     countryCode: 'MY',
16//     countryCode3: 'MYS',
17//     currencyCode: 'MYR',
18//     currencyName: 'Ringgit',
19//     languages: [
20//       'ms-MY', 'en',
21//       'zh',    'ta',
22//       'te',    'ml',
23//       'pa',    'th'
24//     ],
25//     name: 'Malaysia',
26//     neighbors: [ 'BN', 'TH', 'ID' ],
27//     population: 31528585,
28//     postalCodeRegExp: '^(\\d{5})$',
29//     tld: '.my',
30//     wikipedia: 'Malaysia',
31//     geoJSON: undefined,
32//     flagSVG: undefined
33//   }
34// }

Query for a large city by GPS

1const WorldCities = require('worldcities');
2const city = WorldCities.getNearestLargeCity(17.076480407330514, -101.3674415353851);

Query for a single city by name

1const city = WorldCities.getByName('Tokyo');

Query all cities matching a name

1const cities = WorldCities.getByName('nEw yOrK');
2assert.equal(cities.length, 3);

Get a Country by Country Code

Retrieve the country data by querying for it by the 2 letter country code. The second argument returns the Country with full data, including geoJSON and flag SVG.

1const country = WorldCities.getCountry('NZ', true);
2fs.writeFileSync('nz.flag.svg', country.flagSVG);

Timezones

The city data includes the IANA timezone ID in string format; ie. "America/Los_Angeles". To use these to localize dates and times to the city, it's highly recommended to use the Moment Timezone library.

For example, to convert a UNIX timestamp to a localized date time string:

1const moment = require('moment-timezone');
2
3moment(Math.floor(Date.now() / 1000), 'X')
4  .tz('America/Los_Angeles')
5  .format('dddd, MMMM Do YYYY, h:mm:ss a z');
6
7// "Friday, May 1st 2020, 5:52:11 am PDT"

GeoJSON

GeoJSON objects can be visualized nicely in the http://geojson.io/ UI.

Google Maps also supports using GeoJSON as a "Data Layer" via the API.

SQLite

All of the data is also available in a compact SQLite file. It is in the source repository, but not included in the package to keep size reasonable.

[https://raw.githubusercontent.com/OpenDataFormats/worldcities/master/data/worldcities.sqlite]

Data Sources

City and country data:

GeoNames

Flag SVG data

flag-icon-css

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

7

SAST

Determines if the project uses static code analysis.

1

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

39 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-ww39-953v-wcq6
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-6vfc-qv3f-vr6c
Warn: Project is vulnerable to: GHSA-5v2h-r2cx-5xgj
Warn: Project is vulnerable to: GHSA-rrrm-qjm4-v8hf
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-g4rg-993r-mgx7
Warn: Project is vulnerable to: GHSA-9qrh-qjmc-5w2p
Warn: Project is vulnerable to: GHSA-jqv5-7xpx-qj74
Warn: Project is vulnerable to: GHSA-mxhp-79qh-mcx6
Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9
Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh
Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36
Warn: Project is vulnerable to: GHSA-r628-mhmh-qjhw
Warn: Project is vulnerable to: GHSA-9r2w-394v-53qc
Warn: Project is vulnerable to: GHSA-qq89-hq3f-393p
Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-cf4h-3jhx-xvhq
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh

Score

3

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More