MCP Tools Reference: mapstools.googleapis.com

ツール: search_places

ユーザーのリクエストが、場所、ビジネス、住所、位置、スポット、その他の Google マップ関連の検索である場合に、このツールを呼び出します。

入力要件(重要):

  1. text_query(文字列 - 必須): プライマリ検索クエリ。ユーザーが探しているものを明確に定義する必要があります。

    • 例: 'restaurants in New York'、'coffee shops near Golden Gate Park'、'SF MoMA'、'1600 Amphitheatre Pkwy, Mountain View, CA, USA'、'pets friendly parks in Manhattan, New York'、'date night restaurants in Chicago'、'accessible public libraries in Los Angeles'
    • Place Details の場合: リクエストする属性('Google Store Mountain View opening hours'、'SF MoMa phone number'、'Shoreline Park Mountain View address' など)を含めます。
  2. location_bias(オブジェクト - 省略可): 特定の地理的エリアに近い結果を優先する場合に使用します。

    • 形式: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • 使用方法:
      • 半径 5 km にバイアスをかけるには: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • 中心点に強くバイアスをかける場合: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}}(radius_meters を省略)。
  3. language_code(文字列 - 省略可): 検索結果の概要を表示する言語。

    • 形式: 2 文字の言語コード(ISO 639-1)。必要に応じて、アンダースコアと 2 文字の国コード(ISO 3166-1 alpha-2)を続けます(例: en、ja、en_US、zh_CN、es_MX)。言語コードが指定されていない場合、結果は英語で表示されます。
  4. region_code(文字列 - 省略可): ユーザーの Unicode CLDR リージョン コード。このパラメータは、地域固有の場所名など、Place Details を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。

    • 形式: 2 文字の国コード(ISO 3166-1 alpha-2)(例: US、CA)。
  5. page_size(整数 - 省略可): 返される場所の最大数(1~10)。デフォルトは 5 です5 より大きい値を設定するのは、ユーザーが 5 つ以上の場所を比較する場合のみです。6 から 10 までの値は、費用とレイテンシが高くなります。

  6. include_extended_details(ブール値 - 省略可): ユーザー リクエストに、豊富な定性的分析情報、リアルタイムのダイナミクス、または特殊なエンティティ属性が必要な場合は、このフィールドを true に設定します。デフォルトでは false に設定されます。これを true に設定すると、費用とレイテンシが増加します。

ツール呼び出しの手順:

  • 位置情報(重要): 検索には十分な位置情報が含まれている必要があります。場所があいまいな場合(例: 「ピザ屋」のみ)、text_query で指定する必要があります(例: 「ニューヨークのピザ屋」)。または、location_bias パラメータを使用します。曖昧性除去のために必要な場合は、市区町村、都道府県、リージョン / 国名を含めます。

  • 常に、可能な限り具体的でコンテキストが豊富な text_query を提供します。

  • location_bias は、座標が明示的に指定されている場合、またはユーザーの既知のコンテキストから位置情報を推測することが適切であり、かつより良い結果を得るために必要な場合にのみ使用してください。

  • グラウンディングされた出力は、attribution フィールドの情報(利用可能な場合)を使用してソースに帰属させる必要があります。

次のコードサンプルは、curl を使用して search_places MCP ツールを呼び出す方法を示しています。

Curl リクエスト
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

SearchText のリクエスト メッセージ。

SearchTextRequest

JSON 表現
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}
フィールド
textQuery

string

必須。テキストクエリ。

languageCode

string

省略可。要約を返す言語。言語コードが指定されていないか、認識されない場合は、英語を優先した要約が返されます。

たとえば、英語の場合は「en」です。

サポートされている言語の最新リスト: https://developers.google.com/maps/faq#languagesupport

regionCode

string

省略可。リクエストの送信元のロケーションの Unicode 国 / リージョン コード(CLDR)。このパラメータは、地域固有の場所名など、Place Details を表示するために使用されます(利用可能な場合)。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。

たとえば、米国の場合は「US」です。

詳しくは、https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html をご覧ください。

なお、3 桁の地域コードは現在サポートされていません。

