MCP Reference: mapstools.googleapis.com

Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービス間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。

これは、Maps Grounding Lite API によって提供される MCP サーバーです。このサーバーは、デベロッパーが Google Maps Platform 上に LLM アプリケーションを構築するためのツールを提供します。

サーバー エンドポイント

MCP サービス エンドポイントは、AI アプリケーション（MCP クライアントのホスト）が安全で標準化された接続を確立するために使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための連絡先です。Google MCP エンドポイントはグローバルまたはリージョンです。

mapstools.googleapis.com MCP サーバーには、次の MCP エンドポイントがあります。

MCP ツール

MCP ツールは、MCP サーバーが LLM または AI アプリケーションに公開して、現実世界でアクションを実行する関数または実行可能な機能です。

mapstools.googleapis.com MCP サーバーには、次のツールがあります。

MCP ツール
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'。
    • 特定の場所の詳細の場合: リクエストされた属性（'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 リージョン コード。このパラメータは、地域固有の場所の名前など、場所の詳細を表示するために使用されます（利用可能な場合）。このパラメータは、適用される法律に基づいて結果に影響を与える可能性があります。

    • 形式: 2 文字の国コード（ISO 3166-1 alpha-2）。例: US、CA。

ツール呼び出しの手順:

  • 位置情報（重大）: 検索には十分な位置情報が含まれている必要があります。場所が曖昧な場合（「ピザ屋」など）、text_query で指定する必要があります（「ニューヨークのピザ屋」など）を指定するか、location_bias パラメータを使用します。曖昧さを解消するために、必要に応じて市区町村、都道府県、地域 / 国名を含めます。

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

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

任意の場所の現在の天気情報、1 時間ごとの予測、毎日の予測を提供します。天気に関するお問い合わせには、このツールを使用します。

利用可能な特定のデータ: 気温（現在、体感温度、最高/最低、暑さ指数）、風（風速、突風、風向）、天体現象（日の出/日没、月相）、降水（種類、確率、量/QPF）、大気条件（UV 指数、湿度、雲量、雷雨の確率）、ジオコード化された位置情報。

入力要件（重大）:

  • 現在の状況: 場所（市区町村や住所など）のみが必要です。日付や時間は指定しないでください。

  • 1 時間ごとの天気予報: 位置情報と時間（0 ～ 23）が必要です。ユーザーが特定の時刻の天気や、「数時間後」や「今日の午後」などの用語を使用して天気を尋ねた場合に使用します。

  • 日次の天気予報: 場所と日付全体が必要です。

日付の処理（重大）: ユーザーが指定した日付と時刻は、リクエストされた地域のローカル タイムゾーンで提供されなければなりません。日付は、年、月、日という個別の整数パラメータに分割しなければなりません。これらのパラメータに必要な形式は {"year": , "month": , "day": } です。
compute_routes

指定された出発地と目的地の間の移動ルートを計算します。サポートされている移動手段: DRIVE（デフォルト）、WALK。

入力要件（重大）: 出発地と目的地の両方が必要です。それぞれを次のいずれかの方法で、それぞれのフィールド内にネストして指定する必要があります。

  • address:（文字列、例: 「エッフェル塔、パリ」）。注: 入力する住所が詳細であるほど、より正確な結果が得られます。

  • lat_lng:（オブジェクト、{"latitude": number, "longitude": number}）

  • place_id:（文字列、例: 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'）注: この ID は search_places ツールから取得できます。入力タイプの任意の組み合わせが許可されます（例: 発信元はアドレス、宛先は lat_lng）。出発地または目的地のいずれかが欠落している場合は、ツールを呼び出す前に必ずユーザーに確認してください。

ツール呼び出しの例: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}