EmbedEarth from the terminal

Search geographic features, manage supported local data, calculate routes, run Compute, and inspect datasets from one command tree.

Documentation navigation

Install

terminal
npm install -g @embedearth/cli
e2 --help
The executable is e2. Add the global --json option for machine-readable output. The CLI requires Node 20 or newer.

First search

terminal
e2 search restaurant hospital --area "Manhattan" --area "Brooklyn" --limit 500

e2 --json search restaurant --area Manhattan --limit 10

Search output is a GeoJSON FeatureCollection. See the shared Search guide for filters and offline behavior.

Command tree

CommandPurpose
e2 searchSearch one or more features and areas.
e2 cacheManage the local data cache.
e2 routeRun routes and network analysis.
e2 computeRun remote, cached, or local spatial compute primitives.
e2 storageIndex user-owned datasets locally.
features, regions, datasetsDiscover registry, region, and dataset metadata.
download, import, import-file, query, statsDownload, import, inspect, and query local data.

Guides