🌍 Re:Earth GeoSuite v18.1.0

注入方式ごとの推奨容量

運用の推奨

• まず「URL 経由」を選ぶ: geojson:/3dtiles:/xyz: 等の URL 指定レイヤーは Visualizer ホスト側が直接 fetch するため、サンドボックス上限を受けません。ファイルはドロップではなく CMS 等に置いて URL で参照するのが基本です。
• 総量の目安: ハード制約は「ctx を横断する結果 ≤4MB/回」のみ。レイヤ数自体に上限はありませんが、属性検索・一覧を快適に使うなら検索対象のベクトルデータ合計で数10MB 程度を目安にしてください。
• 大規模データは絞り込み前提で: 巨大ファイルは duckdb:（GeoParquet/CSV/JSON）か gpkg: で、bbox=auto の部分読み込み＋属性フィルタを使い、「クエリ結果だけが 4MB 以下」になるよう設計してください。元データのサイズは問いません。
• 配布は URL 参照で: プロジェクト一式は CMS 等に置いた qgis: <.kasc または .zip の URL> を推奨。ZIP の中身はブラウザが直接 fetch するため容量制限を受けません（ただし ZIP 内 geojson 等は kasczip デコード注入のため 4MB/件）。
• 失敗は可視化されます: 上限超過レイヤは消えず、レイヤ一覧に理由付きのグレーアウト行として残ります（× で削除、条件を直して再読み込みで自動置換）。

📥 Step 1: プラグインをインストール

1. Re:Earth Visualizer を開き、画面右上の「プラグイン」アイコンをクリック
2. 「個人インストール済み」タブを選択
3. 下記のリポジトリURLを入力
4. インストール完了！

⚙️ Step 2: 設定方法

Inspector（歯車アイコン）の「一括設定」を開き、「設定テキスト」に以下の形式で行ごとに入力してください。

layer: 地理院タイル 標準地図 | off
xyz: OpenStreetMap | https://tile.openstreetmap.org/{z}/{x}/{y}.png
base: 地理院タイル 全国最新写真 | https://cyberjapandata.gsi.go.jp/xyz/seamlessphoto/{z}/{x}/{y}.jpg | 出典：国土地理院 | max=18
base: OpenStreetMap | https://tile.openstreetmap.org/{z}/{x}/{y}.png | OpenStreetMap contributors | max=19
3dtiles: 東京都/千代田区（建築物LOD1） | https://assets.cms.plateau.reearth.io/assets/0e/e5948a-e95c-4e31-be85-1f8c066ed996/13101_chiyoda-ku_pref_2023_citygml_1_op_bldg_3dtiles_13101_chiyoda-ku_lod1/tileset.json | off
geojson: 東京都/行政区域 | https://assets.cms.reearth.io/assets/ef/b1d062-e44b-4a19-8ebe-5fafeeba05f2/%E8%A1%8C%E6%94%BF%E5%8C%BA%E5%9F%9F.geojson | on | terrain
flatgeobuf: 地名データ | https://example.com/chimei.fgb | on | terrain
parquet: 建物データ | https://example.com/bldg.parquet | off
duckdb: 大規模POI | https://example.com/poi.parquet | where=city='千代田区' | limit=5000 | covering=xmin,xmax,ymin,ymax | bbox=auto
background: #ffffff
lang: auto
info: https://re-earth-geo-suite.vercel.app/ryu.html
cam:東京駅|35.653108|139.761449|h=2200.6|p=-30
fly_geojson: 東京都心ルート | https://example.com/route.geojson | speed=30 | height=100 | pitch=-10 | loop=true | view=camera
legend: 凡例|https://re-earth-geo-suite.vercel.app/image/legend_sample.png

設定行は順不同です。背景色は background: で指定します。

