Skip to the content

Kuni国

Look up countries, codes, names and subdivisions, load country data on demand and mount a native country card.

Kuni (国) is Japanese for a country. About the name

Contents

Reference · Subdivision facts

loadSubdivisionFactsfunction

The facts about one country's subdivisions, every level, in code order: one object for each subdivision, with null for anything Wikidata does not give or gives two ways (docs/subdivision-facts.md counts them).

Import it

import { loadSubdivisionFacts } from "@johnmorrisdotca/kuni/subdivision-facts";

Definition

function loadSubdivisionFacts(countryCode: string): Promise<readonly SubdivisionFacts[] | null>

Parameters

NameTypeDescription
countryCodestring

An ISO 3166-1 alpha-2 code, in either case.

Returns

Promise<readonly SubdivisionFacts[] | null>

The list, frozen; an empty list for a country with no subdivisions (Antarctica); null for a code that is not a country.

Examples

import { loadSubdivisionFacts } from "@johnmorrisdotca/kuni/subdivision-facts";

const prefectures = await loadSubdivisionFacts("JP");
console.log(prefectures?.[0].capital);    // { en: "Sapporo", ja: "札幌市", reading: "さっぽろし" }
console.log(prefectures?.[12].population); // 14264798, for Tokyo
console.log(prefectures?.[12].populationYear); // 2022
console.log(await loadSubdivisionFacts("AQ")); // []
console.log(await loadSubdivisionFacts("XX")); // null
{ en: 'Sapporo', ja: '札幌市', reading: 'さっぽろし' }
14264798
2022
[]
null

What it prints (run when this page was built)

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/kuni 1.4.0.