EmbedEarth (E2)

@embedearth/mcp

EmbedEarth（E2）は、物理世界のためのオープンでプログラム可能な地理エンジンです。この MCP サーバーは、AI エージェントに Search、Compute、Route、Map、Stratum の構造化ツールを提供します。

E2 は Google Maps Platform に代わるオープンな選択肢として構築されており、Maps、Places、Routes、Geocoding、Autocomplete、Street View に分散していることの多い機能を統合しながら、空間計算、オープンな地理データ、ローカル実行を追加しています。

E2 を選ぶ理由

従来の地図 API は、主に地図、場所、ルート案内を中心に構築されています。E2 を使えば、より広範な物理世界をプログラム可能にできます。

エージェントに次のツールを提供できます。

• 検索：場所、インフラ、観測データ、自然、市民データ、その他の現実世界の地物を検索します。
• 計算：距離、近接性、件数、密度、カバレッジ、ギャップ、その他の空間的関係を計算します。
• 地図表示：ベースマップ、地物、ルート、アプリケーションデータを表示します。
• ルート検索：座標間、または現実世界の地物へのルートを検索します。
• Stratum：ローカル、オフライン、クラウドのワークフロー向けに地理データセットを扱います。
• 地理的位置に紐づいたストリートレベルの画像や視覚的な観測データにアクセスします。

Google Maps Platform の統合を利用してきたエージェントの場合、E2 は Maps、Places、Routes、Geocoding、ストリートレベルの画像を使った一般的なツールのワークフローの多くを置き換えながら、より幅広い地理データセットや空間計算への直接アクセスを提供できます。

インストール

npx -y @embedearth/mcp

モード

E2 はローカルまたはクラウドで実行できます。ローカルデータセットは地域ごとに一度ダウンロードされ、以降のリクエストで再利用されるため、同じデータを再取得する必要はありません。

モード	用途
auto	利用可能な場合はローカルデータを使用し、それ以外の場合はクラウドを使用します。
offline	一度ダウンロードした後、ローカルで再利用します。
cloud	API キーを使用して、利用制限なくクラウドで実行します。

API キーと制限

基本的なクラウド利用では API キーは任意ですが、キーを設定するとクラウドの全機能を利用できます。embed.earth でキーを作成し、MCP ホスト環境で E2_API_KEY として設定してください。ストリートレベルの画像にもキーが必要です。キーがない場合、クラウドの Search、Compute、Route リクエストは毎分 60 件に制限され、e2_stratum の query は毎秒 1 件として扱う必要があります。

検索

e2_search は、地物、場所、地域、座標を使って物理世界を検索します。場所、インフラ、観測データ、自然地物、市民データ、その他の地理データセットを、単一のツールから検索できます。検索結果として、条件に一致する物理世界のレコードが GeoJSON の FeatureCollection 形式で返されます。

feature は、検索対象を指定するカノニカルキーまたは数値 ID です。名前付き地域には area、正確な地域の指定には area_id、地点検索には座標、より広範な地域の指定には country_code と state_code を使用します。

オプションのパラメーター

パラメーター	型	用途
area	string | string[]	名前付き地域を検索します。area_id とは相互排他的です。
area_id	string | string[]	正確な地域 ID を検索します。area とは相互排他的です。
country_code	string	国を指定します。例：US。
state_code	string	州または県を指定します。例：NY。
latitude、longitude	number	座標周辺を検索します。両方を指定してください。
mode	cloud | offline | auto	実行モードを指定します。デフォルトは auto です。
limit	number	返される地物の最大数です。デフォルトは 1000 です。

{ "feature": "restaurant", "area": "New York", "mode": "auto", "limit": 25 }

{ "feature": "restaurant", "area_id": "4915", "mode": "cloud", "limit": 25 }

{ "feature": "restaurant", "latitude": 40.7128, "longitude": -74.006, "mode": "cloud", "limit": 25 }

{ "feature": "restaurant", "country_code": "US", "state_code": "NY", "mode": "cloud", "limit": 25 }

コンピューティング

e2_compute は地理フィーチャーを直接空間解析します。最も近いものを検索したり、距離を測定したり、フィーチャーをカウントしたり、密度やカバレッジを計算したり、空白を検出したり、近くのオブジェクトをクラスタリングしたりできます。別途 GIS スタックを用意することなく、地理データから答えを導き出せます。

feature は測定対象を定義し、area または area_id は地理的な範囲を定義します。near などの関係パラメーターは、あるフィーチャーセットを別のフィーチャーセットに関連付けます。