• layer: 既存のシステムレイヤ名を指定し、|off で非表示（|on で表示）に設定できます（例: layer: 地理院タイル 標準地図 | off）。
• xyz: 追加レイヤ (XYZタイル) です。タイトルとURLを `|` で区切ります。末尾に `|off` を付けると非表示で追加されます。
• base: ベースマップ用レイヤです。UI上部のドロップダウンに追加され、選択した1つだけが有効化されます。
• max=/min=/zoom=: XYZ タイルのズームレベル制限を指定します。例: max=18、zoom=2-18。地理院タイルや OpenStreetMap には既知の最大ズームを自動で適用します。
• 3dtiles: 3D Tilesレイヤです。
• geojson: GeoJSONレイヤです。末尾に | terrain / | 3dtiles / | both を追加すると、3D タイルへのドレープ方法を指定できます（既定は「表示」タブのドロップダウン準拠）。
• flatgeobuf: / fgb: FlatGeobuf レイヤです。flatgeobuf: 名前 | .fgb URL | on/off | classification の形式で、ブラウザ内で GeoJSON にデコードして追加します（属性検索・属性パネルも利用可能）。classification には terrain / 3dtiles / both を指定できます。
• parquet: / geoparquet: GeoParquet レイヤです。形式は flatgeobuf と同じ parquet: 名前 | .parquet URL | on/off | classification で、ブラウザ内で GeoJSON にデコードして追加します。
• duckdb: 巨大ファイル向けの DuckDB-Wasm クエリレイヤです。duckdb: 名前 | URL | オプション… の形式で、SQL 絞り込み後に GeoJSON レイヤーとして追加します。オプション: where=…（SQL 条件）・limit=…・format=parquet|csv|json・geom=…（ジオメトリ列名）・lon=…/lat=…（経度/緯度列名）・columns=a,b・covering=xmin,xmax,ymin,ymax（covering bbox 列名。指定すると行グループ単位で読み飛ばし）・bbox=auto|off（既定 auto：カメラ移動に連動して表示範囲だけ再クエリする部分読込）・on/off・classification。注意: セッション最初のクエリ時に wasm 初期化で約15秒かかります（下記注意事項参照）。
• lang: プラグイン UI の言語を固定します。lang: en|ja|zh-CN|zh-TW|ko|es|fr|de|it|pt|ru|nl|pl|uk|tr|ar|hi|id|th|vi。lang: auto または未指定でブラウザ言語を自動検出し、未対応言語は英語にフォールバックします。
• info: 情報タブに表示するWebページのURLを指定します。
• cam: カメラプリセットを指定します。cam:タイトル|緯度|経度 が最小形式で、オプションとして |h=高度m|d=方位°|p=傾き° を追加できます。
• legend: 凡例画像のURLを指定します。
• fly_geojson: Fly パネル（タブバーの ✈️ ボタン）に登録する飛行ルートを指定します。fly_geojson: 名前 | GeoJSON URL または route:名前 が基本形式で、オプションとして speed=km/h（負値で逆再生）・height=対地高度m・pitch=°・loop=true/false・view=camera|center（camera=ルート上を進む搭乗視点、pov/ride 等の別名も可。center=後方上空から追う空撮視点、chase/follow/aerial 等の別名も可）・step=サンプリング間隔m を追加できます。GeoJSON の properties.fly に同名オプションを書くこともでき、heightReference: "MSL" で絶対高度ルートにできます。route:名前 は Fly パネルで描画・保存したルートを参照します。末尾に | off で無効化。
• attrUrlOpen: 属性パネル内のURLクリック動作を切り替えます。panel / newtab を指定できます。既定は newtab です。
• 行プレフィックスの別名: tile: = xyz:、3d-tiles: = 3dtiles:、preset: = layer:、bg: = background:、fgb: = flatgeobuf:、geoparquet: = parquet: として解釈されます。
• geminiApiKey: / geminiModel: AI チャットウィジェットで使う Gemini API キーとモデル名（省略可）を指定します。キーは AI Chat ウィジェット側 Inspector の「Gemini APIキー」欄または ⚙ 設定からも入力できます（優先順: AI Chat Inspector 欄 > 設定テキストの geminiApiKey: 行 > セッション入力 > ブラウザ保存）。注意: Inspector に書いたキーは公開サイトでは全訪問者に配信されます。公開サイトではサーバーサイドプロキシ（環境変数 GEMINI_API_KEY → /api/gemini）の利用を推奨します。

👁️ レイヤーの表示/非表示切替

1. 左側のプラグインUI内で、各レイヤーの横にチェックボックスがあります。
2. チェックボックスをON/OFFすることで、レイヤーの表示/非表示を切り替えられます。

🧩 グループルール

