> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps

> 配置工作流步骤，通过已连接账户进行地理编码、地点搜索和路线计算

当你希望工作流步骤对地址进行地理编码、搜索地点、获取地点详情、计算路线或查询时区时，请使用 **Google Maps**。

## 配置

| 选项    | 必填 | 说明                                                                                           |
| ----- | -- | -------------------------------------------------------------------------------------------- |
| 名称    | 否  | 工作流画布中步骤的标签。                                                                                 |
| 身份验证  | 是  | 此步骤使用的已连接 Google Maps 账户。                                                                    |
| 操作    | 是  | 要执行的地图操作（例如文本搜索、地理编码 API、获取路线）。                                                              |
| 参数    | 是  | 根据操作 schema 自动生成的表单字段。每个文本字段都有 **插入变量** 按钮，可注入 `{{placeholder}}` 值。还提供 **原始 JSON** 标签页供高级使用。 |
| 步骤失败时 | 否  | 控制此步骤失败时工作流应 **终止工作流** 还是 **继续**。                                                            |

在配置此步骤之前，请通过 OAuth 流程在工作区的 **集成** 中连接 Google Maps。

## 可用操作

工作流操作选择器显示一组精选的位置查询和路线相关操作：

| 操作                | 说明               |
| ----------------- | ---------------- |
| Text Search       | 使用自由文本查询搜索地点。    |
| Nearby Search     | 在圆形区域内搜索地点。      |
| Get Place Details | 按 ID 获取地点详情。     |
| Autocomplete      | 为部分输入返回地点预测。     |
| Geocoding API     | 将地址转换为坐标或反向地理编码。 |
| Get Route         | 计算包含距离和时长的路线。    |
| Get Time Zone     | 查询地点的时区。         |

瓦片、航拍视频和设备地理定位操作不会出现在工作流操作选择器中。

## 注意事项

* 此步骤依赖工作区中已连接的 Google Maps 集成。
* Google Maps API 配额和计费同样适用于工作流操作。
* OAuth 连接流程中可能显示第三方授权品牌。

## 将 Google Maps 用作智能体工具

你也可以在 **智能体编辑器** 中将 Google Maps 添加为工具。

另请参阅：[集成](../../../workspace/integrations)、[创建与编辑](../../creating-and-editing) 和 [测试与迭代](../../testing-and-iteration)