プリミティブ	目的
NEAREST	最も近いフィーチャーを検索します。
DISTANCE	フィーチャーセット間の距離を測定します。
WITHIN	関係距離内にあるフィーチャーを選択します。
COUNT	関連するフィーチャーをカウントします。
DENSITY	フィーチャーの密度を測定します。
COVERAGE	到達したエリアを測定します。
GAPS	到達していないエリアを検索します。
CLUSTER	近くのフィーチャーをグループ化します。

{ "primitive": "COUNT", "feature": ["restaurant"], "area_id": "4915", "near": "park", "distanceMeters": 500, "mode": "cloud" }

{ "primitive": "DENSITY", "feature": ["restaurant"], "area": "New York", "near": "park", "distanceMeters": 500, "mode": "auto" }

ルーティング

実世界での移動を計算します。座標または E2 フィーチャーから、ルート、移動時間行列、等時間圏、マップマッチング、標高クエリ、ネットワークを考慮した検索を実行できます。これにより、エージェントは固定座標だけでなく、場所を目的地としてルーティングできます。座標からフィーチャーへのルートには e2_route_to_feature を、直接ルート、行列、等時間圏、マップマッチング、位置特定、高さの取得には e2_route を使用します。

独自の互換性のあるルーティングサービスを使用する場合にのみ、ROUTE_URL を設定してください。

ツールまたは操作	目的
e2_route_to_feature	座標から、最も近いレストランなど、一致するフィーチャーまでのルートを検索します。
e2_route と route	1 つ以上の座標間のルートを作成します。
e2_route と matrix	複数の出発地と目的地間の移動コストを返します。
e2_route と isochrone	1 つ以上の制限時間内に到達可能なエリアを計算します。
e2_route と mapMatch	記録された座標の軌跡を道路ネットワークに照合します。
e2_route と locate	座標をルーティング可能なネットワーク上の位置に対応付けます。
e2_route と height	1 つ以上の地点の標高データを返します。

{ "feature": "restaurant", "from": [40.7128, -74.006], "mode": "walking" }

{ "operation": "matrix", "body": { "sources": [{ "lat": 40.7128, "lon": -74.006 }], "targets": [{ "lat": 40.7306, "lon": -73.9352 }], "mode": "driving" } }

マップ

e2_map_sources は E2 データを MapLibre 対応のマップソースとして出力します。グローバルな Planet ベースマップと PMTiles フィーチャーレイヤーを利用できます。エージェントとの会話内でマップを描画する代わりに、マップデータのメタデータを返すため、スタイル設定や操作はクライアントアプリケーション側で行えます。

Stratum

e2_stratum は、地理データセット向けの E2 のポータブルなデータレイヤーです。従来型の空間データベースを維持することなく、ローカルまたはクラウドのワークフロー向けに地理データを検出、ダウンロード、キャッシュ、クエリ、アップロードできます。GeoJSON、CSV、Parquet、SQLite に対応しており、データセットを一度ダウンロードすれば、複数のアプリケーションや地域で再利用できます。

操作	目的
cacheList、cacheSet、cacheDelete、cacheClear	検証済みのローカルデータを管理します。
featureList、featureSearch、featureInfo	組み込みフィーチャーを検索します。
areaList、areaSearch、areaInfo	組み込みエリアを検索します。
dataList、dataInfo	公開済みデータを確認します。
download、query	クラウドまたはローカルのデータを取得してクエリします。
upload	名前空間付きのローカルデータを追加します。

{ "operation": "upload", "path": "./stores.geojson", "database": "./stores.db", "feature": "stores", "namespace": "my-app" }

地理カタログ

E2 は実世界をフィーチャーとエリアに分けて整理します。

フィーチャーは、場所、インフラ、観測結果、自然地物、画像に関連付けられたレコードなど、実世界に存在するものを表します。

エリアは、国、州、都市など、安定した ID を持つ地理的な地域を表します。

フィーチャーカタログとエリアカタログを閲覧して、Search、Compute、Route、Stratum で利用できる入力データを確認できます：フィーチャーカタログ · エリアカタログ。

ストリートレベル画像

EmbedEarthは、数十億枚のストリートレベル画像を処理し、視覚的な観察結果を地理的な地物や場所と結び付けます。画像は場所に視覚的なコンテキストを加え、従来の場所データベースには登録されていない物理世界の特徴を明らかにできます。

ストリートレベル画像は現在クラウドベースで、APIキーと有効なプランが必要です。

その他のインターフェース

SDKパッケージ · CLIパッケージ · MCPドキュメント全文