レイヤのグループ化はインスペクター内の区切り文字で指定します。ルールは以下の通りです。

• /：一括・折りたたみ — グループ内をまとめてON/OFF。初期表示は折りたたみ。
• //：排他・折りたたみ — グループ内は排他（ラジオ）で、同時に1つのみON。初期表示は折りたたみ。
• バックスラッシュ:\：一括・展開 — グループ内をまとめてON/OFF。初期表示は展開（開いた状態）。
• ダブルバックスラッシュ:\\：排他・展開 — グループ内は排他（ラジオ）で、初期表示は展開。

補足: 単一の / と \ は通常グループとして同一視されますが、二重区切りの // と \\ は排他グループとして区別されます。バックスラッシュ由来の区切りは展開優先となります。

詳細はドキュメントを参照してください： layer-grouping-specification.md

Inspector での初期表示指定

Inspector で初期表示を指定するには、該当行のパイプ（|）で区切った任意の位置に ON / OFF を追記してください（大文字小文字は区別しません）。

xyz: Tokyo Basemap | https://tile.example/{z}/{x}/{y}.png | OFF
geojson: 避難所 | https://example.com/shelters.geojson | ON
3dtiles: 建物LOD | https://example.com/tileset.json | OFF

補足: 現在 visible=true/visible=false 形式は自動的にパースされません。必要であれば対応を追加できますので指示ください。

GeoJSON 3D ドレープ 設定例

geojson: 行の末尾に | terrain / | 3dtiles / | both を追加すると、そのレイヤーだけ 3D タイルへのドレープ方法を指定できます。

geojson: 東京都/行政区域 | https://example.com/行政区域.geojson | on | 3dtiles
geojson: 東京都/行政区域 | https://example.com/行政区域.geojson | on | terrain
geojson: 東京都/行政区域 | https://example.com/行政区域.geojson | on | both

省略時は「表示」タブの「GeoJSON 3D ドレープ」選択が適用されます。

✈️ Fly モードの使い方

1. プラグイン UI のタブバーにある ✈️ ボタンで Fly パネルを開きます。
2. ルートは fly_geojson: 行で定義したもの、または 「描画」ボタンで地図上にポリラインを描いて保存したもの（route:名前）をドロップダウンから選択します。
3. 「ルートを表示」で選択中のルートを黄色ラインでプレビューできます（一時的な可視化のため、レイヤー一覧には表示されません）。
4. 速度（km/h、負値で逆再生）・対地高度（m）・ピッチ・視点（搭乗/空撮）・ループを調整し、▶ 再生で飛行開始。⏸ 一時停止／■ 停止で制御します。入力値は再生中でも即時に反映されます。
5. 「保存」ボタンで選択ルートの GeoJSON を <ルート名>.geojson としてダウンロードできます。

※ 描画機能（スケッチ）や地形サンプリングは、利用している Re:Earth 環境のプラグイン API が対応している場合のみ有効です。非対応環境では該当ボタンが無効表示になります。

🤖 AI チャットの詳細

Gemini の function calling で地図を自然言語操作できるチャットウィジェットです。「東京駅に飛んで」「○○レイヤーを隠して」などの指示で、カメラ移動・地名検索・レイヤー操作・カメラプリセット・ベースマップ切替・Fly ルート再生・Terrain/Shadow・Street View・スクリーンショットなどを実行します。runCode ツールで複数ステップの処理も可能です。

• API キー（BYO）の指定経路: ウィジェットの ⚙ 設定 / AI Chat ウィジェット側 Inspector の「Gemini APIキー」欄 / Inspector 設定テキストの geminiApiKey: 行。優先順は「AI Chat Inspector 欄 > 設定テキスト > セッション入力 > ブラウザ保存」です。
• サーバーサイドプロキシ（推奨）: ホスティング側で Vercel 環境変数 GEMINI_API_KEY を設定すると /api/gemini プロキシ経由になり、ブラウザにキーを配らずに利用できます。
• セキュリティ: Inspector に書いたキーは公開サイトの全訪問者に平文配信されます。公開範囲の比較表は Gemini APIキーのセキュリティ状況 を参照してください。

⚠️ 注意事項

⚠️ Google Photorealistic 3D Tiles 利用時の注意

⚠️ duckdb: レイヤーの初回読み込み時間