goplaces

• 近くのビジネスやスポットを検索するエージェントが必要な場合 — 例: 「1km以内にある営業中のコーヒーショップで評価4以上」
• 「Soho, London」のような人間が読める場所の名前を、後続のAPI呼び出し用のGoogle Place IDに解決したい場合
• 営業時間、住所、レビューなどの構造化された場所の詳細を、JSON出力経由でスクリプトやワークフローに渡す必要がある場合
• エージェントが営業状況、価格レベル、種別、または地理的な半径で結果をフィルタリングする必要がある場合

• Google Places APIキーをお持ちでない場合、または取得できない場合 — キーがなければ goplaces は機能しません
• 地図のレンダリング、道順、またはルート案内が必要な場合 — このスキルは検索専用であり、完全なMaps SDKではありません
• 大量または高ボリュームの場所データが必要な場合 — 標準のGoogle Places APIのクォータと課金が適用されます

オープン中のステータス、最低評価、価格レベル、種類、結果件数のフィルターを使って、自然言語による場所の検索を実行します。例: goplaces search "coffee" --open-now --min-rating 4 --limit 5

特定の緯度・経度に向けて検索結果にバイアスをかけ、メートル単位で設定可能な半径内に結果を制限することで、位置情報を考慮した検索を正確かつ関連性の高いものにします。

resolve コマンドを使用して、人間が読める場所名（例：「Soho, London」）を1つまたは複数のGoogle Place IDに変換します。これにより、手動でIDを調べることなく、後続の詳細情報の検索が可能になります。

任意のPlace IDの包括的な詳細情報（レビューを含む）をgoplaces details <place_id> --reviewsで取得できます。権威あるPlace情報でエージェントの応答を充実させるのに最適です。

デフォルトでは人間にとって読みやすいANSIカラー付きのテキストを出力し、--json オプションを指定するとスクリプトや自動化パイプラインで確実にパースできるクリーンなJSONに切り替わります。カラー表示は --no-color オプションまたは環境変数 NO_COLOR で無効化できます。

--page-token を使用したマルチページの結果セットをサポートしており、エージェントがデフォルトのページサイズを超える大規模な結果リストを反復処理できます。

ユーザーの外出計画を支援するエージェントは、特定の地域内で評価が高く営業中のレストランを検索し、料理の種類や価格帯でフィルタリングしたうえで、上位の結果を読みやすい形式で表示することができます。

データパイプラインエージェントは、曖昧な場所の文字列（例：市区町村、ランドマークなど）を正式なGoogle Place IDに解決し、それを他のAPIコールに渡したり、データベースに保存したりします。

会場を調査しているエージェントは、goplaces details <id> --reviews を使用して Google Places のレビューを直接取得し、ブラウザを必要とせずに感情を要約したり、特定のフィードバックを抽出したりすることができます。

バッチ自動化スクリプトが --json 出力を使用して、ビジネス名のリストに構造化された場所データ（住所、評価、営業時間）を付加し、その結果を後続の処理ツールへ送り込みます。