ツールリファレンス

全 42 ツールの引数、既定値、制約、実行例を網羅しています。MCP と CLI から同じインターフェースを利用できます。

呼び出し規約

実行例は MCP の引数オブジェクトです。MCP の tools/call を直接呼ぶ場合は、name にツール名、arguments にオブジェクトを指定します。ホストがツール名に接頭辞を付ける場合があります。以下の同等の CLI 呼び出しは mcp-gmap-rs call TOOL --args JSON を使用します。

CLI オプションがあるのはトップレベルの引数だけです。入れ子のオブジェクトと配列は JSON で渡します。値を省略した真偽値オプションは true、--flag false は false を意味します。不明なプロパティは拒否されます。tools または schema TOOL でインストール済みバージョンを確認してください。

Google の認証情報と言語はプロセスの設定であり、ツールの引数ではありません。経路に正確な座標を使うと住所解決を回避できます。名前付きの場所では Geocoding 用 API キーも必要になる場合があります。認証と設定を参照してください。

呼び出しには Google の料金が発生する場合があります。ツールが成功しても、複合結果や行列の結果には項目別のエラーが含まれる場合があります。Google のソースリンク、レビュー・写真の著者、AI 要約の開示情報を保持してください。実行例は入力を示すもので、現在の対応地域や結果を保証しません。

型、必須項目、スキーマの範囲は、実行ファイルのスキーマから生成したリファレンスに基づきます。既定値、結果の説明、項目間の制約は実装と照合しています。Google 側で追加の対応地域や割り当て制限が課される場合があります。

未知のトップレベル引数は拒否されます。ネイティブ API の本文は Google のフィールドを受け入れ、Google が検証します。変更操作は自動再試行されません。

ツール

• maps_geocode
• maps_validate_address
• maps_pollen
• maps_area_insights
• maps_snap_to_roads
• maps_nearest_roads
• maps_reverse_geocode
• maps_search_places
• maps_search_nearby
• maps_place_details
• maps_directions
• maps_distance_matrix
• maps_elevation
• maps_timezone
• maps_weather
• maps_air_quality
• maps_static_map
• maps_batch_geocode
• maps_explore_area
• maps_plan_route
• maps_compare_places
• maps_search_along_route
• maps_local_rank_tracker
• maps_speed_limits
• maps_autocomplete
• maps_geolocate
• maps_solar
• maps_aerial_view
• maps_render_aerial_video
• maps_map_tiles
• maps_streetview
• maps_streetview_publish
• maps_datasets
• maps_route_optimization
• maps_air_quality_forecast
• maps_air_quality_history
• maps_air_quality_heatmap
• maps_pollen_heatmap
• maps_weather_history
• maps_weather_alerts
• maps_weather_minute_forecast
• maps_weather_map

maps_geocode

住所・ランドマークを座標に変換します。

住所・ランドマークを最初の Geocoding 一致結果へ解決し、再利用できる座標と場所 ID を取得します。郵便の配達可能性は検証しません。

CLI コマンド: geocode. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
address / --address	文字列; 最低 1 文字	はい	—	ジオコーディングする住所・都市・ランドマーク。

動作と制約

• 一致なしは空の成功結果ではなくツールエラーです。
• この直接ツールは Geocoding v3 を使います。Places へのフォールバックは場所解決を行う複合ツール用で、この呼び出しでは使いません。

結果

location.lat、location.lng、formatted_address、place_id を持つオブジェクトです。最初の結果だけを返します。

実行例

MCP 引数:

