google-maps

Google Maps

パッケージの単独の exec CLI を使って、現実世界の場所に関する質問に回答します。このワークフローでは、MCP サーバーを起動したり設定したりしないでください。

CLI を呼び出す前に

• セッションでの最初の呼び出し時、または実行に失敗した後は、../_shared/setup-and-diagnostics.md を読み、課金されないローカルの事前チェックを実行してください。
• GOOGLE_MAPS_API_KEY はユーザーが指定する必要があります。ユーザーがシェル履歴とプロセス一覧への露出を明示的に了承しない限り、キーを表示したり、コマンドに含めたりしないでください。
• Places のクチコミ、写真、AI による要約を提示する前に、../_shared/content-attribution.md を読んでください。

ワークフロー

1. 具体的に知りたい場所の情報を特定し、不足している入力を確認します。ジオコーディングや場所の検索で解決できる詳細は、ユーザーに尋ねないでください。
2. 正確なパラメーター、レスポンスのフィールド、または複数ツールを組み合わせる手順が必要な場合は、references/tools-api.md を読んでください。
3. 曖昧な住所より座標を優先し、名前を繰り返し検索するより place_id を優先してください。
4. 目的の結果を得るために必要な呼び出しだけを連携します。返された識別子と座標を再利用してください。
5. ゼロ以外の終了ステータス、または { "success": false } は失敗として扱い、地理データとみなさないでください。
6. 生の JSON を返すのではなく、役立つ結果を要約してください。必要な場合は、情報源と帰属表示のメタデータを保持してください。

ツールの選択

結果	優先するツール
住所またはランドマークから座標を取得	maps_geocode
座標から住所を取得	maps_reverse_geocode
近隣の場所を検索	maps_search_nearby、続けて maps_place_details
自然言語で場所を検索	maps_search_places、続けて maps_place_details
候補となる場所を比較	maps_compare_places、または検索 → 詳細 → 距離マトリックス
ルートまたは移動手段を比較	maps_directions、maps_distance_matrix
より広い旅程を伴わない複数経由地のルート	maps_plan_route
ルート沿いの場所を検索	maps_search_along_route
地域の情報を調査	maps_explore_area と目的を絞った近隣検索
標高、タイムゾーン、天気、または大気質を確認	対応する環境ツールを使用します。必要に応じて、先にジオコーディングしてください
地図を表示	場所またはルートが判明した後に maps_static_map

呼び出し

npx -y @cablate/mcp-google-map exec <tool> '<json_params>'

CLI は maps_geocode のような MCP 形式の名前と、geocode のような短い名前のどちらも受け付けます。各呼び出しはステートレスで、JSON を標準出力に返します。

対応範囲

• 複数日にわたる旅程、旅行スケジュール、または移動日の最適化には、代わりに google-maps-travel-planning を使用してください。
• Google ビジネス プロフィールの可視性、グリッド順位、キーワードの網羅状況、または競合分析には、代わりに google-maps-local-seo を使用してください。
• maps_weather は日本、中国、韓国、キューバ、イラン、北朝鮮、シリアでは利用できません。その地域では最新のウェブ情報源を使用してください。
• 公共交通機関の経由地最適化には対応していません。公共交通機関のルートでは optimize: false を使用してください。
• 地理的な近さや標高だけでは、安全性、アクセシビリティ、洪水リスク、適性は判断できません。関連する場合は、こうした制限を明記してください。

参考資料

• references/tools-api.md：正確なパラメーター、レスポンスの形式、汎用的な連携手順が必要な場合に読んでください。
• ../_shared/setup-and-diagnostics.md：初回実行時のチェックとエラーの分類について読む資料です。
• ../_shared/content-attribution.md：Google Maps の規制対象コンテンツを表示する前に読んでください。