Next.js quickstart

Install the E2 SDK and add search, routing, and compute to a Next.js application.

Documentation navigation

Start with E2

SDK guides

CLI guides

MCP guides

Applications

Framework quickstarts

Install

terminal

npm install @embed-earth/sdk-test

Keep this page server-rendered or add "use client" when the queries depend on browser state.

Example

app/page.tsx

"use client";

import { useEffect, useState } from "react";
import { E2 } from "@embed-earth/sdk-test";

const e2 = new E2();

export default function Page() {
  const [summary, setSummary] = useState("");

  useEffect(() => {
    (async () => {
      const places = await e2.search({
        feature: "restaurant",
        area: "Manhattan",
        mode: "auto",
        limit: 100,
      });

      const route = await e2.route.route({
        locations: [{ lat: 40.74, lon: -73.99 }, { lat: 40.71, lon: -74.01 }],
        mode: "walking",
      });

      const count = await e2.compute.feature("restaurant")
        .region("Manhattan")
        .near("park", 500)
        .count();

      setSummary(`${places.features.length} restaurants, ${count} near parks`);
    })();
  }, []);

  return <main><p>{summary}</p></main>;
}

Search example

src/search.ts

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

const e2 = new E2({ searchUrl: "/search" });
const places = await e2.search({
  feature: ["restaurant", "hospital"],
  area: ["Manhattan", "Brooklyn"],
  mode: "auto",
  limit: 100,
});

console.log(places.features);

The universal E2 import routes browser search to HTTP /search. Set searchUrl to your API route when it lives elsewhere.

Next steps

Replace the example coordinates and feature with your own values. Continue with the SDK guide for search, routing, compute, storage, catalogs, and cells.

All developer interfaces