{
  "address": "Eiffel Tower, Paris, France"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_geocode --args '{"address":"Eiffel Tower, Paris, France"}'

maps_validate_address

郵便住所を検証・標準化し、Google の判定、修正、構成要素、座標を返します。配送の保証ではありません。

郵便住所の構成要素を検証し、修正、標準化住所、Google の判定を返します。判定と未解決要素を呼び出し側に表示してください。

CLI コマンド: validate-address. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
addressLines / --address-lines	文字列の配列; 1–10 項目; 各項目は最低 1 文字	はい	—	順序付きの 1 行以上の郵便住所。
administrativeArea / --administrative-area	文字列; 最低 1 文字	いいえ	未指定	州・県など対応する行政区域。
enableUspsCass / --enable-usps-cass	真偽値	いいえ	false	USPS CASS 処理を要求します。この実装では true の場合 regionCode が US または PR である必要があります。
locality / --locality	文字列; 最低 1 文字	いいえ	未指定	都市または地域。
postalCode / --postal-code	文字列; 最低 1 文字	いいえ	未指定	郵便番号・ZIP コード。
regionCode / --region-code	文字列; パターン： ^[A-Z]{2}$	いいえ	未指定。Google が推測する場合があります	大文字 2 文字の国・地域コード。住所の曖昧さを避けるため指定を推奨します。
sessionToken / --session-token	文字列; 最低 1 文字	いいえ	未指定。Autocomplete セッションを終了しない	任意の呼び出し元管理 Autocomplete セッショントークン。URL 安全 ASCII 最大 36 文字。先行する候補要求と同じ値で適格セッションを終了。同じ Cloud プロジェクトの認証を使い、終了後は新規トークンにします。

動作と制約

• 検証判定は配送を保証しません。
• 地域・API の対応範囲は異なります。検証フィードバックの送信や修正の自動承認は行いません。

結果

通常 result.verdict、result.address、result.geocode、responseId を含む完全な検証応答です。利用できない項目は省略される場合があります。

実行例

MCP 引数:

{
  "addressLines": [
    "5 Avenue Anatole France"
  ],
  "regionCode": "FR",
  "locality": "Paris",
  "postalCode": "75007"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_validate_address --args '{"addressLines":["5 Avenue Anatole France"],"regionCode":"FR","locality":"Paris","postalCode":"75007"}'

maps_pollen

正確な座標の 1–5 日分の花粉予報、指数、健康上の助言を取得します。対応範囲は場所・季節によります。

正確な座標の日別短期花粉予報を取得し、花粉タイプ、指数、植物情報、提供者の助言を保持します。

CLI コマンド: pollen. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
days / --days	整数; 1–5	いいえ	1	要求する日別予報の件数。
latitude / --latitude	数値; -90.0–90.0	はい	—	WGS84 の緯度（十進度）。北が正です。
longitude / --longitude	数値; -180.0–180.0	はい	—	WGS84 の経度（十進度）。東が正です。
plantsDescription / --plants-description	真偽値	いいえ	false	利用可能な場合に植物の詳細説明と関連情報を含めます。

動作と制約

• ページサイズ 5 で要求し、ツールの最大 5 日分を収容します。追加ページは自動取得しません。
• 利用可能性は場所、季節、Google の対応範囲によります。

結果

regionCode、dailyInfo、任意の nextPageToken を含む元の Pollen 応答です。日ごとに花粉タイプや植物情報を含みます。

実行例

MCP 引数:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "days": 3,
  "plantsDescription": false
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_pollen --args '{"latitude":48.8584,"longitude":2.2945,"days":3,"plantsDescription":false}'

maps_area_insights

Places Aggregate で円・地域・多角形内の場所を集計します。100 件以下では ID を取得でき、詳細は自動照会しません。

Places Aggregate で円・地域・多角形内の一致する場所を集計します。限定された Places 検索ページの件数でなく集計クエリです。

CLI コマンド: area-insights. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
area / --area	オブジェクト	はい	—	circle、region、customArea のうちちょうど 1 つ。
area.circle	オブジェクト	いいえ	未指定	円形領域。region・customArea と排他的です。
area.circle.latLng	オブジェクト	親オブジェクトを指定した場合に必須	—	円の中心の正確な座標。
area.circle.latLng.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
area.circle.latLng.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。
area.circle.radius	整数; 23–50000	親オブジェクトを指定した場合に必須	—	円の半径（メートル）。
area.customArea	オブジェクト	いいえ	未指定	カスタム多角形領域。circle・region と排他的です。
area.customArea.polygon	オブジェクト	親オブジェクトを指定した場合に必須	—	多角形の境界。
area.customArea.polygon.coordinates	オブジェクトの配列; 4–1000 項目	親オブジェクトを指定した場合に必須	—	順序付き座標オブジェクトのリング。始点・終点は一致する必要があります。
area.customArea.polygon.coordinates[].latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
area.customArea.polygon.coordinates[].longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。
area.region	オブジェクト	いいえ	未指定	Google の場所リソースで識別する行政・地理領域。
area.region.place	文字列; パターン： ^places/[A-Za-z0-9_-]+$	親オブジェクトを指定した場合に必須	—	自由記述の地域名でなく places/PLACE_ID 形式の領域リソース。
excludedTypes / --excluded-types	文字列の配列; 1–50 項目; 各項目は最低 1 文字	いいえ	除外タイプの制限なし	除外する Google 場所タイプ。
includePlaces / --include-places	真偽値	いいえ	false	件数に加えて一致する場所リソース ID を要求します。
includedTypes / --included-types	文字列の配列; 1–50 項目; 各項目は最低 1 文字	はい	—	対象に含める Google 場所タイプ。例：restaurant、cafe。
maxRating / --max-rating	数値; 1.0–5.0	いいえ	評価の上限なし	境界を含む評価上限。
minRating / --min-rating	数値; 1.0–5.0	いいえ	評価の下限なし	境界を含む評価下限。maxRating を超えられません。
operatingStatus / --operating-status	文字列の配列; 1–3 項目; 値： OPERATING_STATUS_OPERATIONAL, OPERATING_STATUS_PERMANENTLY_CLOSED, OPERATING_STATUS_TEMPORARILY_CLOSED	いいえ	Google は既定で事業を継続している場所（operational）を対象にします	Google の事業の稼働状態フィルタ。開店時間や openNow のフィルタではありません。
priceLevels / --price-levels	文字列の配列; 1–5 項目; 値： PRICE_LEVEL_FREE, PRICE_LEVEL_INEXPENSIVE, PRICE_LEVEL_MODERATE, PRICE_LEVEL_EXPENSIVE, PRICE_LEVEL_VERY_EXPENSIVE	いいえ	すべての価格帯	許可する価格帯。

動作と制約

• 領域形式はちょうど 1 種類指定します。CLI の入れ子オブジェクトは JSON で、子項目に個別オプションはありません。
• 多角形リングは閉じる必要があります。Google は形状、対応タイプ、面積、対応地域も確認します。
• 場所 ID は件数が 100 以下の場合のみ取得できます。Place Details は自動要求しません。

結果

count（通常は int64 文字列）と、ID を要求して取得できた場合の placeInsights[].place リソースを含む Google 応答です。

実行例

MCP 引数:

{
  "area": {
    "circle": {
      "latLng": {
        "latitude": 48.8584,
        "longitude": 2.2945
      },
      "radius": 500
    }
  },
  "includedTypes": [
    "restaurant"
  ],
  "minRating": 4
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_area_insights --args '{"area":{"circle":{"latLng":{"latitude":48.8584,"longitude":2.2945},"radius":500}},"includedTypes":["restaurant"],"minRating":4}'

maps_snap_to_roads

2–100 点の順序付き GPS を道路に合わせます。点間は約 300 メートル以内を推奨し、補間で形状を追加できます。

順序付き GPS 軌跡を最も可能性の高い道路形状に対応付けます。独立した点には走行経路としてでなく Nearest Roads を使ってください。

CLI コマンド: snap-to-roads. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
interpolate / --interpolate	真偽値	いいえ	false	指定点の間に道路の中間形状を追加します。
path / --path	オブジェクトの配列; 2–100 項目	はい	—	移動順の GPS 座標オブジェクト。
path[].latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
path[].longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。

動作と制約

• 良好な対応付けのため、連続する点の間隔は約 300 メートル以内にします。
• 補間点は originalIndex がない場合があります。このツールは速度制限を要求しません。

結果

snappedPoints と任意の warningMessage を含む元の Roads 応答です。提供される道路の placeId、location、originalIndex を保持します。

実行例

MCP 引数:

{
  "path": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ],
  "interpolate": true
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_snap_to_roads --args '{"path":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}],"interpolate":true}'

maps_nearest_roads

1–100 個の独立 GPS 点の最寄り道路区間を探し、Google の originalIndex と道路の場所 ID を保持します。

独立 GPS 点に近い道路区間を検索し、1 本の連続した軌跡としては解釈しません。

CLI コマンド: nearest-roads. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
points / --points	オブジェクトの配列; 1–100 項目	はい	—	対応付ける独立した座標オブジェクト。
points[].latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
points[].longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。

動作と制約

• 1 点が複数道路区間に一致する場合があります。1 入力 1 出力と仮定せず originalIndex を保持します。
• このツールは速度制限を要求しません。

結果

snappedPoints、道路の placeId、location、入力点への対応を示す originalIndex を含む元の Roads 応答です。

実行例

MCP 引数:

{
  "points": [
    {
      "latitude": -35.27801,
      "longitude": 149.12958
    },
    {
      "latitude": -35.28032,
      "longitude": 149.12907
    }
  ]
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_nearest_roads --args '{"points":[{"latitude":-35.27801,"longitude":149.12958},{"latitude":-35.28032,"longitude":149.12907}]}'

maps_reverse_geocode

座標を住所に変換します。

正確な座標を最初の逆 Geocoding 結果に変換します。整形済み住所だけで足りない場合は構成要素を使ってください。

CLI コマンド: reverse-geocode. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
latitude / --latitude	数値; -90.0–90.0	はい	—	WGS84 の緯度（十進度）。北が正です。
longitude / --longitude	数値; -180.0–180.0	はい	—	WGS84 の経度（十進度）。東が正です。

動作と制約

• 最初の結果だけを返します。一致なしはツールエラーです。

結果

最初のネイティブ Geocoding 結果で、利用できる formatted_address、address_components、geometry、place_id を含みます。

実行例

MCP 引数:

{
  "latitude": 48.8584,
  "longitude": 2.2945
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_reverse_geocode --args '{"latitude":48.8584,"longitude":2.2945}'

maps_search_places

Places (New) をテキスト検索し、場所・評価フィルターを任意に指定します。

Places (New) をテキストと任意の場所・評価・タイプで検索し、返された ID で必要な詳細だけを取得します。

CLI コマンド: search-places. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
includedType / --included-type	文字列; 最低 1 文字	いいえ	タイプによる制限なし	Google 場所タイプ。例：cafe。
locationBias / --location-bias	オブジェクト	いいえ	場所のバイアスなし	任意の円形検索バイアス。厳密な地理制限ではありません。
locationBias.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
locationBias.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。
locationBias.radius	数値; 0.1–50000.0	いいえ	5000	バイアス半径（メートル）。
minRating / --min-rating	数値; 0.0–5.0	いいえ	評価による制限なし	Google に要求する最低ユーザー評価。
openNow / --open-now	真偽値	いいえ	営業状態の制限なし	true の場合は現在営業中の場所に制限します。
query / --query	文字列; 最低 1 文字	はい	—	自然言語の場所クエリ。

動作と制約

• 20 件の 1 ページを要求し、ページトークンを返したり追跡したりしません。
• 営業状態・評価の欠損は Google の対応範囲によります。網羅的な一覧とは解釈しないでください。

結果

最大 20 件の Google Place オブジェクト配列。選択した検索フィールド、Maps・ソースリンク、帰属メタデータを含みます。

実行例

MCP 引数:

{
  "query": "coffee near Gare de Lyon, Paris",
  "openNow": true,
  "minRating": 4
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_search_places --args '{"query":"coffee near Gare de Lyon, Paris","openNow":true,"minRating":4}'

maps_search_nearby

住所・正確な座標の周辺を場所タイプ、評価、営業状態で絞り込みます。

解決済み中心の限定半径内で場所を探します。テキスト検索と異なり、厳密な円形の場所制限を使います。

CLI コマンド: search-nearby. Google の認証: Places は API キーまたは OAuth に対応します。住所・ランドマークの中心点は Geocoding の解決に API キーも必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
center / --center	オブジェクト	はい	—	中心の入力とその解釈方法の指定。
center.isCoordinates	真偽値	いいえ	false	value を正確な座標として扱い、ジオコーディングしません。
center.value	文字列; 最低 1 文字	親オブジェクトを指定した場合に必須	—	住所・ランドマーク、または isCoordinates が true の場合の latitude,longitude 文字列。
keyword / --keyword	文字列; 最低 1 文字	いいえ	タイプによる制限なし	includedTypes として渡す Google 場所タイプ（例：cafe）。自由なテキストキーワードではありません。
minRating / --min-rating	数値; 0.0–5.0	いいえ	評価による制限なし	返された場所にローカルで適用する最低評価。
openNow / --open-now	真偽値	いいえ	false	currentOpeningHours.openNow が true の結果だけを残します。
radius / --radius	数値; 0.1–50000.0	いいえ	1000	検索半径（メートル）。

動作と制約

• 絞り込み時、営業状態不明は営業中とせず、評価なしは 0 と扱います。
• 住所の中心点は場所解決が必要で、座標なら追加呼び出しを回避できます。

結果

最大 20 件の選択した Place オブジェクト配列です。ローカルの営業状態・評価フィルターでさらに減る場合があります。

実行例

MCP 引数:

{
  "center": {
    "value": "48.8584,2.2945",
    "isCoordinates": true
  },
  "keyword": "cafe",
  "radius": 500
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_search_nearby --args '{"center":{"value":"48.8584,2.2945","isCoordinates":true},"keyword":"cafe","radius":500}'

maps_place_details

場所の詳細、レビュー、帰属情報を取得します。任意の写真 URL に著者を保持し、内容とともに出典・開示を表示します。

既知の場所 ID から選択した詳細、レビュー、任意の写真 URL を取得します。著者・ソース情報と AI 開示文を保持してください。

CLI コマンド: place-details. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
maxPhotos / --max-photos	整数; 0–10	いいえ	0	実行する写真メディア URL 検索の最大数。
placeId / --place-id	文字列; 最低 1 文字	はい	—	Google 場所 ID。places/ 接頭辞は任意です。
sessionToken / --session-token	文字列; 最低 1 文字	いいえ	未指定。Autocomplete セッションを終了しない	任意の呼び出し元管理 Autocomplete セッショントークン。URL 安全 ASCII 最大 36 文字。先行する候補要求と同じ値で適格セッションを終了。同じ Cloud プロジェクトの認証を使い、終了後は新規トークンにします。

動作と制約

• 選択した写真ごとに追加リクエストが生じる場合があり、0 枚なら回避できます。
• 固定の詳細フィールドマスクを使い、全 Google Place フィールドは要求しません。利用できない項目は省略される場合があります。

結果

要求したフィールドマスクに対応するネイティブ Google Place オブジェクト。写真要求時の photoUrls はメディア URL、写真著者の帰属、ソースリンクを含みます。

実行例

MCP 引数:

{
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "maxPhotos": 1
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_place_details --args '{"placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","maxPhotos":1}'

maps_directions

2 地点間の経路、案内手順、距離・時間の合計を取得します。

2 つの端点間の経路を計算し、選択した Google 経路データと正規化した合計を提供します。

CLI コマンド: directions. Google の認証: Routes・Places は API キーまたは OAuth に対応します。場所名の解決には Geocoding の API キーも必要ですが、正確な座標文字列で回避できます。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
arrival_time / --arrival-time	文字列; 最低 1 文字	いいえ	未指定	希望到着時刻。タイムゾーン付き RFC 3339 で、公共交通のみです。
avoid_highways / --avoid-highways	真偽値	いいえ	false	高速道路を避けます。true は運転時のみ対応します。
avoid_tolls / --avoid-tolls	真偽値	いいえ	false	有料道路を避けます。true は運転時のみ対応します。
departure_time / --departure-time	文字列; 最低 1 文字	いいえ	未指定	出発時刻。Z または明示的な UTC オフセットを持つ RFC 3339 形式です。
destination / --destination	文字列; 最低 1 文字	はい	—	目的地の住所・ランドマークまたは正確な latitude,longitude 文字列。
mode / --mode	文字列; 値： driving, walking, bicycling, transit	いいえ	driving	移動方法。運転では交通状況を考慮した経路を使います。
origin / --origin	文字列; 最低 1 文字	はい	—	出発地の住所・ランドマークまたは正確な latitude,longitude 文字列。
polylineQuality / --polyline-quality	文字列; 値： OVERVIEW, HIGH_QUALITY	いいえ	trafficSegments=true なら HIGH_QUALITY、それ以外は Google 既定の OVERVIEW	形状品質。OVERVIEW または HIGH_QUALITY。明示指定が常に優先され、trafficSegments=true と OVERVIEW の併用も可能です。点の密度と交通計算は独立しています。
trafficSegments / --traffic-segments	真偽値	いいえ	false	自動車運転のみの任意の真偽値。TRAFFIC_ON_POLYLINE と ENCODED_POLYLINE を要求し、polylineQuality の明示指定がなければ HIGH_QUALITY を使います。交通付きポリラインは高料金の Compute Routes Enterprise SKU を発生させるため、区間詳細が不要なら false のままにします。

動作と制約

• departure_time と arrival_time は同時指定できません。arrival_time は公共交通のみです。
• 回避オプションは運転が必要です。Google は移動方法・時刻・地域の追加制限も適用します。
• 利用可能な経路がなければ明示的なエラーです。
• trafficSegments=true では Routes が NORMAL、SLOW、TRAFFIC_JAM の交通範囲を返します。経路・各区間の正規化セグメントは、それぞれ固有のポリラインと独立した点インデックスを使用します。Google の範囲は [start,end) ですが、形状には共有する終了境界の頂点を残し、最後の辺を含めます。範囲の欠落・不正は明示し、通常の交通と推測して補完しません。
• segmentMetadata.retrievedAt はローカルで応答を取得した時刻で、提供者による交通観測時刻ではありません。Routes は観測時刻を返さないため trafficObservedAt は null。この Routes 応答は道路分類・制限速度も返さないため roadCategory・speedLimit は null。暗黙の Roads 呼び出しやクライアント側の所要時間倍率は使用せず、時間は Google の予測値を保持します。
• 交通セグメントは明示的な指定が必要で、この実装では自動車運転のみです。交通付きポリラインを要求し、Compute Routes Enterprise 課金が発生します。交通範囲の仕様、現在の SKU 発生条件。
• polylineQuality は Google が返す形状の細かさを選択します。HIGH_QUALITY は点数・応答サイズが増え、遅延も増える場合があります。trafficSegments=true でも OVERVIEW を明示指定できます。品質省略時は交通セグメントに HIGH_QUALITY、それ以外に Google 既定の OVERVIEW を使用。プログラムが詳細を合成・補間することはありません。品質は extraComputations と独立しており、HIGH_QUALITY だけでは TRAFFIC_ON_POLYLINE は有効になりません。PolylineQuality の公式定義。

公式の出典: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

結果

routes、summary、total_distance（メートル）、total_duration（秒）、任意の最適化インデックスを持つオブジェクト。経路は選択した区間、手順、ポリライン、警告を含みます。 trafficSegments=true の場合、経路と各区間に正規化した segments と segmentMetadata も含まれます。

実行例

MCP 引数:

{
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_directions --args '{"origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking"}'

maps_distance_matrix

各出発地・目的地間の距離と所要時間を比較し、セル単位の失敗を保持します。

出発地・目的地の全組み合わせで距離と時間を比較します。応答成功を完全な結果とみなさず、各セルとエラーを確認してください。

CLI コマンド: distance-matrix. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
avoid_highways / --avoid-highways	真偽値	いいえ	false	高速道路を避けます。true は運転時のみ対応します。
avoid_tolls / --avoid-tolls	真偽値	いいえ	false	有料道路を避けます。true は運転時のみ対応します。
departure_time / --departure-time	文字列; 最低 1 文字	いいえ	未指定	出発時刻。Z または明示的な UTC オフセットを持つ RFC 3339 形式です。
destinations / --destinations	文字列の配列; 1–50 項目; 各項目は最低 1 文字	はい	—	目的地の文字列。住所または正確な latitude,longitude の組。
mode / --mode	文字列; 値： driving, walking, bicycling, transit	いいえ	driving	移動方法。運転では交通状況を考慮した経路を使います。
origins / --origins	文字列の配列; 1–50 項目; 各項目は最低 1 文字	はい	—	出発地の文字列。住所または正確な latitude,longitude の組。

動作と制約

• 出発地 × 目的地は最大 625 組、公共交通では最大 100 組です。
• 座標でない出発地・目的地文字列の合計は最大 50 件です。配列別のスキーマ上限は合算上限に優先しません。
• 有料道路・高速道路の回避は運転のみです。このツールは arrival_time を公開しません。
• 行列の HTTP リクエスト 1 回でも複数要素に課金される場合があります。

結果

origin_addresses、destination_addresses、行優先の distances・durations、errors 配列を持つオブジェクト。成功セルはメートル・秒で、失敗・欠損は null のままです。

実行例

MCP 引数:

{
  "origins": [
    "48.8584,2.2945"
  ],
  "destinations": [
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_distance_matrix --args '{"origins":["48.8584,2.2945"],"destinations":["48.8606,2.3376","48.8530,2.3499"],"mode":"walking"}'

maps_elevation

正確な座標の標高を取得します。

正確な座標点の地理的な高さを取得します。

CLI コマンド: elevation. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
locations / --locations	オブジェクトの配列; 1–512 項目	はい	—	標高を要求する座標オブジェクト。
locations[].latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
locations[].longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。

動作と制約

• Google が返すデータを標高単位の変換なしで返します。

結果

ネイティブ Elevation の results 配列。メートル単位の elevation、location、resolution を含む場合があります。

実行例

MCP 引数:

{
  "locations": [
    {
      "latitude": 48.8584,
      "longitude": 2.2945
    }
  ]
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_elevation --args '{"locations":[{"latitude":48.8584,"longitude":2.2945}]}'

maps_timezone

指定した場所と時刻のタイムゾーン、UTC オフセット、現地時刻を取得します。

指定時点のタイムゾーン ID と UTC・夏時間オフセットを解決し、現地タイムスタンプを求めます。

CLI コマンド: timezone. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
latitude / --latitude	数値; -90.0–90.0	はい	—	WGS84 の緯度（十進度）。北が正です。
longitude / --longitude	数値; -180.0–180.0	はい	—	WGS84 の経度（十進度）。東が正です。
timestamp / --timestamp	整数; 0–253402300799999	いいえ	現在の UTC 時刻（ミリ秒）	Unix エポックのミリ秒で、秒ではありません。

動作と制約

• 要求時にミリ秒を整数秒へ変換し、秒未満の精度は保持しません。
• 現地時刻は要求時点に返された標準・夏時間オフセットから求めます。

結果

timeZoneId、timeZoneName、秒単位の rawOffset・dstOffset と、RFC 3339 の算出済み localTime などを返します。

実行例

MCP 引数:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "timestamp": 1793448000000
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_timezone --args '{"latitude":48.8584,"longitude":2.2945,"timestamp":1793448000000}'

maps_weather

現在・日別・時間別の天気を取得し、Google の単位とページ情報を保持します。

正確な座標の現在の気象または日別・時間別予報の 1 ページを要求します。

CLI コマンド: weather. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
forecastDays / --forecast-days	整数; 1–10	いいえ	5	要求する日別予報の長さ。forecast_daily のみで使用します。
forecastHours / --forecast-hours	整数; 1–240	いいえ	24	要求する時間別予報の長さ。forecast_hourly のみで使用します。
latitude / --latitude	数値; -90.0–90.0	はい	—	WGS84 の緯度（十進度）。北が正です。
longitude / --longitude	数値; -180.0–180.0	はい	—	WGS84 の経度（十進度）。東が正です。
type / --type	文字列; 値： current, forecast_daily, forecast_hourly	いいえ	current	現在の気象、日別予報、時間別予報を選択します。

動作と制約

• forecastDays は日別以外で、forecastHours は forecast_hourly 以外で無視します。
• ページトークンは自動追跡しません。要求した期間が 1 ページの件数を超える場合があります。
• 対応地域と予報の利用可能性は Google によります。

結果

type に応じた現在の気象項目、forecastDays、forecastHours を持つネイティブ Weather 応答。単位、時刻、nextPageToken を保持してください。

実行例

MCP 引数:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "type": "forecast_daily",
  "forecastDays": 3
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_weather --args '{"latitude":48.8584,"longitude":2.2945,"type":"forecast_daily","forecastDays":3}'

maps_air_quality

現在の大気質指数、汚染物質濃度、健康上の助言を取得します。

現在の大気質指数と、任意の汚染物質濃度・提供者による健康上の助言を取得します。

CLI コマンド: air-quality. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
includeHealthRecommendations / --include-health-recommendations	真偽値	いいえ	true	Google の健康上の助言の算出を要求します。
includePollutants / --include-pollutants	真偽値	いいえ	false	汚染物質濃度を要求します。
latitude / --latitude	数値; -90.0–90.0	はい	—	WGS84 の緯度（十進度）。北が正です。
longitude / --longitude	数値; -180.0–180.0	はい	—	WGS84 の経度（十進度）。東が正です。

動作と制約

• 助言は提供者のデータであり、個別の医療評価ではありません。
• 現在の状況のみを公開し、履歴・予報エンドポイントは提供しません。

結果

指数と、Google が提供する場合の任意の healthRecommendations・pollutants を含むネイティブ Air Quality 現況応答です。

実行例

MCP 引数:

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "includePollutants": true
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_air_quality --args '{"latitude":48.8584,"longitude":2.2945,"includePollutants":true}'

maps_static_map

中心点、マーカー、経路を PNG 地図に描画します。

任意のマーカー・経路仕様で PNG 地図を描画します。

CLI コマンド: static-map. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
center / --center	文字列; 最低 1 文字	いいえ	未指定	中心の住所または latitude,longitude 文字列。
maptype / --maptype	文字列; 値： roadmap, satellite, terrain, hybrid	いいえ	roadmap	ベースマップのスタイル。
markers / --markers	文字列の配列; 1–100 項目; 各項目は最低 1 文字	いいえ	マーカーなし	繰り返し指定する Google Static Maps マーカー仕様。例：color:red|48.8584,2.2945。
path / --path	文字列の配列; 1–100 項目; 各項目は最低 1 文字	いいえ	経路なし	繰り返し指定する Google Static Maps 経路仕様。例：color:blue|48.8584,2.2945|48.8606,2.3376。
size / --size	文字列; パターン： ^[1-9][0-9]{0,2}x[1-9][0-9]{0,2}$	いいえ	600x400	ピクセル寸法 WIDTHxHEIGHT。実行時は各辺 1–640 に制限します。
zoom / --zoom	整数; 0–21	いいえ	省略。Google が選択または推測します	明示的なズームレベル。

動作と制約

• center、markers、path のうち最低 1 つが必要です。
• 要求 URL 全体は 16,384 文字以内です。スキーマの size パターンは実行時の 640 ピクセル制限より広い範囲を許容します。
• マーカー・経路のスタイルは Google Static Maps の構文に従います。画像内の Google 帰属表示は保持されます。

結果

MCP はインライン image/png を返します。CLI は {mimeType,base64} JSON、--output 指定時は生の PNG バイト列です。

実行例

MCP 引数:

{
  "center": "48.8584,2.2945",
  "zoom": 14,
  "size": "320x240",
  "markers": [
    "color:red|48.8584,2.2945"
  ]
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_static_map --args '{"center":"48.8584,2.2945","zoom":14,"size":"320x240","markers":["color:red|48.8584,2.2945"]}'

maps_batch_geocode

最大 50 住所を一括解決し、入力順と住所別エラーを保持します。

上限付き住所一覧をジオコーディングし、入力順と各項目の成否を保持します。

CLI コマンド: batch-geocode. Google の認証: この実装では API キーが必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
addresses / --addresses	文字列の配列; 1–50 項目; 各項目は最低 1 文字	はい	—	解決する住所・ランドマークの文字列。

動作と制約

• プロセスあたり最大 5 件の Google リクエストで並行数を制限します。
• 項目の失敗は CLI の非ゼロ終了を強制しません。各行の success・error を確認してください。

結果

入力順の配列。各行に address、success と、data（ジオコードオブジェクト）または error があります。

実行例

MCP 引数:

{
  "addresses": [
    "Paris, France",
    "London, UK"
  ]
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_batch_geocode --args '{"addresses":["Paris, France","London, UK"]}'

maps_explore_area

場所を解決し、カテゴリごとに周辺を検索して上位結果の詳細を取得します。

1 か所を解決し、その周辺の指定カテゴリを検索して、カテゴリごとの上位結果だけを展開します。

CLI コマンド: explore-area. Google の認証: Places は API キーまたは OAuth に対応します。場所名には Geocoding の API キーも必要です。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
location / --location	文字列; 最低 1 文字	はい	—	住所・ランドマークまたは正確な latitude,longitude 文字列。
radius / --radius	数値; 0.1–50000.0	いいえ	1000	カテゴリ検索の半径（メートル）。
topN / --top-n	整数; 1–20	いいえ	3	カテゴリごとに詳細を取得する場所の最大数。
types / --types	文字列の配列; 1–10 項目; 各項目は最低 1 文字	いいえ	restaurant, cafe, tourist_attraction	検索する Google 場所カテゴリ。

動作と制約

• カテゴリごとに最大 20 件を検索します。count は返されたページの件数で、集計総数ではありません。
• カテゴリ・詳細取得の失敗はトップレベルの成功出力内に残ります。
• 複数の Google リクエストを行うため、カテゴリと topN を必要範囲に絞ってください。

結果

解決済み location、radius、categories を持つオブジェクト。各カテゴリに type/count/top またはエラーがあり、展開した場所には details_error が入る場合があります。

実行例

MCP 引数:

{
  "location": "48.8584,2.2945",
  "types": [
    "cafe"
  ],
  "radius": 500,
  "topN": 1
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_explore_area --args '{"location":"48.8584,2.2945","types":["cafe"],"radius":500,"topN":1}'

maps_plan_route

2–27 立ち寄り点の経路を計画します。公共交通以外は 2–25 中間点を最適化でき、正確な座標を保持します。

順序付き立ち寄り点から 1 経路を計画します。始終点を固定し、中間点を Google に並べ替えさせることもできます。

CLI コマンド: plan-route. Google の認証: Routes・Places は API キーまたは OAuth に対応します。場所名の解決には Geocoding の API キーも必要ですが、正確な座標文字列で回避できます。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
avoid_highways / --avoid-highways	真偽値	いいえ	false	高速道路を避けます。true は運転時のみ対応します。
avoid_tolls / --avoid-tolls	真偽値	いいえ	false	有料道路を避けます。true は運転時のみ対応します。
departure_time / --departure-time	文字列; 最低 1 文字	いいえ	未指定	出発時刻。Z または明示的な UTC オフセットを持つ RFC 3339 形式です。
mode / --mode	文字列; 値： driving, walking, bicycling, transit	いいえ	driving	移動方法。運転では交通状況を考慮した経路を使います。
optimize / --optimize	真偽値	いいえ	true。ただし上記条件に従います	合計立ち寄り点が 3 点を超え、モードが transit 以外の場合に中間点の最適化を要求します。
polylineQuality / --polyline-quality	文字列; 値： OVERVIEW, HIGH_QUALITY	いいえ	trafficSegments=true なら HIGH_QUALITY、それ以外は Google 既定の OVERVIEW	形状品質。OVERVIEW または HIGH_QUALITY。明示指定が常に優先され、trafficSegments=true と OVERVIEW の併用も可能です。点の密度と交通計算は独立しています。
stops / --stops	文字列の配列; 2–27 項目; 各項目は最低 1 文字	はい	—	順序付き住所・ランドマークまたは正確な latitude,longitude 文字列。最初と最後は端点のままです。
trafficSegments / --traffic-segments	真偽値	いいえ	false	自動車運転のみの任意の真偽値。TRAFFIC_ON_POLYLINE と ENCODED_POLYLINE を要求し、polylineQuality の明示指定がなければ HIGH_QUALITY を使います。交通付きポリラインは高料金の Compute Routes Enterprise SKU を発生させるため、区間詳細が不要なら false のままにします。

動作と制約

• 公共交通は 2 端点だけに対応し、中間点は使えません。
• 最適化が有効なのは合計 4 点以上（中間点 2 つ以上）の場合だけです。
• 1 経路の順序最適化であり、車両群への車両・タスク割り当てではありません。
• trafficSegments=true では Routes が NORMAL、SLOW、TRAFFIC_JAM の交通範囲を返します。経路・各区間の正規化セグメントは、それぞれ固有のポリラインと独立した点インデックスを使用します。Google の範囲は [start,end) ですが、形状には共有する終了境界の頂点を残し、最後の辺を含めます。範囲の欠落・不正は明示し、通常の交通と推測して補完しません。
• segmentMetadata.retrievedAt はローカルで応答を取得した時刻で、提供者による交通観測時刻ではありません。Routes は観測時刻を返さないため trafficObservedAt は null。この Routes 応答は道路分類・制限速度も返さないため roadCategory・speedLimit は null。暗黙の Roads 呼び出しやクライアント側の所要時間倍率は使用せず、時間は Google の予測値を保持します。
• 交通セグメントは明示的な指定が必要で、この実装では自動車運転のみです。交通付きポリラインを要求し、Compute Routes Enterprise 課金が発生します。交通範囲の仕様、現在の SKU 発生条件。
• polylineQuality は Google が返す形状の細かさを選択します。HIGH_QUALITY は点数・応答サイズが増え、遅延も増える場合があります。trafficSegments=true でも OVERVIEW を明示指定できます。品質省略時は交通セグメントに HIGH_QUALITY、それ以外に Google 既定の OVERVIEW を使用。プログラムが詳細を合成・補間することはありません。品質は extraComputations と独立しており、HIGH_QUALITY だけでは TRAFFIC_ON_POLYLINE は有効になりません。PolylineQuality の公式定義。

公式の出典: https://developers.google.com/maps/billing-and-pricing/sku-details/routes, https://developers.google.com/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#PolylineQuality, https://developers.google.com/maps/documentation/routes/traffic_on_polylines

結果

mode、実際に適用した optimized、順序付き解決済み stops、表示用 legs、total_distance、total_duration、polyline、警告を持つオブジェクト。区間の durationSeconds は秒の数値です。 trafficSegments=true の場合、経路と各区間に正規化した segments と segmentMetadata も含まれます。

実行例

MCP 引数:

{
  "stops": [
    "48.8584,2.2945",
    "48.8606,2.3376",
    "48.8530,2.3499"
  ],
  "mode": "walking",
  "optimize": false
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_plan_route --args '{"stops":["48.8584,2.2945","48.8606,2.3376","48.8530,2.3499"],"mode":"walking","optimize":false}'

maps_compare_places

場所を検索し詳細を比較します。userLocation からの運転距離も任意で取得します。

少数の場所を検索・詳細化し、正確なユーザー座標からの運転距離を任意で比較します。

CLI コマンド: compare-places. Google の認証: Places と任意の Routes は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
limit / --limit	整数; 1–20	いいえ	5	詳細化する一致場所の最大数。
query / --query	文字列; 最低 1 文字	はい	—	Places のテキスト検索クエリ。
userLocation / --user-location	オブジェクト	いいえ	距離・時間の比較なし	任意の距離比較に使う正確なユーザー座標。
userLocation.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
userLocation.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。

動作と制約

• 移動の比較は運転固定で、移動方法を変更する引数はありません。
• 詳細・距離の失敗は残し、それ以外が使える場所を除外しません。
• 要求された候補だけを詳細化します。

結果

places と任意の distance_error を持つオブジェクト。場所は details/details_error、distance、drive_time、場所別 distance_errors を含む場合があります。

実行例

MCP 引数:

{
  "query": "cafes near Eiffel Tower, Paris",
  "userLocation": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "limit": 3
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_compare_places --args '{"query":"cafes near Eiffel Tower, Paris","userLocation":{"latitude":48.8584,"longitude":2.2945},"limit":3}'

maps_search_along_route

経路のエンコード済みポリラインで沿道の場所を検索します。

経路を計算し、そのエンコード済みポリラインを使って Places を検索します。1 回の円形検索で行程を近似しません。

CLI コマンド: search-along-route. Google の認証: Routes・Places は API キーまたは OAuth に対応します。場所名の解決には Geocoding の API キーも必要ですが、正確な座標文字列で回避できます。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
destination / --destination	文字列; 最低 1 文字	はい	—	経路の目的地住所・ランドマークまたは正確な latitude,longitude 文字列。
maxResults / --max-results	整数; 1–20	いいえ	5	応答ページに要求する Places 結果の最大数。
mode / --mode	文字列; 値： driving, walking, bicycling, transit	いいえ	walking	検索に用いる経路の移動方法。
origin / --origin	文字列; 最低 1 文字	はい	—	経路の出発地住所・ランドマークまたは正確な latitude,longitude 文字列。
textQuery / --text-query	文字列; 最低 1 文字	はい	—	カフェや充電所など経路途中の場所の Places クエリ。

動作と制約

• 既定は walking で、driving が既定の directions、matrix、plan-route とは異なります。
• 自動ページ取得や Place Details の展開は行いません。
• directions の出発・到着時刻や回避引数は公開しません。

結果

places、任意の routingSummaries、選択した Google 経路データと正規化合計を含む算出済み route を持つオブジェクト。

実行例

MCP 引数:

{
  "textQuery": "cafes",
  "origin": "48.8584,2.2945",
  "destination": "48.8606,2.3376",
  "mode": "walking",
  "maxResults": 3
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_search_along_route --args '{"textQuery":"cafes","origin":"48.8584,2.2945","destination":"48.8606,2.3376","mode":"walking","maxResults":3}'

maps_local_rank_tracker

1–3 キーワードの検索順位を地理グリッドで測り、ARP・ATRP・SoLV と点別エラーを返します。

地理グリッドの各点で、対象場所が Text Search の上位 20 件に現れるかと順位を測定します。

CLI コマンド: local-rank-tracker. Google の認証: 主 API は API キーまたは OAuth に対応します。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
center / --center	オブジェクト	はい	—	スキャングリッドの正確な中心。
center.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	—	WGS84 の緯度（十進度）。北が正です。
center.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	—	WGS84 の経度（十進度）。東が正です。
gridSize / --grid-size	整数; 3–7	いいえ	3	行数・列数。3–7 のすべての整数を受け入れます。
gridSpacing / --grid-spacing	数値; 100.0–10000.0	いいえ	1000	隣接グリッド点の間隔（メートル）。
keyword / --keyword	文字列; 最低 1 文字	いいえ	未指定	単一検索キーワード。keyword または keywords を使います。
keywords / --keywords	文字列の配列; 1–3 項目; 各項目は最低 1 文字	いいえ	未指定	1–3 の検索キーワード。両形式が指定された場合はこちらを優先します。
placeId / --place-id	文字列; 最低 1 文字	はい	—	対象の場所 ID。places/ 接頭辞は任意です。

動作と制約

• keyword または keywords の最低 1 つが必要です。各スキーマ行だけではこの選択条件は表せません。
• 検索要求数はキーワード数 × gridSize² で、再試行前に最大 147 件です。
• 失敗点は有効な未発見でなく、順位指標から除外します。有効な観測がなければ指標は null の場合があります。
• 検索順位はユーザーレビューの評価ではありません。結果はバイアス付きテキスト検索の標本であり、ユーザーの Google Maps 順位を保証しません。

結果

target、grid_size、grid_spacing_m、キーワード別メトリクス・グリッドを含むオブジェクト。ARP は発見順位の平均、ATRP は成功した未発見クエリを 21 位として扱い、SoLV は成功点のうち上位 3 位以内に入った点の百分率です。failed_points と found_in は観測範囲を示します。

実行例

MCP 引数:

{
  "keyword": "cafe",
  "placeId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
  "center": {
    "latitude": 48.8584,
    "longitude": 2.2945
  },
  "gridSize": 3,
  "gridSpacing": 500
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_local_rank_tracker --args '{"keyword":"cafe","placeId":"ChIJLU7jZClu5kcR4PcOOO6p3I0","center":{"latitude":48.8584,"longitude":2.2945},"gridSize":3,"gridSpacing":500}'

maps_speed_limits

GPS 経路または Roads 区間 ID から自動車の掲示速度制限を取得。Asset Tracking 許諾が必要で、Roads 有効化だけでは利用不可。

GPS 経路または Roads 区間 ID から自動車の掲示速度制限を取得。Asset Tracking 許諾が必要で、Roads 有効化だけでは利用不可。

CLI コマンド: speed-limits. Google の認証: この実装は API キーを使用。OAuth モードでも、このエンドポイントにはキーが必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
path / --path	オブジェクトの配列; 1–100 項目	いいえ	未指定	GPS 座標 1〜100 点。roadPlaceIds と排他。Google は先に経路を道路へ補正。
path[].latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	各経路点で必須	WGS84 緯度、−90〜90 度。
path[].longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	各経路点で必須	WGS84 経度、−180〜180 度。
roadPlaceIds / --road-place-ids	文字列の配列; 1–100 項目; 各項目は最低 1 文字	いいえ	未指定	道路補正・近傍道路が返す区間 ID を 1〜100 件。通常の店舗 ID には制限情報がない場合あり。path と排他。
units / --units	文字列; 値： KPH, MPH	いいえ	KPH	速度単位。KPH（km/時）または MPH（マイル/時）。

動作と制約

• Asset Tracking 権限が必要。移行済み Premium プロジェクトの一部は権限を保持。一般の課金アカウントは許諾を意味しません。https://developers.google.com/maps/documentation/roads/speed-limits
• 返される speedLimits ごとに課金され、1 要求で複数件になる場合あり。可変制限は自動車の最大値。リアルタイムではなく欠損・推定・陳腐化の可能性があり、現地標識を優先。
• 403 は秘匿処理後の Google 理由とアクセスの手掛かりを保持。API・キー制約・権限も原因になるため、すべてを許諾エラーとは判定しません。

公式の出典: https://developers.google.com/maps/documentation/roads/speed-limits

結果

speedLimits、任意の snappedPoints、警告、メタデータを含む完全なネイティブ応答。

実行例

MCP 引数:

{
  "roadPlaceIds": [
    "ChIJs5ydyTiuEmsR0fRSlU0C7k0"
  ],
  "units": "KPH"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_speed_limits --args '{"roadPlaceIds":["ChIJs5ydyTiuEmsR0fRSlU0C7k0"],"units":"KPH"}'

maps_autocomplete

入力中の Places API (New) 地点・検索語候補を取得。位置優先・制限、種別、カーソル位置、呼び出し元管理の課金セッションに対応。

入力中の Places API (New) 地点・検索語候補を取得。位置優先・制限、種別、カーソル位置、呼び出し元管理の課金セッションに対応。

CLI コマンド: autocomplete. Google の認証: API キーまたは cloud-platform スコープの OAuth。サービスアカウントには API 有効化とクォータ側の serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
includeFutureOpeningBusinesses / --include-future-opening-businesses	真偽値	いいえ	false	今後開業予定の事業者を含む。
includePureServiceAreaBusinesses / --include-pure-service-area-businesses	真偽値	いいえ	false	公開店舗を持たず、訪問・配達でサービスを行う事業者を含む。
includeQueryPredictions / --include-query-predictions	真偽値	いいえ	false	地点候補に加えて検索語候補も返す。
includedPrimaryTypes / --included-primary-types	文字列の配列; 0–5 項目; 各項目は最低 1 文字	いいえ	すべての種別	主要種別を最大 5 件。(cities)・(regions) は単独指定。
includedRegionCodes / --included-region-codes	文字列の配列; 0–15 項目	いいえ	すべての地域	2 文字 CLDR 地域コード最大 15 件。位置制限との共通範囲。空配列は制限なし。
input / --input	文字列; 最低 1 文字	はい	—	空でない検索文字列。場所名・住所の一部も可。
inputOffset / --input-offset	整数; 0–4294967295	いいえ	入力の末尾	0 始まりの Unicode 文字位置。input の文字数以下。
languageCode / --language-code	文字列; 最低 1 文字	いいえ	設定済み GOOGLE_MAPS_LANGUAGE	希望する IETF BCP-47 応答言語。複数言語が混ざる場合あり。
locationBias / --location-bias	オブジェクト	いいえ	位置指定がどちらもなければ Google の IP 優先	円または矩形の周辺を優先。範囲外も可。locationRestriction と排他。
locationBias.circle	オブジェクト	いいえ	未指定	円形範囲。rectangle と排他。
locationBias.circle.center	オブジェクト	親オブジェクトを指定した場合に必須	circle 指定時に必須	円の中心の WGS84 座標。
locationBias.circle.center.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	center 指定時に必須	中心緯度、−90〜90 度。
locationBias.circle.center.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	center 指定時に必須	中心経度、−180〜180 度。
locationBias.circle.radius	数値; 0.0–50000.0	親オブジェクトを指定した場合に必須	circle 指定時に必須	半径は最大 50,000 m。locationRestriction では正数が必要。
locationBias.rectangle	オブジェクト	いいえ	未指定	緯度経度の閉じた表示範囲。circle と排他。日付変更線越えに対応。
locationBias.rectangle.high	オブジェクト	親オブジェクトを指定した場合に必須	rectangle 指定時に必須	北東端の境界。
locationBias.rectangle.high.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	境界指定時に必須	北端緯度は南端以上。
locationBias.rectangle.high.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	境界指定時に必須	東端経度。西端より小さければ日付変更線を横断。
locationBias.rectangle.low	オブジェクト	親オブジェクトを指定した場合に必須	rectangle 指定時に必須	南西端の境界。
locationBias.rectangle.low.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	境界指定時に必須	南端緯度は北端以下。
locationBias.rectangle.low.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	境界指定時に必須	西端経度。東端より大きければ日付変更線を横断。
locationRestriction / --location-restriction	オブジェクト	いいえ	位置指定がどちらもなければ Google の IP 優先	円または矩形内に結果を制限。locationBias と排他。
locationRestriction.circle	オブジェクト	いいえ	未指定	円形範囲。rectangle と排他。
locationRestriction.circle.center	オブジェクト	親オブジェクトを指定した場合に必須	circle 指定時に必須	円の中心の WGS84 座標。
locationRestriction.circle.center.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	center 指定時に必須	中心緯度、−90〜90 度。
locationRestriction.circle.center.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	center 指定時に必須	中心経度、−180〜180 度。
locationRestriction.circle.radius	数値; 0.0–50000.0	親オブジェクトを指定した場合に必須	circle 指定時に必須	半径は最大 50,000 m。locationRestriction では正数が必要。
locationRestriction.rectangle	オブジェクト	いいえ	未指定	緯度経度の閉じた表示範囲。circle と排他。日付変更線越えに対応。
locationRestriction.rectangle.high	オブジェクト	親オブジェクトを指定した場合に必須	rectangle 指定時に必須	北東端の境界。
locationRestriction.rectangle.high.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	境界指定時に必須	北端緯度は南端以上。
locationRestriction.rectangle.high.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	境界指定時に必須	東端経度。西端より小さければ日付変更線を横断。
locationRestriction.rectangle.low	オブジェクト	親オブジェクトを指定した場合に必須	rectangle 指定時に必須	南西端の境界。
locationRestriction.rectangle.low.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	境界指定時に必須	南端緯度は北端以下。
locationRestriction.rectangle.low.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	境界指定時に必須	西端経度。東端より大きければ日付変更線を横断。
origin / --origin	オブジェクト	いいえ	距離は省略	直線距離 distanceMeters の基準座標。
origin.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	origin 指定時に必須	WGS84 緯度、−90〜90 度。
origin.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	origin 指定時に必須	WGS84 経度、−180〜180 度。
regionCode / --region-code	文字列; パターン： ^[A-Za-z]{2}$	いいえ	未指定	書式・順位用の 2 文字 CLDR 地域。地域内への制限ではありません。
sessionToken / --session-token	文字列; 最低 1 文字; パターン： ^[A-Za-z0-9_-]+$	いいえ	セッション集約なし、要求単位課金	呼び出し元が生成する URL 安全トークン。ASCII 最大 36 文字。セッションごとに新しい UUID v4 を推奨。終了時の details/validate-address にも渡す。

動作と制約

• トークンは呼び出し元が管理。自動作成・終了なし。同じ Cloud プロジェクトの認証で、適格な Place Details/Address Validation により終了し、次回は新規トークン。省略・再利用は要求単位課金の場合あり。
• 円は最大 50 km、制限円は正の半径。矩形緯度は順序付きで日付変更線越え可。表示時の Google・提供元の帰属表示を保持。EEA 条件・項目は異なる場合あり。https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

公式の出典: https://developers.google.com/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete

結果

suggestions、文字列一致、地点・検索語候補、利用可能な distanceMeters を保持。

実行例

MCP 引数:

{
  "input": "coffee near Paris",
  "sessionToken": "550e8400-e29b-41d4-a716-446655440000",
  "includedRegionCodes": [
    "FR"
  ],
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "radius": 5000
    }
  },
  "includeQueryPredictions": true
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_autocomplete --args '{"input":"coffee near Paris","sessionToken":"550e8400-e29b-41d4-a716-446655440000","includedRegionCodes":["FR"],"locationBias":{"circle":{"center":{"latitude":48.8566,"longitude":2.3522},"radius":5000}},"includeQueryPredictions":true}'

maps_geolocate

ネイティブの基地局・WiFi 観測から位置を推定し、サーバー出口 IP へのフォールバックも選択可能。

ネイティブの基地局・WiFi 観測から位置を推定し、サーバー出口 IP へのフォールバックも選択可能。

CLI コマンド: geolocate. Google の認証: この実装は API キーを使用。OAuth モードでも、このエンドポイントにはキーが必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
body / --body	オブジェクト	はい	—	ネイティブ本文。homeMobileCountryCode、homeMobileNetworkCode、radioType（gsm/cdma/wcdma/lte/nr）、carrier、considerIp、cellTowers、wifiAccessPoints、方式固有の cellId/newRadioCellId・信号情報。空オブジェクトはサーバー IP フォールバックを許可。

動作と制約

• Google の既定は considerIp=true。対象は実行環境の出口 IP で、エージェント利用者ではありません。false で禁止。ネストした通信仕様は Google が検証。https://developers.google.com/maps/documentation/geolocation/requests-geolocation
• WiFi は異なる固定アクセスポイントが最低 2 つ必要。ローカル管理・予約 MAC、移動ホットスポットでは結果がない場合あり。NOT_FOUND の可能性があるため accuracy を確認。

公式の出典: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

結果

ネイティブ location と accuracy（m）。Google エラーを保持。推定位置は厳密な測位ではありません。

実行例

MCP 引数:

{
  "body": {
    "considerIp": false,
    "wifiAccessPoints": [
      {
        "macAddress": "00:25:9c:cf:1c:ac",
        "signalStrength": -43
      },
      {
        "macAddress": "00:25:9c:cf:1c:ad",
        "signalStrength": -55
      }
    ]
  }
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_geolocate --args '{"body":{"considerIp":false,"wifiAccessPoints":[{"macAddress":"00:25:9c:cf:1c:ac","signalStrength":-43},{"macAddress":"00:25:9c:cf:1c:ad","signalStrength":-55}]}}'

maps_solar

建物の太陽光発電ポテンシャル・地域レイヤー、または Google が返す ID の実際の GeoTIFF を取得。

建物の太陽光発電ポテンシャル・地域レイヤー、または Google が返す ID の実際の GeoTIFF を取得。

CLI コマンド: solar. Google の認証: API キーまたは cloud-platform スコープの OAuth。サービスアカウントには API 有効化とクォータ側の serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
additionalInsights / --additional-insights	文字列の配列; 0–1 項目; 値： DETECTED_ARRAYS	いいえ	追加分析なし	building_insights で DETECTED_ARRAYS を指定し、検出済み屋根上太陽光パネルを取得。
exactQualityRequired / --exact-quality-required	真偽値	いいえ	false	指定した品質に完全一致させ、上位品質を許可しない。
experiments / --experiments	文字列の配列; 0–1 項目; 値： EXPANDED_COVERAGE	いいえ	実験指定なし	任意の EXPANDED_COVERAGE。Google では pre-GA 扱い。
id / --id	文字列; 最低 1 文字	いいえ	geo_tiff で必須	返却された Solar URL の id パラメーター。geo_tiff に必須。URL ではなく ID のみ指定。
location / --location	オブジェクト	いいえ	未指定	建物検索・データレイヤーの中心。building_insights/data_layers に必須。
location.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	location 指定時に必須	WGS84 緯度、−90〜90 度。
location.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	location 指定時に必須	WGS84 経度、−180〜180 度。
operation / --operation	文字列; 値： building_insights, data_layers, geo_tiff	はい	—	building_insights、data_layers、geo_tiff。操作に関連する引数のみ許可。
pixelSizeMeters / --pixel-size-meters	数値; 値： 0.1, 0.25, 0.5, 1.0	いいえ	0.1	最小ピクセル尺度。0.1、0.25、0.5、1.0 m。レイヤー固有の解像度は粗い場合あり。
radiusMeters / --radius-meters	数値; 制限なし–1000	いいえ	未指定	data_layers に必須の正半径。最大 1000 m。100 m 超は pixelSizeMeters×1000 以下、175 m 超は月別日射・時間別影を含まない view が必要。
requiredQuality / --required-quality	文字列; 値： HIGH, MEDIUM, BASE	いいえ	HIGH（Google 既定）	最低画像品質。HIGH、MEDIUM、BASE。BASE は拡張衛星画像で、提供地域は異なる。
view / --view	文字列; 値： DSM_LAYER, IMAGERY_LAYERS, IMAGERY_AND_ANNUAL_FLUX_LAYERS, IMAGERY_AND_ALL_FLUX_LAYERS, FULL_LAYERS	いいえ	FULL_LAYERS（Google 既定）	レイヤー選択：DSM_LAYER、IMAGERY_LAYERS、IMAGERY_AND_ANNUAL_FLUX_LAYERS、IMAGERY_AND_ALL_FLUX_LAYERS、FULL_LAYERS。

動作と制約

• 地域ごとに範囲・品質が異なり、約 50 m 内に建物がなければ NOT_FOUND。レイヤー URL は一時的で認証必須。geo_tiff は solar.googleapis.com の固定エンドポイントのみ。https://developers.google.com/maps/documentation/solar/coverage
• GeoTIFF は 16 MiB・ツール時間制限内。大きい画像は半径縮小・ピクセル粗化が必要。EXPANDED_COVERAGE は pre-GA。EEA では項目・条件が異なる場合あり。各端点に課金、表示には帰属表示が必要。設置設計は対象外。

公式の出典: https://developers.google.com/maps/comms/eea/solar, https://developers.google.com/maps/documentation/solar/coverage, https://developers.google.com/maps/documentation/solar/reference/rest/v1/buildingInsights/findClosest, https://developers.google.com/maps/documentation/solar/reference/rest/v1/dataLayers/get, https://developers.google.com/maps/documentation/solar/reference/rest/v1/geoTiff/get

結果

完全なネイティブの分析・レイヤー JSON。geo_tiff は MIME・キャッシュ情報付きラスター。

実行例

MCP 引数:

{
  "operation": "data_layers",
  "location": {
    "latitude": 37.444,
    "longitude": -122.16
  },
  "radiusMeters": 100,
  "view": "IMAGERY_AND_ANNUAL_FLUX_LAYERS"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_solar --args '{"operation":"data_layers","location":{"latitude":37.444,"longitude":-122.16},"radiusMeters":100,"view":"IMAGERY_AND_ANNUAL_FLUX_LAYERS"}'

maps_aerial_view

米国の対応住所について Aerial View の状態・メタデータ・一時的再生 URL を取得。

米国の対応住所について Aerial View の状態・メタデータ・一時的再生 URL を取得。

CLI コマンド: aerial-view. Google の認証: この実装は API キーを使用。OAuth モードでも、このエンドポイントにはキーが必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
address / --address	文字列; 最低 1 文字	いいえ	未指定	対応する米国住所。videoId とどちらか 1 つ。
operation / --operation	文字列; 値： lookup, metadata	いいえ	lookup	lookup は再生 URL とメタデータ（課金）、metadata はメタデータのみ（Google 無料メソッド）。
videoId / --video-id	文字列; 最低 1 文字	いいえ	未指定	以前返された動画 ID。address とどちらか 1 つ。

動作と制約

• 3D 提供範囲の米国住所のみ。未作成は NOT_FOUND。作成は明示的な maps_render_aerial_video。処理中は適切な間隔で metadata を照会。lookup 自体が課金イベント。
• 再生 URL は短時間で失効するため表示ごとに取得。動画のダウンロード・保存・キャッシュは禁止。動画 ID のみ文書上の例外あり。帰属表示を維持。EEA 条件は異なる場合あり。https://developers.google.com/maps/documentation/aerial-view/policies

公式の出典: https://developers.google.com/maps/documentation/aerial-view/lookup-video, https://developers.google.com/maps/documentation/aerial-view/policies

結果

処理状態・動画情報・形式/解像度別の再生 URI。metadata は再生 URI を含みません。

実行例

MCP 引数:

{
  "operation": "metadata",
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_aerial_view --args '{"operation":"metadata","address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_render_aerial_video

対応する米国住所の Aerial View 動画生成を明示的にキューへ登録。

対応する米国住所の Aerial View 動画生成を明示的にキューへ登録。

CLI コマンド: render-aerial-video. Google の認証: この実装は API キーを使用。OAuth モードでも、このエンドポイントにはキーが必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
address / --address	文字列; 最低 1 文字	はい	—	生成対象の対応する米国住所。

動作と制約

• 生成キューを変更します。自動再試行・完了待ち・動画ダウンロードはしません。maps_aerial_view の metadata で進捗確認し、再生時に lookup。
• 米国・3D の範囲、割当、利用条件が適用。有効化済みでも生成できるとは限りません。動画のダウンロード・保存・キャッシュは禁止、帰属表示が必要。https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

公式の出典: https://developers.google.com/maps/documentation/aerial-view/reference/rest/v1/videos/renderVideo

結果

ネイティブの生成応答。PROCESSING は待機・処理中。既存動画は即時 ACTIVE の場合あり。

実行例

MCP 引数:

{
  "address": "600 Montgomery St, San Francisco, CA 94111"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_render_aerial_video --args '{"address":"600 Montgomery St, San Francisco, CA 94111"}'

maps_map_tiles

適切な地図可視化用に Google 2D・3D・Street View タイル、セッション、帰属メタデータを取得。

適切な地図可視化用に Google 2D・3D・Street View タイル、セッション、帰属メタデータを取得。

CLI コマンド: map-tiles. Google の認証: API キーまたは cloud-platform スコープの OAuth。Map Tiles と課金を有効化。サービスアカウントにはクォータ側 Service Usage 権限が必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
east / --east	数値; -180.0–180.0	いいえ	未指定。該当操作では必須	viewport の東端経度。東端が負・西端が正なら日付変更線を横断可能。
fov / --fov	数値; 30.0–120.0	いいえ	90	サムネイルの水平視野角、30〜120 度。
height / --height	整数; 16–250	いいえ	250	サムネイル高さ、16〜250 ピクセル。
latitude / --latitude	数値; -90.0–90.0	いいえ	未指定。該当操作では必須	streetview_metadata の中心緯度。longitude が必要。panoId と排他。
locations / --locations	オブジェクトの配列; 1–100 項目	いいえ	未指定。該当操作では必須	streetview_pano_ids 用の lat・lng を持つ位置を 1〜100 件。
locations[].lat	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	未指定。該当操作では必須	検索中心の WGS84 緯度。
locations[].lng	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	未指定。該当操作では必須	検索中心の WGS84 経度。
longitude / --longitude	数値; -180.0–180.0	いいえ	未指定。該当操作では必須	streetview_metadata の中心経度。latitude が必要。panoId と排他。
north / --north	数値; -90.0–90.0	いいえ	未指定。該当操作では必須	viewport の北端緯度。south より大きい値。
operation / --operation	文字列; 値： create_session, tile_2d, viewport, root_3d, resource_3d, streetview_pano_ids, streetview_metadata, streetview_thumbnail, streetview_tile	はい	—	create_session、tile_2d、viewport、root_3d、resource_3d、streetview_pano_ids、streetview_metadata、streetview_thumbnail、streetview_tile。操作ごとに端点・必須引数が異なります。
panoId / --pano-id	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	streetview_tile/thumbnail に必須。metadata では緯度経度の代わりに指定可。一時 ID でありセッションを超えて安定とは限りません。
pitch / --pitch	数値; -90.0–90.0	いいえ	0	サムネイルの垂直向き、−90〜90 度。
radius / --radius	数値; 0.0–100000.0	いいえ	50 m	パノラマ ID・座標メタデータ検索半径。0〜100000 m。metadata の panoId と同時指定不可。
resourceUrl / --resource-url	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	resource_3d 用の Google 発行 https://tile.googleapis.com/v1/3dtiles/... 絶対 URL。別オリジン・ポート・ユーザー情報・フラグメント・符号化パスは禁止。URL 内のキーを除去し設定済み認証を使用。
session / --session	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	createSession のトークン。2D・Street View に必須、3D は不要。応答の有効期限を使用。
sessionOptions / --session-options	オブジェクト	いいえ	未指定。該当操作では必須	create_session に必須のネイティブ設定。mapType、language、region が必須。
sessionOptions.highDpi	真偽値	いいえ	false	2x/4x で画素数を増加。1x では効果なし。
sessionOptions.imageFormat	文字列; 値： jpeg, png	いいえ	Google が最適な形式を選択	jpeg または png。JPEG は透明オーバーレイ不可。
sessionOptions.language	文字列; 最低 1 文字	親オブジェクトを指定した場合に必須	未指定。該当操作では必須	IETF 言語タグ。例：en-US。
sessionOptions.layerTypes	文字列の配列; 1–3 項目; 値： layerRoadmap, layerStreetview, layerTraffic	いいえ	追加レイヤーなし	layerRoadmap、layerStreetview、layerTraffic を 1〜3 件。terrain に layerRoadmap が必須。
sessionOptions.mapType	文字列; 値： roadmap, satellite, terrain, streetview	親オブジェクトを指定した場合に必須	未指定。該当操作では必須	roadmap、satellite、terrain、streetview。terrain は layerTypes に layerRoadmap が必要。
sessionOptions.overlay	真偽値	いいえ	false	true で基底画像を除き layerTypes のみ描画。
sessionOptions.region	文字列; パターン： ^[A-Z]{2}$	親オブジェクトを指定した場合に必須	未指定。該当操作では必須	利用者の物理的位置を表す大文字 2 文字の CLDR 地域。例：US。
sessionOptions.scale	文字列; 値： scaleFactor1x, scaleFactor2x, scaleFactor4x	いいえ	scaleFactor1x	scaleFactor1x、scaleFactor2x、scaleFactor4x で地図要素の大きさを指定。
sessionOptions.styles	オブジェクトの配列; 1–100 項目	いいえ	Google 既定のスタイル	ネイティブのスタイル JSON。roadmap のみ。https://developers.google.com/maps/documentation/tile/style-reference
south / --south	数値; -90.0–90.0	いいえ	未指定。該当操作では必須	viewport の南端 WGS84 緯度。
west / --west	数値; -180.0–180.0	いいえ	未指定。該当操作では必須	viewport の西端経度。
width / --width	整数; 16–600	いいえ	600	サムネイル幅、16〜600 ピクセル。
x / --x	整数; 0–4194303	いいえ	未指定。該当操作では必須	タイル列。2D は 2^zoom 未満。Street View はメタデータのパノラマ寸法による。
y / --y	整数; 0–4194303	いいえ	未指定。該当操作では必須	タイル行。2D は 2^zoom 未満。Street View はメタデータのパノラマ寸法による。
yaw / --yaw	数値; -360.0–360.0	いいえ	0	サムネイルの水平向き、−360〜360 度。
zoom / --zoom	整数; 0–22	いいえ	未指定。該当操作では必須	tile_2d/viewport は 0〜22、streetview_tile は 0〜5。実際の最大値は viewport メタデータで確認。

動作と制約

• create_session は Google セッションを作成し自動再試行なし。パノラマ ID は読み取り専用 POST。無関係な引数を拒否。Web・ネイティブ描画や画像結合は提供しません。
• 地図可視化のみ。許可のない先読み・索引・保存・キャッシュ・抽出・エージェントでの画像解釈は禁止。Cache-Control、ETag、契約を遵守。https://developers.google.com/maps/documentation/tile/policies
• Google Maps ロゴと提供元帰属表示を保持。2D は viewport copyright、Street View は metadata copyright と問題報告リンク、3D はタイル著作権を表示。隠したり切り落としたりしません。
• 範囲・EEA 条件・課金・割当は異なる場合あり。session の expiry を優先し、パノラマ ID は短期有効。オフライン地図・一括取得・キャッシュ・分析は未実装。https://developers.google.com/maps/documentation/tile/session_tokens

公式の出典: https://developers.google.com/maps/documentation/tile/2d-tiles-overview, https://developers.google.com/maps/documentation/tile/3d-tiles, https://developers.google.com/maps/documentation/tile/get-api-key, https://developers.google.com/maps/documentation/tile/policies, https://developers.google.com/maps/documentation/tile/session_tokens, https://developers.google.com/maps/documentation/tile/streetview, https://developers.google.com/maps/documentation/tile/style-reference

結果

セッション・メタデータ・tileset はネイティブ JSON。画像・3D リソースは MIME・キャッシュ情報付き実データ。描画側の実装は利用者が用意。

実行例

MCP 引数:

{
  "operation": "root_3d"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_map_tiles --args '{"operation":"root_3d"}'

maps_streetview

Street View パノラマのメタデータ、または実際の静止 JPEG を取得。

Street View パノラマのメタデータ、または実際の静止 JPEG を取得。

CLI コマンド: streetview. Google の認証: この実装は API キーのみ。OAuth のみでは不可。Street View Static を有効化。Google は署名を推奨し、一部アカウントでは必須。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
fov / --fov	数値; 1.0–120.0	いいえ	90	水平視野角、1〜120 度。
heading / --heading	数値; 0.0–360.0	いいえ	Google が指定位置の方向を選択	画像カメラの方位角、0〜360 度。
height / --height	整数; 1–640	いいえ	400	image の高さ、1〜640 ピクセル。
location / --location	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	住所、緯度経度文字列（例：48.8584,2.2945）、place_id:PLACE_ID。panoId とどちらか 1 つ。
operation / --operation	文字列; 値： metadata, image	はい	—	metadata は JSON、image は JPEG バイト列。
panoId / --pano-id	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	特定パノラマ ID。location と排他。ID は変わるため元の検索場所を保持。
pitch / --pitch	数値; -90.0–90.0	いいえ	0	垂直カメラ角度、−90〜90 度。
radius / --radius	整数; 0–100000	いいえ	50	検索半径、整数 0〜100000 m。
returnErrorCode / --return-error-code	真偽値	いいえ	この実装では true	image で画像がない場合、灰色画像の代わりに HTTP エラーを返す。
signature / --signature	文字列; 最低 1 文字	いいえ	未指定	正確な符号化済み要求の URL 署名。アカウントにより必須。生成はせず転送のみ。 署名付きリクエストでは API キーの後に signature を最後に追加します。生成された既定値も含む、正確にエンコードされたパスとクエリに署名してください。画像の順序：location、radius、source、pano、size、heading、fov、pitch、return_error_code、key。未指定の任意項目は省略し、メタデータは画像項目を含みません。空白は + です。既定値は size=640x400 と return_error_code=true です。
source / --source	文字列; 値： default, google, outdoor	いいえ	default	default、google、outdoor。提供範囲は地域・コレクション次第。
width / --width	整数; 1–640	いいえ	640	image の幅、1〜640 ピクセル。特別アクセスが必要な大画像は未対応。

動作と制約

• location、panoId のどちらか 1 つ。画像用カメラ・寸法引数は metadata で使用不可。メタデータは現在無料で画像クォータを消費せず、画像は課金。https://developers.google.com/maps/documentation/streetview/metadata
• 埋め込みの Google Maps 帰属表示を保持。印刷は禁止、保存・キャッシュ制限が適用。このツールは保持・再配布・分析の権利を付与しません。https://developers.google.com/maps/documentation/streetview/policies
• 任意署名の転送のみ。署名鍵管理・特別な大画像は未対応。範囲、EEA 条件、パノラマ ID・撮影日は変わる場合あり。

公式の出典: https://developers.google.com/maps/documentation/streetview/metadata, https://developers.google.com/maps/documentation/streetview/policies, https://developers.google.com/maps/documentation/streetview/request-streetview

結果

metadata はネイティブの状態・パノラマ ID・日付・著作権。image は MIME・キャッシュ情報付き JPEG。

実行例

MCP 引数:

{
  "operation": "metadata",
  "location": "Eiffel Tower, Paris, France"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_streetview --args '{"operation":"metadata","location":"Eiffel Tower, Paris, France"}'

maps_streetview_publish

同意した利用者の Street View 写真・シーケンスを管理。アップロード・公開・メタデータ変更・削除を明示実行。

同意した利用者の Street View 写真・シーケンスを管理。アップロード・公開・メタデータ変更・削除を明示実行。

CLI コマンド: streetview-publish. Google の認証: エンドユーザー OAuth のみ。スコープ https://www.googleapis.com/auth/streetviewpublish。authorized_user JSON、OAuth モード、クォータプロジェクトを明示設定。サービスアカウント・暗黙 ADC・API キーのみは拒否。同意済みトークンの更新だけを行い、ブラウザー認可コールバックは提供しません。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
dataBase64 / --data-base64	文字列; 最低 4 文字	いいえ	未指定。該当操作では必須	標準パディング付き base64。復号後 1 バイト〜8 MiB。Google 製品の上限ではなく実装上限。
filter / --filter	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	list/list_sequences/get_sequence のネイティブ条件式。構文は端点ごとに異なります。
inputType / --input-type	文字列; 値： VIDEO, XDM	いいえ	未指定。該当操作では必須	create_sequence に必須。VIDEO または XDM。
languageCode / --language-code	文字列; 最低 1 文字	いいえ	Google の既定	list/get/batch_get 写真情報の希望言語。
mimeType / --mime-type	文字列; 値： image/jpeg, application/octet-stream, video/mp4	いいえ	image/jpeg	upload のメディア形式。image/jpeg、video/mp4、application/octet-stream。
operation / --operation	文字列; 値： list, get, start_upload, upload, create, update, delete, batch_get, batch_update, batch_delete, list_sequences, get_sequence, start_sequence_upload, create_sequence, delete_sequence	はい	—	list、get、start_upload、upload、create、update、delete、batch_get、batch_update、batch_delete、list_sequences、get_sequence、start_sequence_upload、create_sequence、delete_sequence。
pageSize / --page-size	整数; 1–100	いいえ	Google サービスの既定	list/list_sequences のページ件数 1〜100。Google はこれより少ない場合あり。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	前ページの nextPageToken。全ページ自動取得はしません。
photo / --photo	オブジェクト	いいえ	未指定。該当操作では必須	create/update の完全な Photo JSON。create はバイト送信済みの uploadReference.uploadUrl、update は別途 photoId・updateMask が必要。
photoId / --photo-id	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	get/update/delete の写真 ID。リソースパス・URL 引数は含めない。
photoIds / --photo-ids	文字列の配列; 1–100 項目; 各項目は最低 1 文字	いいえ	未指定。該当操作では必須	batch_get/batch_delete 用の写真 ID を 1〜100 件。
photoSequence / --photo-sequence	オブジェクト	いいえ	未指定。該当操作では必須	create_sequence のネイティブ PhotoSequence。uploadReference.uploadUrl と形式に応じた GPS/CAMM/IMU・撮影情報が必要。
sequenceId / --sequence-id	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	get_sequence/delete_sequence のシーケンス ID。作成時の操作名に含まれます。
updateMask / --update-mask	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	update に必須のカンマ区切り FieldMask。例：pose.heading、pose.latLngPair。
updatePhotoRequests / --update-photo-requests	オブジェクトの配列; 1–100 項目	いいえ	未指定。該当操作では必須	batch_update の UpdatePhotoRequest を 1〜100 件。各項目に photo.photoId.id、updateMask が必要。
uploadUrl / --upload-url	文字列; 最低 1 文字	いいえ	未指定。該当操作では必須	start_upload/start_sequence_upload の完全な HTTPS UploadRef。streetviewpublish.googleapis.com/media/user/{account}/photo/{reference} または photoSequence のみ。転送・別オリジン・ユーザー情報・フラグメント・符号化パスは禁止。
view / --view	文字列; 値： BASIC, INCLUDE_DOWNLOAD_URL	いいえ	BASIC	list/get/batch_get/get_sequence の BASIC または INCLUDE_DOWNLOAD_URL。ダウンロード URL は機密性のあるユーザーリソースで、本ツールでは取得しません。

動作と制約

• 写真手順：start_upload → upload → create。Photo Sphere/XMP、権利、公開審査の要件を満たす必要。https://developers.google.com/streetview/publish/first-app
• update は PUT と updateMask。Google は画像ピクセル更新を非対応。delete/batch_delete は公開写真を削除。doctor・ライブスモークで書き込み・公開・送信・削除は行いません。
• シーケンス手順：start_sequence_upload → upload → create_sequence → get_sequence。動画は 8 MiB 上限を超える場合が多く、分割・再開可能送信は未対応。大きな媒体は Google 側で先に送信して UploadRef を渡します。
• 公開 v1 の写真・シーケンス REST 端点を実装していますが、すべてのネスト項目をライブ検証した意味ではありません。GPS・姿勢・IMU・接続・地点は Google が検証。batch_update は各項目に photo.photoId.id・updateMask が必須。https://developers.google.com/streetview/publish/reference/rest
• アップロードは固定オリジン・サイズ制限付き・再試行なしの POST。変更はすべて自動再試行を無効化し、曖昧な通信失敗による重複公開を防止。プライバシー・所有権・割当・審査に従う必要。提供済みサービスアカウントではライブ検証不可。同意済みの実ユーザー認証が必要。

公式の出典: https://developers.google.com/streetview/publish/authorizing, https://developers.google.com/streetview/publish/first-app, https://developers.google.com/streetview/publish/reference/rest, https://developers.google.com/streetview/publish/reference/rest/v1/photo, https://developers.google.com/streetview/publish/reference/rest/v1/photoSequence/create, https://developers.google.com/streetview/publish/reference/rest/v1/photos/batchUpdate

結果

ネイティブの写真・シーケンス・一覧・UploadRef・処理操作。バッチは項目別状態を保持。バイトの送信だけでは公開されません。

実行例

MCP 引数:

{
  "operation": "list",
  "pageSize": 10,
  "view": "BASIC"
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_streetview_publish --args '{"operation":"list","pageSize":10,"view":"BASIC"}'

maps_datasets

Google Maps のデータドリブン スタイル用データセットを管理。既存 Cloud Storage オブジェクトからの非同期取り込みに対応。

Google Maps のデータドリブン スタイル用データセットを管理。既存 Cloud Storage オブジェクトからの非同期取り込みに対応。

CLI コマンド: datasets. Google の認証: OAuth 2.0 のみ。サービスアカウントまたは ADC、スコープ https://www.googleapis.com/auth/cloud-platform。API キー不可。リソース IAM とクォータ側権限は別々に設定。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
dataset / --dataset	オブジェクト	いいえ	create/update に必須	ネイティブ Dataset JSON。全フィールドは Google が検証。create は一意の displayName と usage:["USAGE_DATA_DRIVEN_STYLING"] が必要。update は一致するリソース名を設定。
gcsSource / --gcs-source	オブジェクト	いいえ	import に必須	取り込む既存の Cloud Storage オブジェクト。呼び出し元の読み取り権限が必要。ローカルファイルは読みません。
gcsSource.fileFormat	文字列; 値： FILE_FORMAT_GEOJSON, FILE_FORMAT_KML, FILE_FORMAT_CSV	親オブジェクトを指定した場合に必須	gcsSource 指定時に必須	形式：FILE_FORMAT_GEOJSON、FILE_FORMAT_KML、FILE_FORMAT_CSV。
gcsSource.inputUri	文字列; 最低 1 文字	親オブジェクトを指定した場合に必須	gcsSource 指定時に必須	既存の gs://bucket/object。storage.objects.get（例：Storage Object Viewer）が必要。
name / --name	文字列; パターン： ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*/datasets/[A-Za-z0-9_-]+(@active)?$	いいえ	リソース操作に必須	projects/{project}/datasets/{dataset}。list/create 以外で必須。get のみ @active で最新の完了版を取得可能。
operation / --operation	文字列; 値： list, get, create, update, delete, import, download, fetch_errors	はい	必須	list、get、create、update、delete、import、download、fetch_errors。作成・更新・削除・取り込みはクラウドを変更。
pageSize / --page-size	整数; 1–500	いいえ	list：100、fetch_errors：Google 既定 50	1 ページのデータセット・エラー件数。この実装は 1〜500。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	最初のページ	前回の nextPageToken。他の条件は同じにします。1 回の呼び出しで 1 ページだけ取得します。
parent / --parent	文字列; パターン： ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*$	いいえ	list/create に必須	projects/{プロジェクト ID または番号}。list、create に必須。
tag / --tag	文字列; 値： active	いいえ	処理状態を問わず最新バージョン	list で active を指定すると最新の完了版のみを返し、完了版のないものを除外。
updateMask / --update-mask	文字列; 最低 1 文字	いいえ	Google の既定は *（メタデータ全置換）	更新するメタデータのパス。カンマ区切り。例：description,displayName。
versionDescription / --version-description	文字列; 最低 1 文字	いいえ	省略	新しく取り込むバージョンの説明。import のみ。

動作と制約

• 操作ごとに mapsplatformdatasets.datasets.list/get/create/update/delete/import/export が必要。ネイティブの定義：https://developers.google.com/maps/documentation/datasets/reference/rest 。
• GCS 取り込みは非同期で新バージョンを作成。get で状態、fetch_errors でエラーを明示的に確認。自動ポーリングなし。公開 v1 に listVersions はなく、最新・@active・versionId のみ。
• ダウンロードに export 権限が必要。CLI --output で保存可能。現在 API 自体は無料ですが課金設定が必要。地図表示や Cloud Storage は別料金の場合あり。データドリブン スタイル用途のみ。ローカル multipart アップロードは未対応。https://developers.google.com/maps/documentation/datasets/overview

公式の出典: https://developers.google.com/maps/documentation/datasets/create, https://developers.google.com/maps/documentation/datasets/overview, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/media/download, https://developers.google.com/maps/documentation/datasets/reference/rest/v1/projects.datasets

結果

ネイティブのデータセット、一覧、エラー、取り込みバージョン名を返します。ダウンロードは MIME・キャッシュ情報付きバイト列。get は status.state、status.errorMessage、versionId を保持。取り込み応答は処理完了を意味しません。

実行例

MCP 引数:

{
  "operation": "list",
  "parent": "projects/my-project",
  "pageSize": 20
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_datasets --args '{"operation":"list","parent":"projects/my-project","pageSize":20}'

maps_route_optimization

実際の Route Optimization API で車両を最適化。ShipmentModel の容量・時間枠・費用制約を保持。

実際の Route Optimization API で車両を最適化。ShipmentModel の容量・時間枠・費用制約を保持。

CLI コマンド: route-optimization. Google の認証: OAuth 2.0 のみ。サービスアカウントまたは ADC、スコープ https://www.googleapis.com/auth/cloud-platform。API キー不可。リソース IAM とクォータ側権限は別々に設定。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
name / --name	文字列; パターン： ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?/operations/[A-Za-z0-9_-]+$	いいえ	get_operation に必須	Google が返す projects/{project}[/locations/{location}]/operations/{ID}。get_operation 用。
operation / --operation	文字列; 値： optimize, validate, batch, optimize_long_running, optimize_uri, get_operation	はい	必須	optimize は同期計算、validate は VALIDATE_ONLY、batch は GCS ジョブ、optimize_long_running・optimize_uri は実験ジョブ作成、get_operation は状態を 1 回取得。
parent / --parent	文字列; パターン： ^projects/[A-Za-z0-9][A-Za-z0-9._:-]*(/locations/[A-Za-z0-9_-]+)?$	いいえ	get_operation 以外で必須	projects/{プロジェクト ID}。/locations/- も可。同期・長時間最適化で具体的リージョンは不可。batch/URI はネイティブの位置形式。
request / --request	オブジェクト	いいえ	get_operation 以外で必須	parent を除く完全なネイティブ本文。最適化・検証は model が必要。shipments、vehicles、制約は Google が検証。batch は GCS 入出力 URI と JSON/PROTO_TEXT の dataFormat を持つ modelConfigs を 1〜100 件。URI は .json/.txtpb で終わる gs:// の input.uri/output.uri。

動作と制約

• ネイティブのモデル・要求定義：https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours 。validate も Google に接続しますが計算は行いません。
• viewer は OptimizeTours と状態読み取り、editor は batch 作成にも対応。locations.use、operations.create/get と別途 GCS 権限が必要。https://developers.google.com/maps/documentation/route-optimization/cloud-setup
• batch/URI は明示指定された GCS 入出力で課金対象ジョブを作成。ファイル送信・自動ポーリングなし。クライアントのタイムアウトでジョブは取消されません。荷物数・単車/車両群 SKU の課金で、Routes の経由地最適化とは別機能。
• 長時間・URI 版は実験機能。URI の大文字小文字は :OptimizeToursUri。Google は現在 cancel/list/delete をサポートせず、get_operation のみ提供。https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations

公式の出典: https://developers.google.com/maps/documentation/route-optimization/cloud-setup, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/operations, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/batchOptimizeTours, https://developers.google.com/maps/documentation/route-optimization/reference/rest/v1/projects/optimizeTours, https://developers.google.com/maps/documentation/route-optimization/usage-and-billing, https://github.com/googleapis/googleapis/blob/master/google/maps/routeoptimization/v1/route_optimization_service.proto

結果

ネイティブ OptimizeToursResponse または長時間 Operation。状態取得は done:false、metadata、完了後の response/error を保持し、失敗を隠しません。

実行例

MCP 引数:

{
  "operation": "validate",
  "parent": "projects/my-project",
  "request": {
    "model": {
      "shipments": [],
      "vehicles": [
        {
          "startLocation": {
            "latitude": 48.85,
            "longitude": 2.35
          }
        }
      ]
    },
    "maxValidationErrors": 10
  }
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_route_optimization --args '{"operation":"validate","parent":"projects/my-project","request":{"model":{"shipments":[],"vehicles":[{"startLocation":{"latitude":48.85,"longitude":2.35}}]},"maxValidationErrors":10}}'

maps_air_quality_forecast

指定時刻・期間の最大 96 時間先までの大気質予報を取得。

指定時刻・期間の最大 96 時間先までの大気質予報を取得。

CLI コマンド: air-quality-forecast. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
customLocalAqis / --custom-local-aqis	オブジェクトの配列; 1–250 項目	いいえ	Google が地域指数を選択	国・地域ごとに Google 標準の地域指数を上書き。
customLocalAqis[].aqi	文字列; 最低 1 文字	親オブジェクトを指定した場合に必須	各上書きに必須	対応する指数コード。例：us_epa。組み合わせは Google が検証。
customLocalAqis[].regionCode	文字列; パターン： ^[A-Za-z]{2}$	親オブジェクトを指定した場合に必須	各上書きに必須	指数を上書きする 2 文字の国・地域コード。
dateTime / --date-time	文字列; 最低 20 文字	いいえ	時刻指定を 1 種類選択	Z で終わる RFC3339 UTC 時刻。Google は直前の正時に丸めます。period、hours とは同時指定できません。
extraComputations / --extra-computations	文字列の配列; 1–5 項目; 値： LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	いいえ	追加計算なし	LOCAL_AQI、HEALTH_RECOMMENDATIONS、POLLUTANT_ADDITIONAL_INFO、DOMINANT_POLLUTANT_CONCENTRATION、POLLUTANT_CONCENTRATION を追加。
languageCode / --language-code	文字列; 最低 1 文字	いいえ	Google：en	希望する IETF/BCP-47 言語コード。未対応の場合、Google が近い言語を選択します。
location / --location	オブジェクト	はい	必須	照会する位置の座標。
location.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	location 指定時に必須	緯度。−90〜90 度。
location.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	location 指定時に必須	経度。−180〜180 度。
pageSize / --page-size	整数; 1–96	いいえ	Google：予報 24、履歴 72	このページの時間別レコード上限。この実装では予報 96、履歴は Google の上限 168。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	最初のページ	前回の nextPageToken。他の条件は同じにします。1 回の呼び出しで 1 ページだけ取得します。
period / --period	オブジェクト	いいえ	時刻指定を 1 種類選択	終了時刻を含む順序付き期間。予報は 96 時間以内、履歴は 720 時間以内。
period.endTime	文字列; 最低 20 文字	親オブジェクトを指定した場合に必須	period 指定時に必須	期間に含める終了時刻。正しい RFC3339 UTC Z 形式。
period.startTime	文字列; 最低 20 文字	親オブジェクトを指定した場合に必須	period 指定時に必須	期間の開始時刻。正しい RFC3339 UTC Z 形式。
uaqiColorPalette / --uaqi-color-palette	文字列; 値： RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	いいえ	Google 既定の配色	共通 AQI の配色。RED_GREEN、INDIGO_PERSIAN_DARK、INDIGO_PERSIAN_LIGHT。地域指数の配色は固定。
universalAqi / --universal-aqi	真偽値	いいえ	Google：true	世界共通の大気質指数を含めるか。

動作と制約

• 時刻指定は 1 種類だけ選択。履歴は hours/dateTime/period、予報は dateTime/period。UTC・期間はローカル、提供期間・地域は Google が検証。
• 1 回で 1 ページ。nextPageToken で明示的に次ページを取得。指数・国の対応範囲、帰属表示・表示・キャッシュ制限が適用。https://developers.google.com/maps/documentation/air-quality/policies

公式の出典: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/forecast/lookup

結果

Google の時間別レコード、regionCode、nextPageToken、任意の汚染物質・健康推奨を保持。

実行例

MCP 引数:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "dateTime": "2026-11-01T12:00:00Z",
  "pageSize": 24
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_air_quality_forecast --args '{"location":{"latitude":48.85,"longitude":2.35},"dateTime":"2026-11-01T12:00:00Z","pageSize":24}'

maps_air_quality_history

直近 30 日の大気質履歴を明示的なページ単位で取得。

直近 30 日の大気質履歴を明示的なページ単位で取得。

CLI コマンド: air-quality-history. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
customLocalAqis / --custom-local-aqis	オブジェクトの配列; 1–250 項目	いいえ	Google が地域指数を選択	国・地域ごとに Google 標準の地域指数を上書き。
customLocalAqis[].aqi	文字列; 最低 1 文字	親オブジェクトを指定した場合に必須	各上書きに必須	対応する指数コード。例：us_epa。組み合わせは Google が検証。
customLocalAqis[].regionCode	文字列; パターン： ^[A-Za-z]{2}$	親オブジェクトを指定した場合に必須	各上書きに必須	指数を上書きする 2 文字の国・地域コード。
dateTime / --date-time	文字列; 最低 20 文字	いいえ	時刻指定を 1 種類選択	Z で終わる RFC3339 UTC 時刻。Google は直前の正時に丸めます。period、hours とは同時指定できません。
extraComputations / --extra-computations	文字列の配列; 1–5 項目; 値： LOCAL_AQI, HEALTH_RECOMMENDATIONS, POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION	いいえ	追加計算なし	LOCAL_AQI、HEALTH_RECOMMENDATIONS、POLLUTANT_ADDITIONAL_INFO、DOMINANT_POLLUTANT_CONCENTRATION、POLLUTANT_CONCENTRATION を追加。
hours / --hours	整数; 1–720	いいえ	hours/dateTime/period のどれか 1 つ	直近 1〜720 時間（30 日）。dateTime、period とは同時指定不可。
languageCode / --language-code	文字列; 最低 1 文字	いいえ	Google：en	希望する IETF/BCP-47 言語コード。未対応の場合、Google が近い言語を選択します。
location / --location	オブジェクト	はい	必須	照会する位置の座標。
location.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	location 指定時に必須	緯度。−90〜90 度。
location.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	location 指定時に必須	経度。−180〜180 度。
pageSize / --page-size	整数; 1–168	いいえ	Google：予報 24、履歴 72	このページの時間別レコード上限。この実装では予報 96、履歴は Google の上限 168。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	最初のページ	前回の nextPageToken。他の条件は同じにします。1 回の呼び出しで 1 ページだけ取得します。
period / --period	オブジェクト	いいえ	時刻指定を 1 種類選択	終了時刻を含む順序付き期間。予報は 96 時間以内、履歴は 720 時間以内。
period.endTime	文字列; 最低 20 文字	親オブジェクトを指定した場合に必須	period 指定時に必須	期間に含める終了時刻。正しい RFC3339 UTC Z 形式。
period.startTime	文字列; 最低 20 文字	親オブジェクトを指定した場合に必須	period 指定時に必須	期間の開始時刻。正しい RFC3339 UTC Z 形式。
uaqiColorPalette / --uaqi-color-palette	文字列; 値： RED_GREEN, INDIGO_PERSIAN_DARK, INDIGO_PERSIAN_LIGHT	いいえ	Google 既定の配色	共通 AQI の配色。RED_GREEN、INDIGO_PERSIAN_DARK、INDIGO_PERSIAN_LIGHT。地域指数の配色は固定。
universalAqi / --universal-aqi	真偽値	いいえ	Google：true	世界共通の大気質指数を含めるか。

動作と制約

• 時刻指定は 1 種類だけ選択。履歴は hours/dateTime/period、予報は dateTime/period。UTC・期間はローカル、提供期間・地域は Google が検証。
• 1 回で 1 ページ。nextPageToken で明示的に次ページを取得。指数・国の対応範囲、帰属表示・表示・キャッシュ制限が適用。https://developers.google.com/maps/documentation/air-quality/policies

公式の出典: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/history/lookup

結果

Google の時間別レコード、regionCode、nextPageToken、任意の汚染物質・健康推奨を保持。

実行例

MCP 引数:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 24,
  "pageSize": 12
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_air_quality_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":24,"pageSize":12}'

maps_air_quality_heatmap

実際の大気質ヒートマップ PNG タイルを取得。

実際の大気質ヒートマップ PNG タイルを取得。

CLI コマンド: air-quality-heatmap. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
mapType / --map-type	文字列; 値： UAQI_RED_GREEN, UAQI_INDIGO_PERSIAN, PM25_INDIGO_PERSIAN, GBR_DEFRA, DEU_UBA, CAN_EC, FRA_ATMO, US_AQI	はい	必須	ヒートマップ種別：UAQI_RED_GREEN / UAQI_INDIGO_PERSIAN / PM25_INDIGO_PERSIAN / GBR_DEFRA / DEU_UBA / CAN_EC / FRA_ATMO / US_AQI。
x / --x	整数; 0–65535	はい	必須	タイル列番号。0〜2^zoom−1。送信前に検証。
y / --y	整数; 0–65535	はい	必須	タイル行番号。0〜2^zoom−1。送信前に検証。
zoom / --zoom	整数; 0–16	はい	必須	Web Mercator のズーム 0〜16。0 は世界全体を 1 枚で表示。

動作と制約

• 国・指数・季節によって提供範囲が異なります。Google の帰属表示・地図利用・キャッシュ許諾に従ってください。API 有効化でコンテンツ制限が免除されるわけではありません。https://developers.google.com/maps/documentation/air-quality/policies

公式の出典: https://developers.google.com/maps/documentation/air-quality/policies, https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

結果

MIME・キャッシュ情報付きバイナリタイル。MCP は画像、CLI --output はバイト列を保存。

実行例

MCP 引数:

{
  "mapType": "UAQI_RED_GREEN",
  "zoom": 2,
  "x": 2,
  "y": 1
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_air_quality_heatmap --args '{"mapType":"UAQI_RED_GREEN","zoom":2,"x":2,"y":1}'

maps_pollen_heatmap

樹木・草・雑草の花粉指数ヒートマップを取得。

樹木・草・雑草の花粉指数ヒートマップを取得。

CLI コマンド: pollen-heatmap. Google の認証: この実装は API キーのみ。Pollen API と課金を有効化。サービスアカウント OAuth は未対応。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
mapType / --map-type	文字列; 値： TREE_UPI, GRASS_UPI, WEED_UPI	はい	必須	ヒートマップ種別：TREE_UPI / GRASS_UPI / WEED_UPI。
x / --x	整数; 0–65535	はい	必須	タイル列番号。0〜2^zoom−1。送信前に検証。
y / --y	整数; 0–65535	はい	必須	タイル行番号。0〜2^zoom−1。送信前に検証。
zoom / --zoom	整数; 0–16	はい	必須	Web Mercator のズーム 0〜16。0 は世界全体を 1 枚で表示。

動作と制約

• 国・指数・季節によって提供範囲が異なります。Google の帰属表示・地図利用・キャッシュ許諾に従ってください。API 有効化でコンテンツ制限が免除されるわけではありません。https://developers.google.com/maps/documentation/pollen/policies

公式の出典: https://developers.google.com/maps/documentation/pollen/policies, https://developers.google.com/maps/documentation/pollen/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile

結果

MIME・キャッシュ情報付きバイナリタイル。MCP は画像、CLI --output はバイト列を保存。

実行例

MCP 引数:

{
  "mapType": "TREE_UPI",
  "zoom": 2,
  "x": 2,
  "y": 1
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_pollen_heatmap --args '{"mapType":"TREE_UPI","zoom":2,"x":2,"y":1}'

maps_weather_history

直近最大 24 時間の気象履歴をページ単位で取得。

直近最大 24 時間の気象履歴をページ単位で取得。

CLI コマンド: weather-history. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
hours / --hours	整数; 1–24	いいえ	Google：24	前の時間帯から遡る 1〜24 時間。
languageCode / --language-code	文字列; 最低 1 文字	いいえ	Google：en	希望する IETF/BCP-47 言語コード。未対応の場合、Google が近い言語を選択します。
location / --location	オブジェクト	はい	必須	照会する位置の座標。
location.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	location 指定時に必須	緯度。−90〜90 度。
location.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	location 指定時に必須	経度。−180〜180 度。
pageSize / --page-size	整数; 1–24	いいえ	履歴：Google 24、その他：Google 既定	ページ件数上限。履歴は 1〜24、警報・分単位予報の実装上限は 1〜1000。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	最初のページ	前回の nextPageToken。他の条件は同じにします。1 回の呼び出しで 1 ページだけ取得します。
unitsSystem / --units-system	文字列; 値： METRIC, IMPERIAL	いいえ	Google：METRIC	単位系。METRIC または IMPERIAL。

動作と制約

• 直近 24 時間のみ。任意の過去日付には未対応。自動ページ取得なし。Google の地域範囲・利用方針が適用。https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

公式の出典: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/history.hours/lookup

結果

ネイティブ historyHours、timeZone、nextPageToken と時間別気象条件。

実行例

MCP 引数:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "hours": 12,
  "pageSize": 6
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_weather_history --args '{"location":{"latitude":48.85,"longitude":2.35},"hours":12,"pageSize":6}'

maps_weather_alerts

指定地点に影響する公的気象警報を、深刻度・発表機関情報とともに取得。

指定地点に影響する公的気象警報を、深刻度・発表機関情報とともに取得。

CLI コマンド: weather-alerts. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
languageCode / --language-code	文字列; 最低 1 文字	いいえ	Google：en	希望する IETF/BCP-47 言語コード。未対応の場合、Google が近い言語を選択します。
location / --location	オブジェクト	はい	必須	照会する位置の座標。
location.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	location 指定時に必須	緯度。−90〜90 度。
location.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	location 指定時に必須	経度。−180〜180 度。
pageSize / --page-size	整数; 1–1000	いいえ	履歴：Google 24、その他：Google 既定	ページ件数上限。履歴は 1〜24、警報・分単位予報の実装上限は 1〜1000。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	最初のページ	前回の nextPageToken。他の条件は同じにします。1 回の呼び出しで 1 ページだけ取得します。

動作と制約

• 提供範囲・遅延・項目は発表機関によります。発表元の帰属表示を保持。警報が空でも安全を保証しません。https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

公式の出典: https://developers.google.com/maps/documentation/weather/policies, https://developers.google.com/maps/documentation/weather/reference/rest/v1/publicAlerts/lookup

結果

ネイティブ weatherAlerts、発表機関・地域情報、存在する場合は nextPageToken。

実行例

MCP 引数:

{
  "location": {
    "latitude": 48.85,
    "longitude": 2.35
  },
  "pageSize": 5
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_weather_alerts --args '{"location":{"latitude":48.85,"longitude":2.35},"pageSize":5}'

maps_weather_minute_forecast

実験機能：6 時間先までの高解像度降水予報をページ単位で取得。

実験機能：6 時間先までの高解像度降水予報をページ単位で取得。

CLI コマンド: weather-minute-forecast. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
location / --location	オブジェクト	はい	必須	照会する位置の座標。
location.latitude	数値; -90.0–90.0	親オブジェクトを指定した場合に必須	location 指定時に必須	緯度。−90〜90 度。
location.longitude	数値; -180.0–180.0	親オブジェクトを指定した場合に必須	location 指定時に必須	経度。−180〜180 度。
pageSize / --page-size	整数; 1–1000	いいえ	履歴：Google 24、その他：Google 既定	ページ件数上限。履歴は 1〜24、警報・分単位予報の実装上限は 1〜1000。
pageToken / --page-token	文字列; 最低 1 文字	いいえ	最初のページ	前回の nextPageToken。他の条件は同じにします。1 回の呼び出しで 1 ページだけ取得します。
unitsSystem / --units-system	文字列; 値： METRIC, IMPERIAL	いいえ	Google：METRIC	単位系。METRIC または IMPERIAL。

動作と制約

• 実験・pre-GA 機能。サポートは限定的で非互換変更の可能性あり。帰属表示が必要。キャッシュは最大 1 時間で、その後削除が必要。
• 主目的が気象情報のアプリ・モデルをこのコンテンツで再現することは禁止。下流利用者にも適用。分単位予報と地図は同期しない場合あり。https://developers.google.com/maps/documentation/weather/minute-forecast

公式の出典: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

結果

overallPredictionTimeframe、timeZone、segments、nextPageToken。種別・確率・量・強度を保持。

実行例

MCP 引数:

{
  "location": {
    "latitude": 37.60451,
    "longitude": -80.59044
  },
  "pageSize": 5
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_weather_minute_forecast --args '{"location":{"latitude":37.60451,"longitude":-80.59044},"pageSize":5}'

maps_weather_map

実験機能：米国・欧州の降水ナウキャスト画像タイルを取得。

実験機能：米国・欧州の降水ナウキャスト画像タイルを取得。

CLI コマンド: weather-map. Google の認証: API キー、または cloud-platform スコープの OAuth トークン。対象 API と課金を有効化。OAuth のクォータプロジェクトには serviceusage.services.use も必要。

引数

引数 / CLI オプション	型とスキーマの制約	必須	省略時の既定値	説明
mapType / --map-type	文字列; 値： US_PRECIPITATION_CURRENT, EU_PRECIPITATION_CURRENT	はい	必須	US_PRECIPITATION_CURRENT または EU_PRECIPITATION_CURRENT。文書記載の米国・欧州地域のみ。
x / --x	整数; 0–65535	はい	必須	タイル列番号。0〜2^zoom−1。送信前に検証。
y / --y	整数; 0–65535	はい	必須	タイル行番号。0〜2^zoom−1。送信前に検証。
zoom / --zoom	整数; 0–16	はい	必須	Web Mercator のズーム 0〜16。0 は世界全体を 1 枚で表示。

動作と制約

• 実験・pre-GA 機能。サポートは限定的で非互換変更の可能性あり。帰属表示が必要。キャッシュは最大 1 時間で、その後削除が必要。
• 主目的が気象情報のアプリ・モデルをこのコンテンツで再現することは禁止。下流利用者にも適用。分単位予報と地図は同期しない場合あり。https://developers.google.com/maps/documentation/weather/minute-forecast
• グリッド座標が有効でもデータ提供があるとは限りません。範囲・条件：https://developers.google.com/maps/documentation/weather/weather-map

公式の出典: https://developers.google.com/maps/documentation/weather/minute-forecast, https://developers.google.com/maps/documentation/weather/weather-map

結果

上流 MIME・キャッシュ情報付き PNG バイナリ。CLI --output で保存、MCP で画像表示。

実行例

MCP 引数:

{
  "mapType": "US_PRECIPITATION_CURRENT",
  "zoom": 12,
  "x": 1025,
  "y": 1688
}

同等の CLI 呼び出し:

mcp-gmap-rs call maps_weather_map --args '{"mapType":"US_PRECIPITATION_CURRENT","zoom":12,"x":1025,"y":1688}'