# Ortho Earth > Equal to all, fair to the Earth. This is the project for all people on the earth. The earth is round. One true-scale Earth, for people and their AI agents. Ortho Earth reads the open data of the Earth in your own browser — on a round globe, at true scale, with no server, no account and no install. A map engine built from scratch (WebGPU with a WebGL2 fallback) draws government vector tiles straight onto the sphere, lifts real terrain, and raises 3D cities as you zoom in. Big data is drawn from GeoParquet, the intelligence layer (identify, topology, choropleths) is Gint, and nothing is exaggerated (terrain at real scale). ## Current facts These numbers are generated from the source at each deploy, so they match the latest release. The same facts as JSON: [facts.json](https://www.ortho-earth.com/facts.json). All guides in one file: [llms-full.txt](https://www.ortho-earth.com/llms-full.txt). - Latest release: 2.4.2 (2026-11-16) — `@ortho-earth/globe` 2.4.2, `@ortho-earth/core` 2.4.2, `@ortho-earth/cesium` 0.3.1. What changed: [CHANGELOG](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/blob/main/CHANGELOG.md). - MapLibre GL JS code: of 137 graded official examples (MapLibre GL JS 6.11.2), 91 draw the same picture, 43 give the same answers with a different picture, 3 run only in part, 0 do not run. Every example with its score: [/maplibre/](https://www.ortho-earth.com/maplibre/). - CesiumJS code: of 304 compared Sandcastle examples (CesiumJS 1.146.0), 264 draw the same picture, 40 give the same answers with a different picture, 0 run only in part, 0 do not run. Every pair side by side: [/sandcastle/](https://www.ortho-earth.com/sandcastle/). - License: the engine is GPL-3.0-or-later (a commercial license is available); the data formats and converters (geopbf, altpbf, geoedit, glbconv, native-bucket) are MIT. - Browsers: WebGPU where the browser has it (desktop Chrome and Edge, Safari on macOS/iOS/iPadOS, Chrome on Android), WebGL2 otherwise. Shadows, ambient occlusion, clipping planes, atmospheric scattering and the post effects are WebGPU only. ## Made to work with AI agents Ortho Earth is meant to be a map that AI coding agents can use well. What that means in practice: - An agent already knows how to write it. The globe speaks the MapLibre GL JS and CesiumJS APIs that agents learned from years of public code, and every official example of both is graded on the globe (numbers above), so code an agent writes from memory runs. - One request is enough. [Build with Ortho Earth](https://www.ortho-earth.com/start.md) is a recipe written for people and agents; every step is run by an automated test against the published npm packages, and an agent given only a one-paragraph request built and verified a working globe page on its first run. It ends with notes for agents (what to install, how to check the page works: `[boot] frame1 received` in the console). - Nothing to sign up for. No API key, no account, no tile server: public data is read by the browser, so an agent can finish without asking you for credentials. - The map says what it can do. `map.supports(key)` and `map.capabilities()` report what is built in, what a plugin adds and what is only accepted as a spec, so an agent can check instead of guessing. The packages ship TypeScript types (`globe.d.ts`, `maplibre.d.ts`). - An MCP server answers instead of guessing. Add `https://www.ortho-earth.com/mcp` as a remote MCP server (Streamable HTTP, stateless; or run `npx -y @ortho-earth/mcp` for stdio): read-only tools for the current facts, the tested recipe, whether a MapLibre or CesiumJS example runs on the globe, API declarations from the published types, documentation search and links to a place on the globe. No key. Machine-readable sources it reads: [compat.json](https://www.ortho-earth.com/compat.json) (each official example's grade) and `/ref/*.ts` (the public types). It is a reference server for writing code with Ortho Earth; it does not drive a live map, render images or analyse data. Setup for Claude Code, Claude Desktop, Cursor and VS Code, and the tool list: [the endpoint itself](https://www.ortho-earth.com/mcp) (a plain GET returns the guide). - Current facts in one fetch. This file, [llms-full.txt](https://www.ortho-earth.com/llms-full.txt) and [facts.json](https://www.ortho-earth.com/facts.json) are rebuilt from the source at every deploy, so the version and the compatibility numbers are never older than the site. - Built that way, too. The developer wrote no code by hand: design and judgement are his, implementation and verification were done with an AI ([the story](https://www.ortho-earth.com/docs/introduction), Japanese). ## How it compares Written by the developer of Ortho Earth, who has tried to say where the other engines are stronger. The articles below give the conditions and versions; the raw data of the benchmarks is public. - Different starting points. MapLibre GL JS grew out of 2D cartography and is the strongest for expressive 2D maps. CesiumJS grew out of a 3D Earth with time; 3D Tiles came from Cesium, and it has the longest experience with them. TerriaJS is a finished data-viewing app built on Cesium. Navara pairs a Rust/WebAssembly GIS core with three.js rendering. Ortho Earth puts MapLibre's way of writing a map and Cesium's 3D Tiles, terrain and clock on one always-round globe, draws in a worker (OffscreenCanvas), and uses WebGPU first. - One model of the Earth at every scale. From the whole planet to a street corner, the map is the same sphere seen by one camera; there is no second, flat mode to switch to. So countries keep their true size side by side, the shortest way between two places is drawn as the arc it really is ([great circle vs rhumb line](https://www.ortho-earth.com/globe/arcs)), terrain is never exaggerated, and when a flat world map is wanted it is Equal Earth, which keeps areas true ([how it is drawn](https://www.ortho-earth.com/docs/equal-earth)). - Compatibility, not a rewrite. MapLibre and CesiumJS code runs on Ortho Earth unchanged, and the score of every official example is published next to the original (numbers above). Where the picture still differs, the gallery says so. - Speed on phones (2026-11-11, PLATEAU Chiyoda LOD2 buildings, iPhone XS and Galaxy Tab A11+; MapLibre GL JS 6.17.0 + deck.gl 9.4.1, CesiumJS 1.147.0, Navara 0.3.1, Ortho Earth 2.4.1): Navara and Ortho Earth held the 60 fps screen limit in orbit and zoom on both devices, CesiumJS ran at 57/60 fps on the tablet, and MapLibre + deck.gl stayed below 60 fps in orbit. Navara was the steadiest of all. First display varied more with the network than between engines, so it is not ranked. The data set was small; the gain from WebGPU is not measured yet. [Article (Japanese)](https://www.ortho-earth.com/docs/story-benchmark-mobile-jp). - Speed on desktops (2026-10-20, two Macs and an iPhone 16 Pro, Ortho Earth 2.0.2): every engine held 60 fps while moving except MapLibre + deck.gl on the M1 and the iPhone; first display tied among the leaders. [Article](https://www.ortho-earth.com/docs/story-benchmark). - Features (2026-10-21, Ortho Earth 2.0.2; compatibility has grown since, see the numbers above): [Web map engines, feature by feature](https://www.ortho-earth.com/docs/story-features). - Where Ortho Earth is behind. It is young (first commit April 2026) and made by one developer; see the next section for what that means in practice. It alone of these engines is GPL-3.0 (the others are BSD, Apache-2.0 or MIT), so a page that ships it falls under the GPL unless you take the commercial license. There is no native mobile SDK. ## Maintenance and continuity Ortho Earth is made by one person. That is a real limit, and a fair evaluation should name it: there is no support contract, no team on call, and answers may not come fast. If you need an SLA, a product with a company behind it is the safer choice. What the project does instead is to be built so that it keeps working, and stays yours, whatever happens to its maker. - Long-term maintenance. Few moving parts: no map server, no backend, and outside its own packages the core depends only on earcut and pmtiles. 345 automated checks run on every change, and the MapLibre and CesiumJS galleries are graded again as the engine changes. Every app built on 1.x runs on 2.x, every 2.x release has kept the same API, and 3.x is being planned on the same rule: code written for Ortho Earth keeps running. - Vulnerabilities. Private reporting through GitHub with a reply within 7 days and a 90-day disclosure window ([SECURITY.md](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/blob/main/SECURITY.md)). CodeQL scans every pull request; dependencies are updated monthly and new upstream versions wait 7 days before they are taken. There are no accounts and no server-side user data to leak: the map runs in the visitor's browser. - Questions. One person answers, in English or Japanese, through GitHub issues. The documentation is also written to be read in one fetch ([llms-full.txt](https://www.ortho-earth.com/llms-full.txt)), so an AI agent can answer most questions on the spot. - If the developer stops. The code is GPL-3.0-or-later (formats and converters MIT), so anyone may continue it; contributions are under a [CLA](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/blob/main/CLA.md), so the rights stay clear. Nothing depends on the project's own servers: published npm packages and your own copies keep working. Data goes in and out in open, documented formats (the GeoPBF specification is MIT). And code written for it uses the MapLibre GL JS and CesiumJS APIs, so the way back to those engines is open from day one. ## Build with it - [Build with Ortho Earth](https://www.ortho-earth.com/start.md): Step-by-step recipe for putting the globe in your own page — with Vite (npm `@ortho-earth/globe`) or without a bundler (npm `@ortho-earth/japan`). Written for people and AI coding agents; every step is run by an automated test against the published packages. - [MapLibre GL JS examples on ortho-earth](https://www.ortho-earth.com/maplibre/): Ortho Earth is MapLibre GL JS compatible — `import * as maplibregl from "@ortho-earth/globe/maplibre"` runs existing MapLibre code on the globe (recipe section A8). The page lists all 139 official MapLibre GL JS examples running unchanged, each with its source (in the ortho-earth form), how closely it matches MapLibre, and a Run button. - [MapLibre GL JS code on a 3D globe](https://www.ortho-earth.com/docs/from-maplibre): Change one import and MapLibre GL JS code runs on the globe — what carries over, the 139 official examples, and what works differently. - [Coming from CesiumJS](https://www.ortho-earth.com/docs/from-cesium): Keep your CesiumJS code with npm `@ortho-earth/cesium` (CesiumJS 1.146's names, drawn on the globe), or move to the globe's own API — a table of CesiumJS features (3D Tiles, I3S, quantized-mesh terrain, glTF/GLB, the WGS84 ellipsoid, CZML, the clock) and how to write each one, with a live example per row. - [CesiumJS Sandcastle on ortho-earth](https://www.ortho-earth.com/sandcastle/): CesiumJS's official Sandcastle examples, each run unchanged on real CesiumJS and on the globe and shown side by side; of the 304 compared, 264 draw the same picture and 40 give the same answers. - [Coming from Leaflet](https://www.ortho-earth.com/docs/from-leaflet): npm `@ortho-earth/leaflet` gives an `L` like Leaflet 1.9's that draws on the globe — what is translated, what is not, and how to check a port. - [Coming from Google Maps](https://www.ortho-earth.com/docs/from-google-maps): npm `@ortho-earth/gmaps` gives a `google.maps` on the globe with no Google key for the map; with your key, Geocoder, Directions, Places and Street View are relayed to Google. - [Equal Earth on the GPU](https://www.ortho-earth.com/docs/equal-earth): How the Equal Earth world map is drawn — the projection in the shader, a central meridian that follows the view, and a morph from the globe. ## Apps - [japan(demo)](https://www.ortho-earth.com/japan/?demo=1#5.2/36.2/137.8): A demo that draws everything with one camera — from Japan's city data (PLATEAU) to the Solar System, from flat maps to 3D maps. - [Equal Earth](https://www.ortho-earth.com/globe/?start=equal): A scrolling Equal Earth world map with choropleths. Right-click any point to turn it into a 3D globe centered there. - [World quiz](https://www.ortho-earth.com/quiz/): A geography quiz for kids and grown-ups: flags, capitals and where countries are on the 3D globe. Three levels, the whole world or one region, stars and badges — and the countries you miss come back until you know them. - [geoedit](https://www.ortho-earth.com/japan/geoedit#5.1/38.2/136.9): A map editor. Draw and fix shapes on the 3D globe, and save them as GIS data. - [Nations of the World](https://www.ortho-earth.com/world/): Basic data for the countries and territories of the world, as cards — facts, flag and anthem, Wikipedia and map. - [Landforms of the World](https://www.ortho-earth.com/globe/physical): Mountains, rivers, lakes, seas and deserts of the world on a 3D globe — rank them, compare their heights and lengths, and overlay ocean currents, plate boundaries and climate zones. - [National Parks of the United States](https://www.ortho-earth.com/globe/parks): All 63 national parks of the United States on a 3D globe — photos, the National Park Service's boundaries, facts and Wikipedia links. - [World clock](https://www.ortho-earth.com/globe/clock): What time is it there? The local time of every time zone on a 3D globe, with daylight saving time and the night side — hover a place, or hold Shift for a whole country. - [World population in hexagons](https://www.ortho-earth.com/globe/hex): Where the world's 8 billion people live, as hexagonal columns on a 3D globe (H3 cells, Kontur Population). Zoom in for finer hexagons, drop your own points to count them. - [The shortest way is an arc](https://www.ortho-earth.com/globe/arcs): On a globe the shortest way between two places is a great circle. Arcs from anywhere to every capital, 37,000 air routes, great circle vs rhumb line, and your own CSV. - [World earthquakes](https://www.ortho-earth.com/globe/quakes/): Reads USGS earthquake data directly and shows each quake in 3D by its energy and depth. It can also play year by year or month by month. - [Satellites](https://www.ortho-earth.com/globe/sats): The current positions of satellites from CelesTrak data. Click a satellite to draw its orbit in 3D. - [Clouds now](https://www.ortho-earth.com/globe/clouds#3.2/18/135): Infrared images from five geostationary weather satellites (Himawari, GOES, Meteosat), read straight from NASA GIBS and EUMETSAT and drawn in 3D over the globe. - [ortho-solar](https://www.ortho-earth.com/solar/): The current positions of the planets and their moons — and a replay of how they move over time. - [Daily calendar](https://www.ortho-earth.com/himekuri/): A Japanese tear-off calendar (lunisolar date, rokuyō, solar terms, holidays) with sunrise, sunset, twilight and the Moon for where you stand, computed with your elevation. Scroll a week without end; add your own iCal. - [Make a video](https://www.ortho-earth.com/japan/scene#5.2/36.2/137.8): Cut out scenes of the 3D map and save or play them as one continuous video. - [GeoPBF](https://www.ortho-earth.com/geopbf/): Drop a GIS file, check it on the globe, write it in another format — 18 formats in, 14 out. The file never leaves your machine. - [MapLibre examples](https://www.ortho-earth.com/maplibre/): All 139 official MapLibre GL JS examples, run unchanged on the ortho-earth globe. Each card shows how closely it matches MapLibre; press Run to try it, or copy the code. - [Sandcastle](https://www.ortho-earth.com/sandcastle/): The official CesiumJS Sandcastle examples, run unchanged on the Ortho Earth globe through its Cesium-compatible facade. Each card puts CesiumJS and Ortho Earth side by side, with how closely the pictures match. - [Japan's open GIS data](https://www.ortho-earth.com/gishub-jp/): View and convert the open GIS data published in Japan. - [census2020](https://www.ortho-earth.com/japan/census2020/#5.2/36.2/137.8): Drill down into Japan's 2020 census — small-area statistics, disaster risk zones and land parcels. - [Yokohama digital twin](https://www.ortho-earth.com/yokohama/): A citizen-first digital twin of Yokohama: tap your home to see your school districts, nearest stations, flood risk and nearest evacuation site on one card. Walking distance from stations, facility search and hazard maps over PLATEAU 3D buildings, in 26 languages. - [Kyoto digital twin](https://www.ortho-earth.com/kyoto/): A citizen-first digital twin of Kyoto on the same core as Yokohama: tap your home for nearest stations, flood and landslide risk and evacuation sites on one card. Temples, a history tour from 794 and PLATEAU 3D buildings, in 26 languages. - [Fukuoka digital twin](https://www.ortho-earth.com/fukuoka/): A citizen-first digital twin of Fukuoka on the same core as Yokohama and Kyoto: tap your home for nearest stations, flood, storm-surge and tsunami risk and evacuation sites on one card. Hakata and Tenjin, a history tour from 57 AD and PLATEAU 3D buildings, in 26 languages. - [Sapporo digital twin](https://www.ortho-earth.com/sapporo/): A citizen-first digital twin of Sapporo on the same core as Yokohama and Kyoto: tap your home for nearest stations, flood and landslide risk and evacuation sites on one card. Odori Park, a history tour from 1869 and PLATEAU 3D buildings, in 26 languages. - [Satellite data (COG)](https://www.ortho-earth.com/japan/tellus): Satellite images (COG) on a server (Tellus), laid over the globe in 3D. - [ortho-japan](https://www.ortho-earth.com/japan/#5.2/36.2/137.8): A map drawn only from Japan's public data. Try out the basic features. - [National Parks of Japan](https://www.ortho-earth.com/japan/parks): All 35 national parks of Japan on a 3D globe — photos, the official boundaries, facts and Wikipedia links. - [Hot springs of Japan](https://www.ortho-earth.com/japan/onsen): About 2,000 hot springs of Japan from Wikipedia on a 3D map, colored by spring type, with onsen districts, distant sources and member inns of the Japan Secluded Hot Spring Association. - [Landforms of Japan](https://www.ortho-earth.com/japan/terrain): Mountains, volcanoes, rivers, lakes, plains, islands and seas of Japan on a 3D map, with their heights, lengths, areas and depths side by side. - [GLB models](https://www.ortho-earth.com/japan/models): Landmarks such as Tokyo Tower, placed on the globe as GLB models. Download them in a range of 3D formats. - [Fireworks over Sumida](https://www.ortho-earth.com/japan/fireworks): Full-scale fireworks (a 10-inch shell opens 320 m wide at 330 m) launched over the Sumida River, hidden by the buildings and Tokyo Skytree in front of them. - [Statistics in 3D](https://www.ortho-earth.com/japan/?g=showcase/pop-density-2020.geopbf#7.6/35.3/139.1/62t/-25r): A 3D graph from the 2020 census — every municipality raised by its population density. - [An old map of Edo](https://www.ortho-earth.com/japan/?iiif=/japan/showcase/edo-nihonbashi-1850.iiif.json#15.7/35.6895/139.778): A woodblock map of Nihonbashi from 1850, read as IIIF tiles straight from the National Diet Library and laid on today's Tokyo by its control points. - [ortho-nl](https://www.ortho-earth.com/nl/): The Netherlands in 3D — PDOK 3D Basisvoorziening buildings standing on OpenStreetMap vector tiles and terrain. Hop between eight cities, from Delft to Maastricht. ## Formats and libraries - [GeoPBF](https://www.ortho-earth.com/docs/geopbf): Compact binary format for geometry and an in-browser converter — 18 formats in, 14 out. npm `geopbf` (MIT). - [Gint](https://www.ortho-earth.com/docs/gint): Shared-edge topology in a GPU-readable form (GPL-3.0-or-later). - [AltPBF](https://www.ortho-earth.com/docs/altpbf): Elevation tiles in Protocol Buffers. npm `altpbf` (MIT). - glbconv: GLB → glTF / OBJ / PLY / STL / USDZ / 3D Tiles in the browser. npm `glbconv` (MIT). - `@ortho-earth/japan`: a 3D globe of Japan for any page with no bundler — GSI vector tiles and PLATEAU buildings in one self-contained bundle (GPL-3.0-or-later). - geoedit: the GeoPBF editor — shapes edited on the sphere, large files in place. npm `geoedit` (MIT). - `@ortho-earth/ephem`: planets, Moon and Sun 1800–2050, satellites (SGP4/SDP4) and the shared clock (GPL-3.0-or-later). - native-bucket: Cloudflare R2/Workers ↔ IndexedDB bridge and cache for heavy binary data (MIT). - `@ortho-earth/tile-formats`: lazily loaded decoders — MLT vector tiles and LAZ points for COPC (GPL-3.0-or-later). - Add-ons for the globe: `@ortho-earth/react`, `@ortho-earth/google3d`, `@ortho-earth/ktx2`, `@ortho-earth/splat`, `@ortho-earth/scene`, `@ortho-earth/h3` (GPL-3.0-or-later). Since 2.0 the libraries are written in TypeScript (strict) and ship their types; upgrading from 1.x: [MIGRATION.md](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/blob/main/MIGRATION.md). ## Documentation - [Docs](https://www.ortho-earth.com/docs/): Guides and reference for using and embedding the map engine. - Release notes: Ortho Earth 2.4.1 (2026-11-11) are in the [CHANGELOG](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/blob/main/CHANGELOG.md): `@ortho-earth/globe` and `core` 2.4.1; nearly caught up with CesiumJS (all Sandcastle examples run and give Cesium's answer; same picture 234 → 264), then measured on phones (60 fps on an iPhone XS and a Galaxy Tab A11+, [article in Japanese](https://www.ortho-earth.com/docs/story-benchmark-mobile-jp)); same API as 2.4.0. - [Release notes: Ortho Earth 2.4](https://www.ortho-earth.com/docs/story-v240) (2026-11-09, [日本語](https://www.ortho-earth.com/docs/story-v240-jp)): `@ortho-earth/globe` and `core` 2.4.0; Android starts on WebGPU (checked on a 4 GB Mali-G615 tablet), faster start-up (progressive pipelines), lighter drawing while the camera moves (PLATEAU buildings, terrain), Unity 6 and Unreal Engine 5.6+ plugins and Minecraft worlds (Java, Bedrock, WorldEdit .schem; round trip through an anchored glTF), point clouds read by sheet with class filter; closer to CesiumJS (Sandcastle same picture 226 → 234 of 303, MapLibre examples kept at 91/43/3/0); same API as 2.3. - [Release notes: Ortho Earth 2.3](https://www.ortho-earth.com/docs/story-v230) (2026-11-02, [日本語](https://www.ortho-earth.com/docs/story-v230-jp)): `@ortho-earth/globe` and `core` 2.3.0, `@ortho-earth/cesium` 0.2.0; closer to CesiumJS (Sandcastle same picture 226 of 303) and MapLibre GL JS (official examples 91/43/3/0 of 137); WebGPU screen-space reflections, contact shadows, height fog, light shafts, rain, toon; same API as 2.2. Also in [CHANGELOG](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/blob/main/CHANGELOG.md) and on [GitHub Releases](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/releases). - [Release notes: Ortho Earth 2.2](https://www.ortho-earth.com/docs/release-2-2) (2026-10-31, [日本語](https://www.ortho-earth.com/docs/release-2-2-jp)): `@ortho-earth/globe` and `core` 2.2.0, new `@ortho-earth/cesium`, `@ortho-earth/leaflet` and `@ortho-earth/gmaps`; same API as 2.1. Also on [GitHub Releases](https://github.com/kenjiyoshidahome2026-bit/ortho-earth/releases). - [Release notes: Ortho Earth 2.1](https://www.ortho-earth.com/docs/release-2-1): the MapLibre GL JS face. ## Source - [GitHub repository](https://github.com/kenjiyoshidahome2026-bit/ortho-earth): Full source code (MIT / GPL-3.0-or-later).