它有什么作用？

Gravity Forms 的地址自动完成功能，会在用户输入地址时显示 Google 提供的地址建议，帮助用户更快地提交准确的地址。支持两种平台。地址和 单行文本 字段。.

当用户选择建议时，该插件还可以捕获有用的位置元数据（如地点 ID 和坐标）并映射关键地址部分，甚至运行邮政编码查找，以填充专用字段（包括隐藏字段），用于路线规划、自动化或报告。.

特征

更快的地址完成
用户在输入时可获得 Google 提供的建议，从而减少击键次数并加快提交速度。.
适用于地址 + 单行文本字段
启用两种字段类型的自动完成功能，以便您可以保留现有的表单布局。.
解析字段映射
将地址第 1 行、第 2 行、城市/城镇、州/地区、邮政编码和国家/地区发送到同一表单上的任何选定字段（包括隐藏字段）。.
国际友好型地址处理
支持全球地址，并在设置中为美国以外的团队使用国家/地区中立的标签。.
按国家/地区筛选结果
使用 ISO 代码（例如，美国、加拿大、英国）将建议限制为特定国家/地区。.
每个条目都保存了元数据
商店位置 ID、纬度、经度和格式化地址，用于集成、自动化和故障排除。.
兼容 WordPress 多站点
网络激活一次即可在所有子站点上使用。（网络模式仅适用于无限流量套餐。）
翻译就绪
与您选择的翻译插件完全兼容。暂不包含预翻译，但即将推出)
邮政编码查询
将单个字段转换为邮政编码搜索，自动填充您的城市和州/地区字段（包括隐藏字段）——非常适合“检查您所在地区”表单和 CRM 路由。.

跳转至功能详情

如何启用插件？

购买 Gravity Forms 的地址自动填充功能后，您需要：

在您的WordPress网站上安装该插件。.
生成并输入您的 Google API 密钥。.
启用地址自动完成功能或单行文本字段。.

以下说明将向您展示如何安装插件，生成地址自动完成的 Google API 密钥，并在地址字段或单行文本字段中启用它。.

向 Plugin Brewery 注册插件

生成并输入 Google API 密钥

在使用地址自动填充功能之前，您需要在 Google Cloud Platform 控制台中生成 API 密钥。.

启用地址字段

启用单行文本字段

生成 Google API 密钥

创建或选择现有 Google Cloud 项目

在获取 Google API 密钥之前，您需要…… 创建一个新的 Google Cloud Platform 项目（或者如果您已有项目，请选择一个）。.

注意：如果您要创建一个新的 GCP 项目，我们建议您将其范围限定在您正在开发的网站范围内，以防您需要为同一个网站使用其他 Google API 服务。.

启用所需 API

创建或选择 Google Cloud 项目后，请导航至“API 和服务”>“API 库”，然后启用以下 API：

注意：启用 Places API 前，Google 要求您将结算帐户关联到您的项目。大多数网站的使用量都在 Google 的免费套餐范围内，但仍需要提供付款方式。.

地点 API（新增）

快速链接

您可能会注意到“Places API”和“Places API（新版）”——我们的插件旨在与“Places API（新版）”兼容。”

地图 Javascript API

快速链接

生成密钥

现在您的项目中已经启用了这两个 API，您可以生成 API 密钥了。.

前往 API 和服务 > 凭证, 然后点击“+ 创建凭据”，最后点击“API 密钥”。”

侧边会弹出一个对话框，您可以在其中为密钥命名。.

此时，您可以向下滚动并点击“创建”，您的密钥将立即生成，但是……您应该在下一步中设置限制，以防止未经授权使用您的密钥。.

注意：这一点非常重要！密钥是公开可见的，所以您肯定不希望任何不法分子窃取您的免费使用权。

继续滚动对话框，找到“应用程序限制”部分。.

在“应用程序限制”下选择“网站”。”

在“网站限制”下，添加需要使用 API 密钥的网站。请勿添加 https。.

