google-maps

Google Maps API

場所の検索、詳細、レビューをクリーンな JSON 形式で提供します。呼び出しごとに通常の HTTP GET を 1 回実行し、使った分だけお支払いいただけます。Google Cloud プロジェクト、API キーの制限ルール、Places API のリクエストごとの課金は不要です。

ベース URL：https://google-maps.fetcher.sh

認証

支払い方法は 2 種類ありますが、データは同じです。詳しい仕組みは fetcher スキルをご覧ください。

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google-maps.fetcher.sh/api/place/search?query=coffee"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

すべてのレスポンスは { "status": number, "message": string, "data": ... } 形式です。HTTP ステータスは status と一致します。

エンドポイント（4 種類 — すべて GET、1 回あたり $0.005）

エンドポイント	返される内容
/api/place/search	テキストクエリに一致する場所。座標を基準に指定することもできます
/api/place/{fid}	フィーチャー ID による場所の詳細情報
/api/place/{fid}/reviews	場所のレビュー
/api/review/{id}	ID で指定した単一のレビュー

検索で必須のパラメーター：query。任意のパラメーター：languageCode、countryCode、 latitude、longitude、offset、zoom（検索範囲／精度）。レビューでは sort（relevant、newest、highest、lowest）と cursor を指定できます。

シナリオ

通常のテキスト検索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ramen in brooklyn" -G \
  "https://google-maps.fetcher.sh/api/place/search"

座標を基準に検索する（「近くの」形式のクエリの場合）：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=coffee" -G \
  --data-urlencode "latitude=40.7128" \
  --data-urlencode "longitude=-74.0060" \
  "https://google-maps.fetcher.sh/api/place/search"

場所の詳細を取得し、新しい順に並べたレビューを取得する：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google-maps.fetcher.sh/api/place/0x89c259af336b3341%3A0x8c584d6dfe89aa89"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "sort=newest" -G \
  "https://google-maps.fetcher.sh/api/place/0x89c259af336b3341%3A0x8c584d6dfe89aa89/reviews"

ID で単一のレビューを取得する：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google-maps.fetcher.sh/api/review/ChdDSUhNMG9nS0VJQ0FnSURDeGRXQnl3RRAB"

ローカライズされた結果（フランス語、カナダ地域）：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=boulangerie" -G \
  --data-urlencode "languageCode=fr" \
  --data-urlencode "countryCode=CA" \
  "https://google-maps.fetcher.sh/api/place/search"

MCP

{
  "mcpServers": {
    "google-maps": {
      "url": "https://google-maps.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料：search_endpoints、describe_endpoint、check_balance。有料： fetch_data（上記の任意のエンドポイント）、topup_credits、および名前付きショートカット google_maps_place_search。代わりに x402 で呼び出しごとに支払うには、headers ブロックを削除してください。詳しい手順は fetcher スキルをご覧ください。

エラー

• 400 — パラメーターがない、または無効（メッセージにパラメーター名が記載されます）
• 401 — 不明なキー、またはローテーション済みのキー
• 402 — 支払いが必要（x402 チャレンジ）、または topup_required（クレジット不足）
• 404 — 料金設定のないパス
• レート制限はありません。上流でエラーが発生した場合も返金されません（配信前に決済が完了します）

リファレンス

• エージェントのセットアップ全般：https://google-maps.fetcher.sh/skill.md
• OpenAPI 3.1 仕様：https://google-maps.fetcher.sh/openapi.json
• 簡易カタログ：https://google-maps.fetcher.sh/llms.txt
• 支払い、クレジット、MCP の詳しい説明：fetcher スキル
• サイト：https://google-maps.fetcher.sh