pageSize

integer

省略可。返される場所の最大数(最大 10)。サービスが返す値はこれよりも少ないことがあります。デフォルト値は 5 です。

5 つを超える場所をリクエストすると、Pro ティアがトリガーされ、請求額とレイテンシが増加します。

includeExtendedDetails

boolean

省略可。レスポンスに拡張された Place Details が含まれます。

ユーザー リクエストに、豊富な定性的分析情報、リアルタイムの動向、または特殊なエンティティ属性(定性的なレビュー、顧客の感情、フィードバックなど)が必要な場合は、このフィールドを true に設定します。- メニュー項目、料理、名物料理、飲み物、ビジネスのハイライトなどの具体的な提供内容。- 雰囲気、インテリア、美観、ムードなどの質的な要素。- リアルタイムのデータと、専門施設の仕様、訪問者向けのポリシー / ヒント、待ち時間。

標準の検索(料理、店舗の種類など)、場所 / 住所の検索、連絡先情報、営業時間、標準のメタデータ / 設備については、false(デフォルト)のままにします。

このフィールドを有効にすると、Pro ティアがトリガーされ、請求額とレイテンシが増加します。

共用体フィールド _location_bias。

_location_bias は次のいずれかになります。

locationBias

object (LocationBias)

検索結果を優先するオプションの地域。text_query に明示的な場所が指定されている場合、このフィールドの代わりに、その場所を使用して検索結果がバイアスされます。

LocationBias

JSON 表現
{
  "circle": {
    object (Circle)
  }
}
フィールド
circle

object (Circle)

省略可。中心点と半径で定義される円。radius_meters は省略可能です。設定しない場合、結果は中心点に偏ります。

サークル

JSON 表現
{
  "center": {
    object (LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}
フィールド
center

object (LatLng)

必須。円の中心点。

共用体フィールド _radius_meters。

_radius_meters は次のいずれかになります。

radiusMeters

number

円の半径(メートル単位)。半径は 50,000 メートル以内にする必要があります。

LatLng

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。

longitude

number

経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。

出力スキーマ

SearchText のレスポンス メッセージ。

SearchTextResponse

JSON 表現
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "contentToken": string
}
フィールド
places[]

object (PlaceView)

出力専用。要約で言及されている場所のリスト。

summary

string

出力専用。検索結果の自然言語による要約。要約には、「[0]」、「[1]」、「[2]」などのゼロベースの引用が含まれる場合があります。これらの引用は、places フィールドの対応する場所にマッピングされます。

contentToken

string

出力専用。検索コンテキストをカプセル化する暗号化されたトークン。Google マップのビジュアル レンダリング サービス、SDK、または Google マップ エージェント型 UI ツールキット(A2UI)に渡して、返された検索結果のインタラクティブな UI コンポーネントを表示できます。

PlaceView

JSON 表現
{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _location can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field _location.
}
フィールド
place

string

基盤となる場所のリソース名(「places/{id}」形式)。

id

string

基盤となる場所のプレイス ID。

googleMapsLinks

object (GoogleMapsLinks)

Google マップのさまざまなアクションをトリガーするリンク。

attribution

object (Attribution)

場所とともに表示する必須の帰属表示。

共用体フィールド _location。

_location は次のいずれかになります。

location

object (LatLng)

この場所の位置。

LatLng

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。

longitude

number

経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。

JSON 表現
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
フィールド
directionsUrl

string

場所へのルートを表示するリンク。このリンクでは、目的地の場所のみが入力され、デフォルトの移動手段 DRIVE が使用されます。

placeUrl

string

この場所を表示するリンク。

writeAReviewUrl

string

Google マップでこの場所のクチコミを投稿するためのリンク。

reviewsUrl

string

Google マップでこの場所のクチコミを表示するためのリンク。

photosUrl

string

Google マップでこの場所の写真を表示するためのリンク。

アトリビューション

JSON 表現
{
  "title": string,
  "url": string
}
フィールド
title

string

アトリビューションに表示するタイトル。

url

string

帰属表示のリンク先 URL。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値ヒントが定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的影響は発生しません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