我们建议添加通配符域名，以确保密钥在 www 和非 www 域名上都能正常工作，如下所示： *.example-website.com/*

点击创建，您的密钥将显示在下方。.

您的 API 密钥已创建！复制密钥，并将其粘贴到插件的地址自动完成设置中，即可完成设置！

域名格式： 请按以下格式将每个域名分别输入在单独的一行中： example.com/* - 不 https://, 域名本身没有尾部斜杠，但包含 /* 最后允许所有页面。涵盖所有子域名（例如 www），添加一个单独的条目作为 *.example.com/*. 对于本地开发，请使用 localhost 或 localhost:3000/* 取决于你的配置。.

yourdomain.com/*
*.yourdomain.com/*
staging.yourdomain.com/*
localhost:8080/*

谷歌服务条款和隐私政策

Plugin Brewery 地址自动填充功能会将表单数据发送到 Google 服务以进行地址查找。根据 Google 的指南，任何使用 Places API 的应用程序都应该显示指向 Google 网站的链接。服务条款和隐私政策.

根据您所在的国家或地区，您可能还需要在收集位置数据之前获得用户同意。.

功能详情

支持的字段类型

适用于 Gravity Forms 的两种字段类型：

地址字段（多输入）
单行文本（单行地址输入）

当您需要原生 GF 地址子字段时，请使用地址字段；当您需要更简单的表单布局时，请使用单行文本。.

已解析地址映射（新增）

将选定的地址组成部分映射到表单中的相应字段：

地址第一行
地址行 2
邮政/邮政编码
城市/城镇
州/省/地区
国家

非常适合用于配送区域检查、CRM 路由、条件通知和自动化中的隐藏字段。.

邮政编码查询（新增）

将单行文本字段转换为邮政编码搜索。启用地址自动完成功能，然后在字段的高级设置中启用邮政编码查找功能。.

建议仅限于邮政编码。
该字段仅保留选定的代码（而非完整地址）。
城市、州/地区（如果已绘制地图，则包括国家/县）会自动填充，包括隐藏字段。
适用于任何拥有邮政编码的国家/地区

非常适合用于服务区域检查、发货逻辑以及向您的 CRM 发送干净的位置数据。.

单行文本邮政/邮政编码处理

对于单行文本字段，该插件使用 Google 格式化的地址，并在显示文本中缺少邮政编码时自动添加。如果 Google 搜索结果中没有邮政编码，则无法添加。.

元数据已保存到条目元数据

当用户选择建议时，插件会存储：

地点 ID
纬度
经度
格式化地址

国家/地区限制 + 国际支持

您可以将建议范围限制在具有 ISO alpha-2 代码的特定国家/地区（例如： US,CA,GB或者留空，以适应全局形式。.

标签和映射选项与国家/地区无关，因此美国团队和非美国团队的工作流程仍然清晰。.

性能 + 兼容性

专为实际生产现场设计：

前端脚本仅在启用字段存在时才会初始化。
适用于标准和 AJAX Gravity Forms 流程
与大多数配置中的常见缓存/CDN 设置兼容

合并标签

当访客选择自动完成建议时，插件可以存储该条目的元数据。您可以将这些数据插入到确认信息、通知以及其他支持 Gravity Forms 合并标签的位置。.

格式： {pb_aac:ID:KEY}

将 ID 替换为启用了地址自动完成功能的地址或单行文本字段的字段 ID（即显示建议的字段）。.

可用密钥（KEY):

钥匙	它的输出
`place_id`	Google 地点 ID
`lat`	纬度
`lng`	经度
`formatted`	格式化地址（谷歌格式化字符串）
`google_maps_url`	根据地点 ID（如果缺少地点 ID，则使用纬度/经度）构建的 Google 地图搜索 URL

例如（如果您的自动完成字段是第 12 个字段）：

{pb_aac:12:place_id}
{pb_aac:12:lat}
{pb_aac:12:lng}
{pb_aac:12:formatted}
{pb_aac:12:google_maps_url}

选择器：在表单编辑器中，已启用的字段也会在合并标签选择器中获得这些标签，标签如下：“地址自动完成：…”。.

笔记： 只有在选择了建议并保存了元数据的情况下，才会存在值；否则，标签将解析为空（这是设计使然）。.

常见问题解答

Google Places API 是免费的吗？

Google 会自动在您的帐户中每月充值 $200 的额度，您的 Places API 使用费用将从该额度中扣除。对于大多数网站而言，这足以覆盖所有费用——按当前费率计算，每月大约 10,000 次自动填充会话都在该额度范围内。.

也就是说，价格可能会变动，所以请查看相关信息。 Google 地图平台定价表获取最新数据。.

我可以将其与“单行文本”字段一起使用吗？

是的！除了标准的地址字段外，您还可以为任何单行文本字段启用自动完成功能。这对于只需要输入单个地址的表单来说非常理想。.

它适用于国际地址吗？

当然。该插件支持来自谷歌的全球地址数据。.

安装过程复杂吗？

完全没问题。只需在插件设置中添加您的 Google API 密钥，启用所选字段的自动完成功能，就完成了。就这么简单。.

我可以将搜索结果限定在特定国家吗？

是的。在字段设置中，提供以逗号分隔的 ISO 3166-1 alpha-2 国家/地区代码列表（例如，, US,CA,GB).

我应该在 Google Cloud 中启用哪个 Places API？

由于旧版“Places API”计划停用，请启用“Places API（新版）”，并启用“Maps JavaScript API”。.

我可以在通知或集成中使用地址元数据吗？

是的。地址自动填充功能会添加地点 ID、纬度、经度、格式化地址和 Google 地图网址的合并标签。您可以在任何通知、确认或信息流映射中使用 Gravity Forms 的合并标签选择器。.

开发者能否自定义谷歌的搜索结果？

是的。使用 pb_aac_request 使用 JavaScript 过滤器调整请求——例如，将结果偏向某个区域、添加边界框或扩大范围以包含企业。.

我可以将某个字段用作邮政编码查询吗？

是的。在单行文本字段中，启用“地址自动完成”功能，然后启用“邮政编码查找”功能。该字段会显示邮政编码建议，选择其中一个建议后，系统会自动填充您选择的城市和州/地区字段（包括隐藏字段）。这非常适合“查询您所在区域”类型的表单和 CRM 路由。.

	登录您的 WordPress 网站，然后导航至“插件”>“添加插件”>“上传插件”>“安装 zip 文件”并激活它。. 激活后，该插件会出现在“表单”>“附加组件”>“已安装”中，其设置位于“表单”>“设置”>“地址自动完成”下。.
	在左侧导航栏中，依次点击“表单”>“设置”>“地址自动填充”>“许可证”。输入您的许可证密钥并激活。接下来，请继续进行下方的 Google API 密钥生成设置。.

	启用 Google 地点 API（新增）以及谷歌 Maps JavaScript API. 请参阅说明
	创建并限制 Google API 密钥。. 请参阅说明
	请输入 Google API 密钥。.

	在表单中添加地址字段。.
	打开字段设置，导航至先进的部分，并启用地址自动补全复选框。.

	在表单中添加单行文本字段。.
	打开字段设置，导航至先进的部分，并启用地址自动补全复选框。.