Discover the E2 catalog

Resolve canonical feature IDs, region IDs, and the published datasets used by search and downloads.

Documentation navigation

Features and regions

catalogs.ts
import { E2 } from "@embed-earth/sdk-test";

const e2 = new E2();
const restaurants = e2.features.search("rest");
const restaurant = e2.features.resolve("restaurant");
const manhattan = e2.regions.resolve("Manhattan");

console.log(restaurant.id, manhattan.id);
Feature IDs are stable source IDs. The built-in registry includes restaurant 101, hospital 107, and school 113. Region names are for discovery; compute and storage use canonical region IDs.

Client methods

ClientMethods
e2.featureslist(), search(query), get(value), resolve(value)
e2.regionslist(), search(query), get(id), resolve(name)
e2.datasetslist(), info(feature), listSnapshots(), resolveSnapshot(), download()

Snapshots and downloads

snapshots.ts
import { DatasetClient, downloadToFile } from "@embed-earth/sdk-test/node";

const datasets = new DatasetClient();
const snapshots = await datasets.listSnapshots();
const snapshot = await datasets.resolveSnapshot("restaurant", null);
await downloadToFile("restaurant", "./restaurant.parquet");

Dataset metadata includes the feature, region, format, download URL, and size so you can choose the right data before downloading it.