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 · Satellites: orbital elements in, positions out

NearestOptionstype

What nearest may be asked. date is required.

Import it

import type { NearestOptions } from "@johnmorrisdotca/chikyu-earth/satellites";

Definition

interface NearestOptions {
    count?: number;
    within?: number;
    by?: "sky" | "space";
    date: number;
    observer?: GeoPoint & {
        heightM?: number;
    };
}

Members

NameTypeDescription
count (optional)number | undefined

How many to return, nearest first. NEAREST_COUNT when left out.

within (optional)number | undefined

Drop anything further than this: kilometres for by: "space", degrees for by: "sky". No limit when left out.

by (optional)"space" | "sky" | undefined

"space" (kilometres, the default) or "sky" (the angle at the observer).

datenumber

The moment, milliseconds since the Unix epoch.

observer (optional)(GeoPoint & { heightM?: number; }) | undefined

Where the sky is seen from, when the target is a satellite and by is "sky".

Examples

import type { NearestOptions } from "@johnmorrisdotca/chikyu-earth/satellites";

const options: NearestOptions = { date: Date.UTC(2026, 10, 2), by: "space", count: 5 };
console.log(options.by);
space

What it prints (run when this page was built)

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