Awesome
un-m49
Info on UN M49.
Contents
- What is this?
- When should I use this?
- Install
- Use
- API
- Types
- Compatibility
- Security
- Related
- Contribute
- License
What is this?
This package contains info on UN M49 (Standard Country or Area Codes for
Statistical Use).
UN M49 is similar to ISO 3166 (the GB
in en-GB
).
The difference is that ISO 3166 uses alphabetical codes based on how a region is
called by a group of people, whereas UN M49 uses numerical codes.
Numerical codes are useful because they are resistant to changes and
geopolitical conflicts.
UN M49 also contains regions bigger than countries, such as (sub)continents.
That’s useful for example for es-419
to describe Spanish as used in Latin
America and the Caribbean.
When should I use this?
You can use this package any time you have to deal with regions or UN M49 in particular.
Install
This package is ESM only. In Node.js (version 14.14+, 16.0+), install with npm:
npm install un-m49
In Deno with esm.sh
:
import {unM49, toIso3166} from 'https://esm.sh/un-m49@2'
In browsers with esm.sh
:
<script type="module">
import {unM49, toIso3166} from 'https://esm.sh/un-m49@2?bundle'
</script>
Use
import {unM49} from 'un-m49'
console.log(unM49.slice(0, 20))
Yields:
[
{type: 0, name: 'World', code: '001'},
{type: 1, name: 'Africa', code: '002', parent: '001'},
{type: 4, name: 'Afghanistan', code: '004', iso3166: 'AFG', parent: '034'},
{type: 3, name: 'South America', code: '005', parent: '419'},
{type: 4, name: 'Albania', code: '008', iso3166: 'ALB', parent: '039'},
{type: 1, name: 'Oceania', code: '009', parent: '001'},
{type: 4, name: 'Antarctica', code: '010', iso3166: 'ATA', parent: '001'},
{type: 3, name: 'Western Africa', code: '011', parent: '202'},
{type: 4, name: 'Algeria', code: '012', iso3166: 'DZA', parent: '015'},
{type: 3, name: 'Central America', code: '013', parent: '419'},
{type: 3, name: 'Eastern Africa', code: '014', parent: '202'},
{type: 2, name: 'Northern Africa', code: '015', parent: '002'},
{type: 4, name: 'American Samoa', code: '016', iso3166: 'ASM', parent: '061'},
{type: 3, name: 'Middle Africa', code: '017', parent: '202'},
{type: 3, name: 'Southern Africa', code: '018', parent: '202'},
{type: 1, name: 'Americas', code: '019', parent: '001'},
{type: 4, name: 'Andorra', code: '020', iso3166: 'AND', parent: '039'},
{type: 2, name: 'Northern America', code: '021', parent: '019'},
{type: 4, name: 'Angola', code: '024', iso3166: 'AGO', parent: '017'},
{type: 4, name: 'Antigua and Barbuda', code: '028', iso3166: 'ATG', parent: '029'}
]
API
This package exports the identifiers unM49
and toIso3166
.
There is no default export.
unM49
List of Region
s (Array<Region>
).
Region
Object with the following properties:
type
(Type
) —Type
(example:4
)name
(string
) — name (example:'United Kingdom of Great Britain and Northern Ireland'
)code
(string
) — three-character UN M49 code (example:826
)iso3166
(string?
) — ISO 3166-1 alpha-3 code, iftype
represents a country or area (example:'GBR'
)parent
(string?
) — code of parent region, iftype
does not represent the planet (example:'154'
)
Type
number
, one of the following:
0
— global (example:001
World
)1
— region (example:002
Africa
)2
— subregion (example:202
Sub-Saharan Africa
)3
— intermediate region (example:017
Middle Africa
)4
— country or area (example:024
Angola
)
👉 Note: Regions can be “missing” between a region and its parent. For example, the parent of the “country or area” (
4
)010
Antarctica
is001
World
(4
). Intermediate regions (3
) aren’t used a lot.
toIso3166
Map of UN M49 codes to ISO 3166-1 alpha-3 codes (Record<string, string>
).
Types
This package is fully typed with TypeScript.
It exports the additional types Type
and UNM49
.
Compatibility
This package is at least compatible with all maintained versions of Node.js. As of now, that is Node.js 14.14+ and 16.0+. It also works in Deno and modern browsers.
Security
This package is safe.
Related
wooorm/bcp-47
— parse and stringify BCP 47 language tagswooorm/bcp-47-match
— match BCP 47 language tags with language ranges per RFC 4647wooorm/bcp-47-normalize
— normalize, canonicalize, and format BCP 47 tagswooorm/iso-3166
— ISO 3166 codeswooorm/iso-639-2
— ISO 639-2 codeswooorm/iso-639-3
— ISO 639-3 codeswooorm/iso-15924
— ISO 15924 codes
Contribute
Yes please! See How to Contribute to Open Source.