maestro/docs/tools/searchplaces.md

地図ツール（SearchPlaces / GetDirections / ReverseGeocode）

地名・住所・経路情報を扱う。Google Maps API キーがあればそちら、無ければ Nominatim/OSRM（無料）を使用。

SearchPlaces — 場所検索

SearchPlaces({
  query: "東京駅 ラーメン",
  location: "35.6812,139.7671",   // 任意: 中心座標
  limit: 5
})
// → 名称・住所・座標・評価（API キーがあれば）等

GetDirections — 経路検索

GetDirections({
  origin: "東京駅",
  destination: "羽田空港",
  mode: "driving"   // driving / walking / transit / bicycling
})
// → 距離・所要時間・経路ステップ

ReverseGeocode — 座標から住所

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 は精度・情報量が多いが、ビジネス要件・無料枠の制約に注意。

用途

• 出張・旅程の経路情報
• 店舗・施設の所在確認
• ジオデータの正規化