Skip to the content

Chikyu Earth地球

A line-drawn globe of the world's countries that turns at the Earth's own rate, with an optional realistic Earth from space and markers for any place.

Chikyu is the Japanese word 地球 for the Earth. About the name

Contents

Reference · Markers on the globe

hereCountriesfunction

At most two countries to read for a place. The first is the country of the nearest city in the three tiers, however far. The second is added only when a city of another country is also inside the limit: a place near a border. src/countries.ts has no point-in-country test, so the country comes from those cities.

Import it

import { hereCountries } from "@johnmorrisdotca/chikyu-earth/markers";

Definition

function hereCountries(point: { lat: number; lon: number; }, source: HereCitySource, maxKm: number): string[]

Parameters

NameTypeDescription
point{ lat: number; lon: number; }

The place.

sourceHereCitySource

The three tiers.

maxKmnumber

The limit, in kilometres.

Returns

string[]

ISO codes, upper case, at most two.

Examples

import { hereCountries } from "@johnmorrisdotca/chikyu-earth/markers";

const source = {
  nearest: () => ({ city: { id: "a", name: { en: "A" }, country: "fr" }, km: 30 }),
  within: () => [{ city: { country: "fr" }, km: 30 }, { city: { country: "de" }, km: 40 }],
};
console.log(hereCountries({ lat: 49, lon: 8 }, source, 100).join(" "));
FR DE

What it prints (run when this page was built)

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/chikyu-earth 0.51.1.