工具参考

全部 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 参数:

json

{
  "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 个字符	是	—	一个或多个有序邮政地址行。
`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 可能推断该值	两个大写字母的国家/地区代码，建议提供以消除地址歧义。
`sessionToken` / `--session-token`	字符串; 至少 1 个字符	否	不提供；不结束 Autocomplete 会话	可选调用方管理的 Autocomplete 会话令牌，最多 36 个 URL 安全 ASCII 字符；与此前预测使用同一令牌结束合格会话。所有请求须来自同一 Cloud 项目；结束后换新令牌。

行为与限制

验证判定不是投递保证。
地区/API 覆盖情况不同。此工具不会提交验证反馈或自动接受修正。

结果

完整验证响应，通常包含 result.verdict、result.address、result.geocode 和 responseId；Google 可能省略不可用字段。

示例

MCP 参数:

json

{
  "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，足以覆盖工具最多五天的请求；不会自动获取额外页面。
可用性取决于地点、季节与 Google 覆盖情况。

结果

原始 Pollen 响应，包含 regionCode、dailyInfo 和可能的 nextPageToken。每天可包含花粉类型与植物信息。

示例

MCP 参数:

json

{
  "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 中恰好一种。
`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 默认使用正常营业地点	允许的营业状态。
`priceLevels` / `--price-levels`	字符串数组; 1–5 项; 可选值： `PRICE_LEVEL_FREE`, `PRICE_LEVEL_INEXPENSIVE`, `PRICE_LEVEL_MODERATE`, `PRICE_LEVEL_EXPENSIVE`, `PRICE_LEVEL_VERY_EXPENSIVE`	否	全部价格等级	允许的价格等级。

行为与限制

必须且只能提供一种区域形式。CLI 中嵌套对象以 JSON 传入，子参数没有独立选项。
多边形环必须闭合。Google 还会检查几何、支持的类型、面积和覆盖情况。
仅数量不超过 100 时可取得地点 ID。工具不会自动请求 Place Details。

结果

Google 响应包含 count（通常为 int64 字符串），请求并可用时包含 placeInsights[].place 地点资源。

示例

MCP 参数:

json

{
  "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。此工具不请求限速。

结果

原始 Roads 响应，包含 snappedPoints 与可能的 warningMessage。点在有值时保留道路 placeId、location 和 originalIndex。

示例

MCP 参数:

json

{
  "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 点寻找附近道路段，不把它们解释为一条连续轨迹。

CLI 命令: nearest-roads. Google 访问凭据: 本实现要求 API 密钥。

参数

参数 / CLI 选项	类型与模式限制	必填	省略时的默认值	说明
`points` / `--points`	对象数组; 1–100 项	是	—	需要匹配的独立坐标对象。
`points[].latitude`	数值; -90.0–90.0	提供父对象时必填	—	WGS84 纬度，十进制度数，向北为正。
`points[].longitude`	数值; -180.0–180.0	提供父对象时必填	—	WGS84 经度，十进制度数，向东为正。

行为与限制

一个点可能匹配多个道路段，应保留 originalIndex，不要假定一个输入只对应一个输出。
此工具不请求限速。

结果

原始 Roads 响应，包含 snappedPoints、道路 placeId、location 及映射回输入点的 originalIndex。

示例

MCP 参数:

json

{
  "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 参数:

json

{
  "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 条结果，不返回也不自动跟进分页令牌。
营业/评分数据是否缺失取决于 Google 覆盖情况；不要将此搜索视为穷尽清单。

结果

最多 20 个 Google Place 对象的数组，包含选定搜索字段、Maps/来源链接及归属元数据。

示例

MCP 参数:

json

{
  "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。地址/地标中心还需要 API 密钥进行 Geocoding 解析。

参数

参数 / 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 参数:

json

{
  "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 会话令牌，最多 36 个 URL 安全 ASCII 字符；与此前预测使用同一令牌结束合格会话。所有请求须来自同一 Cloud 项目；结束后换新令牌。

行为与限制

每张选定照片可能增加一次请求；照片数为零可避免这些调用。
工具采用固定详情字段掩码，并不请求全部 Google Place 字段。不可用字段可能不存在。

结果

请求字段掩码对应的原生 Google Place 对象。请求照片时，photoUrls 包含媒体 URL、照片作者归属和来源链接。

示例

MCP 参数:

json

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

等效 CLI 调用:

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

maps_directions

获取两个地点间的路线、导航步骤与距离/时间总计。

计算两端点之间的路线，同时提供选定 Google 路线数据和标准化总计。

CLI 命令: directions. Google 访问凭据: Routes/Places 支持 API 密钥或 OAuth。命名地点还需 API 密钥进行 Geocoding；精确坐标字符串可避免该查询。

参数

参数 / 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 个字符	否	不提供	出发时间，RFC 3339 格式，包含 Z 或显式 UTC 偏移。
`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 计费项；无需分段详情时保持 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 计费。交通区间约定；当前计费触发条件。
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 参数:

json

{
  "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 个字符	否	不提供	出发时间，RFC 3339 格式，包含 Z 或显式 UTC 偏移。
`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 请求可能按多个元素计费。

结果

对象包含 origin_addresses、destination_addresses、按行优先排列的 distances、durations 和 errors 数组。成功单元格单位为米/秒；失败或缺失单元格保持 null。

示例

MCP 参数:

json

{
  "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 参数:

json

{
  "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 偏移与当地时间。

解析某一时刻的时区标识、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 参数:

json

{
  "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 单位与分页信息。

查询精确坐标的当前天气，或一页每日/每小时预报数据。

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；非 forecast_hourly 类型会忽略 forecastHours。
不会自动跟进分页令牌。请求时段可能超过单页返回的记录数。
覆盖范围与预报可用性由 Google 决定。

结果

原生 Weather 响应，依 type 返回当前天气字段、forecastDays 或 forecastHours。保留单位、时间戳和可能的 nextPageToken。

示例

MCP 参数:

json

{
  "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 经度，十进制度数，向东为正。

行为与限制

建议来自提供方数据，不是个性化医疗评估。
此工具只公开当前情况，不提供历史或预报端点。

结果

原生 Air Quality 当前情况响应，包含指数，以及 Google 提供时可选的 healthRecommendations/pollutants。

示例

MCP 参数:

json

{
  "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 至少提供一个。
完整请求 URL 必须不超过 16,384 字符。模式的 size 格式范围比运行时 640 像素上限更宽。
标记/路径样式遵循 Google Static Maps 语法。Google 归属保留在渲染图像中。

结果

MCP 返回内嵌 image/png 内容。CLI 返回 {mimeType,base64} JSON，指定 --output 时返回原始 PNG 字节。

示例

MCP 参数:

json

{
  "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 个字符	是	—	需要解析的地址/地标字符串。

行为与限制

使用受限并发，每进程最多五个活动 Google 请求。
逐项失败不会强制 CLI 非零退出；检查每行的 success/error。

结果

按输入顺序返回数组。每行包含 address、success，以及 data（地理编码对象）或 error。

示例

MCP 参数:

json

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

等效 CLI 调用:

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

maps_explore_area

解析一个位置，按类别探索附近地点并扩展各类别的首批详情。

解析一个位置，在周边查询选定类别，并仅扩展各类别的领先结果。

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 参数:

json

{
  "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 个中间点，并保留精确坐标。

为有序停靠点规划单条路线，可选请求 Google 重排中间点，同时保持起终点固定。

CLI 命令: plan-route. Google 访问凭据: Routes/Places 支持 API 密钥或 OAuth。命名地点还需 API 密钥进行 Geocoding；精确坐标字符串可避免该查询。

参数

参数 / CLI 选项	类型与模式限制	必填	省略时的默认值	说明
`avoid_highways` / `--avoid-highways`	布尔值	否	false	避开高速公路；仅驾车支持 true。
`avoid_tolls` / `--avoid-tolls`	布尔值	否	false	避开收费道路；仅驾车支持 true。
`departure_time` / `--departure-time`	字符串; 至少 1 个字符	否	不提供	出发时间，RFC 3339 格式，包含 Z 或显式 UTC 偏移。
`mode` / `--mode`	字符串; 可选值： `driving`, `walking`, `bicycling`, `transit`	否	driving	出行方式。驾车采用考虑交通状况的路线。
`optimize` / `--optimize`	布尔值	否	true，但受上述条件限制	当总停靠点超过三个且模式不是 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 计费项；无需分段详情时保持 false。

行为与限制

公共交通只支持两个端点，不允许中间停靠点。
只有总停靠点至少四个（至少两个中间点）时优化才生效。
此工具优化单条路线的停靠顺序，不进行车队的车辆/任务分配。
trafficSegments=true 时，Routes 返回 NORMAL、SLOW、TRAFFIC_JAM 交通区间。路线及各路段的标准化分段分别引用自己的折线，点索引互相独立。Google 区间为 [start,end)；分段几何保留共享的结束边界顶点，以覆盖最后一条边。覆盖缺失或无效会明确报告，不会臆造正常交通。
segmentMetadata.retrievedAt 是本地取得响应的时间，不是提供方观测交通的时间；Routes 不返回该观测时间，因此 trafficObservedAt 为 null。该 Routes 响应也不返回道路类别和限速，因此 roadCategory、speedLimit 为 null。不隐式调用 Roads，不在客户端乘以时长系数；时长保持 Google 的预测值。
本程序的交通分段需显式开启且仅支持驾车。此选项请求含交通信息的折线，并触发 Compute Routes Enterprise 计费。交通区间约定；当前计费触发条件。
polylineQuality 选择 Google 返回的几何细节：HIGH_QUALITY 使用更多点，响应更大且延迟可能更高。trafficSegments=true 时仍可显式选择 OVERVIEW。省略质量时，交通分段默认 HIGH_QUALITY；否则使用 Google 的 OVERVIEW。程序不合成或插值补充细节。几何质量独立于 extraComputations：仅选择 HIGH_QUALITY 不会启用 TRAFFIC_ON_POLYLINE。PolylineQuality 官方定义。

结果

对象包含 mode、实际生效的 optimized、按顺序解析的 stops、显示用 legs、total_distance、total_duration、polyline 与警告。路段 durationSeconds 为数值秒。 trafficSegments=true 时，路线和各路段还包含标准化 segments 与 segmentMetadata。

示例

MCP 参数:

json

{
  "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 参数:

json

{
  "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，而不是用一次圆形搜索近似行程。

CLI 命令: search-along-route. Google 访问凭据: Routes/Places 支持 API 密钥或 OAuth。命名地点还需 API 密钥进行 Geocoding；精确坐标字符串可避免该查询。

参数

参数 / 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 参数:

json

{
  "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 和逐点错误。

在地理网格的每个点，测量目标地点是否出现在文本搜索前 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 个字符	否	不提供	一到三个搜索关键词；两种形式同时提供时优先采用此项。
`placeId` / `--place-id`	字符串; 至少 1 个字符	是	—	目标地点 ID，可带 places/ 前缀。

行为与限制

keyword 或 keywords 至少提供一个；逐行模式无法表示此二选一要求。
搜索请求数量为关键词数 × gridSize²，重试前最多 147 次。
失败点不计入排名指标，不作为有效未命中。没有可用观测时指标可能为 null。
搜索排名不是目标的用户评论评分。结果是带位置偏向的文本搜索样本，不保证用户在 Google Maps 看到的排名。

结果

对象包含 target、grid_size、grid_spacing_m 及逐关键词的指标/网格。ARP 平均已找到的排名；ATRP 对成功查询但未找到目标时计为 21；SoLV 为成功点中进入前 3 名的点所占的百分比。failed_points 与 found_in 表示覆盖情况。

示例

MCP 参数:

json

{
  "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 不足以取得访问权。

CLI 命令: speed-limits. Google 访问凭据: 本实现使用 API 密钥；即使选择 OAuth 模式，这些端点仍需要密钥。

参数

参数 / CLI 选项	类型与模式限制	必填	省略时的默认值	说明
`path` / `--path`	对象数组; 1–100 项	否	不提供	1–100 个 GPS 坐标；与 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 个字符	否	不提供	1–100 个道路贴合/最近道路调用返回的路段 ID；普通商家 ID 可能没有限速。与 path 互斥。
`units` / `--units`	字符串; 可选值： `KPH`, `MPH`	否	KPH	速度单位 KPH（公里/小时）或 MPH（英里/小时）。

行为与限制

需要 Asset Tracking 访问权；部分迁移后的 Premium 项目可保留权限，普通结算账号并不代表已获许可。https://developers.google.com/maps/documentation/roads/speed-limits
每条返回的 speedLimits 可计费，一次请求可产生多项费用。可变限速返回汽车最大限速；非实时，可能缺失、估计或过时，以现场标志为准。
403 保留脱敏后的 Google 原因和访问提示；API、密钥限制、权限也可导致拒绝，不把所有 403 都判为许可问题。

官方来源: https://developers.google.com/maps/documentation/roads/speed-limits

结果

返回完整原生 speedLimits、可选 snappedPoints、警告和元数据。

示例

MCP 参数:

json

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

等效 CLI 调用:

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

maps_autocomplete

输入过程中获取 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 项	否	所有地区	最多 15 个双字母 CLDR 地区代码，与位置限制取交集；空数组不限制。
`input` / `--input`	字符串; 至少 1 个字符	是	—	非空查询文字，可为部分地点名或地址。
`inputOffset` / `--input-offset`	整数; 0–4294967295	否	输入末尾	从零开始的 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 米；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 米；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}$`	否	不提供	格式/排名用双字母 CLDR 地区，不会将结果限制在该地区。
`sessionToken` / `--session-token`	字符串; 至少 1 个字符; 模式： `^[A-Za-z0-9_-]+$`	否	不分组会话；按请求计费	调用方生成的 URL 安全令牌，最多 36 个 ASCII 字符；每次会话建议新 UUID v4，并传给结束会话的 details/validate-address。

行为与限制

令牌由调用方管理，不自动创建或结束会话。所有请求使用同一 Cloud 项目的凭据，以合格的 Place Details/Address Validation 结束，再换新令牌；遗漏/复用可按次计费。
圆半径最多 50km，限制圆必须大于零；矩形纬度须有序，支持跨反子午线。显示时保留 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 参数:

json

{
  "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 回退。

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 需至少两个不同的固定接入点；本地管理/保留 MAC、移动热点可能无结果。结果可能 NOT_FOUND，使用前检查 accuracy。

官方来源: https://developers.google.com/maps/documentation/geolocation/requests-geolocation

结果

返回原生 location 和 accuracy（米），保留 Google 错误；估计值不是精确定位。

示例

MCP 参数:

json

{
  "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。

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 必填，只传 ID 不传 URL。
`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 米；各原生图层可能更粗。
`radiusMeters` / `--radius-meters`	数值; 无边界–1000	否	不提供	data_layers 必填正半径，最大 1000 米；超过 100 米须 ≤ pixelSizeMeters×1000；超过 175 米须排除月通量/逐小时阴影。
`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 米内无建筑可 NOT_FOUND。图层 URL 临时有效且需认证；geo_tiff 只从 solar.googleapis.com 固定端点获取，不访问任意 URL。https://developers.google.com/maps/documentation/solar/coverage
GeoTIFF 限 16 MiB 及工具时限；大栅格需缩小半径/增大像素。EXPANDED_COVERAGE 为 pre-GA；EEA 可能缺少字段或使用不同条款。端点分别计费；显示须保留 Google 署名。本工具不设计太阳能安装方案。

官方来源: 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 参数:

json

{
  "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。

CLI 命令: aerial-view. Google 访问凭据: 本实现使用 API 密钥；即使选择 OAuth 模式，这些端点仍需要密钥。

参数

参数 / CLI 选项	类型与模式限制	必填	省略时的默认值	说明
`address` / `--address`	字符串; 至少 1 个字符	否	不提供	受支持的美国邮政地址；与 videoId 恰好选一个。
`operation` / `--operation`	字符串; 可选值： `lookup`, `metadata`	否	lookup	lookup 获取播放 URL 和元数据（计费）；metadata 仅查元数据（Google 免费方法）。
`videoId` / `--video-id`	字符串; 至少 1 个字符	否	不提供	此前返回的视频 ID；与 address 恰好选一个。

行为与限制

仅支持有 3D 覆盖的美国地址。无视频可 NOT_FOUND；创建需显式 maps_render_aerial_video。处理中合理间隔查询 metadata；lookup 获取播放地址本身计费。
播放 URL 很快过期，每次展示重新获取。Google 禁止下载/存储/缓存视频；仅视频 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 参数:

json

{
  "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 视频。

CLI 命令: render-aerial-video. Google 访问凭据: 本实现使用 API 密钥；即使选择 OAuth 模式，这些端点仍需要密钥。

参数

参数 / CLI 选项	类型与模式限制	必填	省略时的默认值	说明
`address` / `--address`	字符串; 至少 1 个字符	是	—	待渲染的受支持美国邮政地址。

行为与限制

操作会改变渲染队列，不自动重试、不等待完成，也不下载视频。使用 maps_aerial_view metadata 查进度，需要播放时再 lookup。
US/3D 覆盖、配额和条款适用；API 已启用也不保证可渲染。禁止下载、保存、缓存视频，需按要求署名。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

结果

返回原生 render 响应；PROCESSING 表示排队/处理中，已有视频可立即 ACTIVE。

示例

MCP 参数:

json

{
  "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 地图瓦片、会话及归属元数据，供合规地图可视化使用。

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 用 1–100 个原生位置对象，均含 lat、lng。
`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 米	全景 ID/经纬度元数据搜索半径，0–100000 米；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 必填，原生 createSession 选项；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}$`	提供父对象时必填	不提供；所述操作需要时必填	用户物理位置的双字母大写 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。不接受当前操作无关的参数；不提供网页/原生渲染器或图像拼接。
仅限地图可视化；禁止未经许可预取、索引、保存、缓存、提取或将影像提交代理做图像解读。遵守 Cache-Control、ETag 和合同。https://developers.google.com/maps/documentation/tile/policies
保留 Google Maps 标志和提供方归属：2D 用 viewport copyright；Street View 用 metadata copyright 及问题报告链接；3D 展示瓦片版权。不可裁剪隐藏。
覆盖、EEA 条款、收费和配额可能不同；会话以返回 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 参数:

json

{
  "operation": "root_3d"
}

等效 CLI 调用:

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

maps_streetview

查询 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 恰好选一个。
`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 米。
`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 恰好一个。image 专用相机/尺寸参数不能用于 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 返回 JPEG 字节及 MIME/缓存元数据。

示例

MCP 参数:

json

{
  "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 照片和序列，显式上传、发布、修改元数据或删除公开内容。

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 用 1–100 个照片 ID。
`photoSequence` / `--photo-sequence`	对象	否	不提供；所述操作需要时必填	create_sequence 的原生 PhotoSequence，需 uploadReference.uploadUrl 及媒体对应 GPS/CAMM/IMU、拍摄元数据。
`sequenceId` / `--sequence-id`	字符串; 至少 1 个字符	否	不提供；所述操作需要时必填	get_sequence/delete_sequence 用序列 ID，创建返回的操作名称中携带该 ID。
`updateMask` / `--update-mask`	字符串; 至少 1 个字符	否	不提供；所述操作需要时必填	update 必填原生 FieldMask，逗号分隔，如 pose.heading、pose.latLngPair。
`updatePhotoRequests` / `--update-photo-requests`	对象数组; 1–100 项	否	不提供；所述操作需要时必填	batch_update 的 1–100 个 UpdatePhotoRequest，均需 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 参数:

json

{
  "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 对象异步导入。

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–500。
`pageToken` / `--page-token`	字符串; 至少 1 个字符	否	第一页	上一响应的 nextPageToken；其他请求参数须保持一致。每次仅获取一页。
`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 参数:

json

{
  "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 的容量、时间窗和成本约束。

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 仅查询一次状态。
`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；Google 验证 shipments、vehicles 和约束。batch 需 1–100 个 modelConfigs，包含 GCS 输入/输出 URI 及 JSON/PROTO_TEXT dataFormat。URI 需 input.uri/output.uri，gs:// 路径以 .json/.txtpb 结尾。

行为与限制

原生模型和请求定义：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 当前不支持 operation 的 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 参数:

json

{
  "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 小时的空气质量预报。

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}$`	提供父对象时必填	每个覆盖项必填	应用指数覆盖的双字母国家/地区代码。
`dateTime` / `--date-time`	字符串; 至少 20 个字符	否	选择一种时间方式	单个 RFC3339 UTC 时间，必须以 Z 结尾；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；其他请求参数须保持一致。每次仅获取一页。
`period` / `--period`	对象	否	选择一种时间方式	包含结束时刻的有序时间区间；预报跨度不超过 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	是否包含通用空气质量指数。

行为与限制

必须选择且仅选择一种时间方式：历史用 hours/dateTime/period，预报用 dateTime/period。本地验证 UTC 时间和区间；Google 验证可用时间与地区。
每次仅一页，使用 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 参数:

json

{
  "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 天的历史空气质量。

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}$`	提供父对象时必填	每个覆盖项必填	应用指数覆盖的双字母国家/地区代码。
`dateTime` / `--date-time`	字符串; 至少 20 个字符	否	选择一种时间方式	单个 RFC3339 UTC 时间，必须以 Z 结尾；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–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；其他请求参数须保持一致。每次仅获取一页。
`period` / `--period`	对象	否	选择一种时间方式	包含结束时刻的有序时间区间；预报跨度不超过 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	是否包含通用空气质量指数。

行为与限制

必须选择且仅选择一种时间方式：历史用 hours/dateTime/period，预报用 dateTime/period。本地验证 UTC 时间和区间；Google 验证可用时间与地区。
每次仅一页，使用 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 参数:

json

{
  "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 瓦片。

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 级只有一块瓦片。

行为与限制

可用性取决于国家、指数和季节。必须遵守 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 参数:

json

{
  "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 级只有一块瓦片。

行为与限制

可用性取决于国家、指数和季节。必须遵守 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 参数:

json

{
  "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 小时的天气历史。

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；其他请求参数须保持一致。每次仅获取一页。
`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 参数:

json

{
  "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；其他请求参数须保持一致。每次仅获取一页。

行为与限制

覆盖、延迟和字段取决于发布机构。保留来源归属；没有返回警报并不保证安全。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

结果

返回 Google 原生 weatherAlerts、机构/地区字段和可用的 nextPageToken。

示例

MCP 参数:

json

{
  "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

实验功能：分页获取未来六小时的高分辨率降水预报。

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；其他请求参数须保持一致。每次仅获取一页。
`unitsSystem` / `--units-system`	字符串; 可选值： `METRIC`, `IMPERIAL`	否	Google：METRIC	单位制：METRIC 或 IMPERIAL。

行为与限制

实验/pre-GA 功能：支持有限，可能不兼容变更。Google 要求归属显示，最多缓存一小时，之后必须删除缓存。
禁止用这些内容重建主要用途为天气信息的应用/模型；下游调用者同样受约束。分钟预报与地图可能不同步。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 参数:

json

{
  "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 级只有一块瓦片。

行为与限制

实验/pre-GA 功能：支持有限，可能不兼容变更。Google 要求归属显示，最多缓存一小时，之后必须删除缓存。
禁止用这些内容重建主要用途为天气信息的应用/模型；下游调用者同样受约束。分钟预报与地图可能不同步。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 参数:

json

{
  "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}'

工具参考 ​

调用约定 ​

工具 ​

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_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

参数