feat: initial public release (MAESTRO)

2026-06-03 05:08:00 +00:00
commit f5c7666f6b
823 changed files with 184150 additions and 0 deletions
@@ -0,0 +1,49 @@
+# 地図ツール（SearchPlaces / GetDirections / ReverseGeocode）
+
+地名・住所・経路情報を扱う。Google Maps API キーがあればそちら、無ければ Nominatim/OSRM（無料）を使用。
+
+## SearchPlaces — 場所検索
+
+```js
+SearchPlaces({
+  query: "東京駅 ラーメン",
+  location: "35.6812,139.7671",   // 任意: 中心座標
+  limit: 5
+})
+// → 名称・住所・座標・評価（API キーがあれば）等
+```
+
+## GetDirections — 経路検索
+
+```js
+GetDirections({
+  origin: "東京駅",
+  destination: "羽田空港",
+  mode: "driving"   // driving / walking / transit / bicycling
+})
+// → 距離・所要時間・経路ステップ
+```
+
+## ReverseGeocode — 座標から住所
+
+```js
+ReverseGeocode({
+  lat: 35.6812,
+  lng: 139.7671
+})
+// → 住所文字列
+```
+
+## API 設定
+
+Settings UI の "Tools" セクション:
+- **Google Maps API Key**: 設定すると Google Places/Directions API を使用（高精度・有料）
+- 未設定: Nominatim（住所検索）、OSRM（経路）の無料 API を使用
+
+Google Maps API は精度・情報量が多いが、ビジネス要件・無料枠の制約に注意。
+
+## 用途
+
+- 出張・旅程の経路情報
+- 店舗・施設の所在確認
+- ジオデータの正規化