注意:此 API 的 v4.7 版本已发布!请参阅更新日志。仍暂时允许在链中提供与新冠肺炎 (COVID-19) 相关的帖子。

搜索匹配的商家信息

借助 Google My Business API,您可以为您的商家创建一个平台,以便在 Google 上管理其商家。在您的平台上,您可以允许合作伙伴搜索与其商家名称、地址和电话数据匹配的商家信息。他们可以建立对营业地点的所有权,还能通过纬度和经度准确定位商家的实际营业地点。

准备工作

在使用 Google My Business API 之前,您需要注册您的应用并获取 OAuth 2.0 凭据。要详细了解如何开始使用 Google My Business API,请参阅基本设置

如何使用地址数据

要在您的平台上使用地址和地理定位数据,您可以使用两组不同的 API 和资源:Google My Business API 和 Maps API。

常用的“Google 我的商家”资源

借助 GoogleLocations API,商家可以提前了解某个营业地点是否已在“Google 我的商家”中声明了所有权。如果没有,商家可以立即请求访问该营业地点。

PostalAddress 对象表示商家的实际地址。

常用的 Google 地图资源

Maps JavaScript 地点微件通常在合作伙伴工作流程中用于创建交互式地图。此外,以下 Maps API 也很有用:

一个或零个匹配项

当合作伙伴搜索某个营业地点的匹配商家信息时,其目标是将搜索结果的范围缩小到一个或零个匹配项。这分别意味着该营业地点要么符合其搜索条件,要么在“Google 我的商家”中尚不存在。

如果存在一个或零个匹配项,请使用 accounts.locations.create 方法创建新的商家信息,或按照 GoogleLocations 指南声明对现有商家信息的所有权。如果 Google 无法对地址进行地理编码,营业地点的创建会失败,并且该 API 响应会包含对 LatLng 数据的请求。要了解商家如何提供其 LatLng 数据,请参阅手动调整地理位置数据

确定 LatLng 坐标后,系统即会创建新的商家信息。

部分匹配项和多个匹配项

当企业主或合作伙伴的运营团队搜索与某营业地点匹配的商家信息时,他们输入的信息可能仅会收到一个部分匹配项,也可能会收到多个与其搜索查询匹配的匹配项。要将搜索结果的范围缩小到一个或零个匹配项,可通过两个 Maps API 用例手动解析部分匹配项和多个匹配项。

如果合作伙伴平台的用户搜索某个营业地点,然后遇到多个部分匹配项,他们可以通过以下方式之一解决问题:

  • 分析部分匹配的地址并选择正确的地址。
  • 修改或重新键入地址的各个部分,以便提高准确性,并将其结果范围缩小到一个或零个匹配项。
一位用户在进行地址搜索后,收到了几个部分匹配项。

用户从一个或多个完全匹配项中选择

在某些情况下,多个营业地点可能与用户搜索的地址完全匹配。例如,用户可以在合作伙伴平台中输入了以下地址:

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

假设返回了以下响应,所有这些响应都与指定的地址匹配:

  • Kasperson Printer Center,一个未通过验证的营业地点。
  • Bengo Seguro,一个经过验证的营业地点。
  • Garush Productions,一个未通过验证的营业地点。

用户需要手动选择匹配的商家。为确保向消费者提供准确的商家路线,您可能需要调整这些营业地点的纬度和经度 (LatLng) 数据,以提高准确性。要了解用户如何手动输入其 LatLng,请参阅手动调整地理位置数据

手动调整地理位置数据

商家可以添加其商家的维度和经度 (LatLng) 坐标,以提高他们在“Google 我的商家”上的商家信息的准确性。新商家可能不知道自己的 LatLng 坐标,因此他们可以转而使用 Maps JavaScript 地点微件手动放置图钉,以创建准确的 LatLng 坐标。

一个地址解析为相距 1500 英尺的三个营业地点。要准确地将商家地址与其 LatLng 坐标相关联,需要手动调整每个营业地点的坐标。

搜索结果的质量

根据搜索地址的准确性和地区的不同,搜索结果差异很大。发展中地区显示的 Google 地图地点往往较少,经常会出现与 Google 地址格式不一致的情况。这会导致搜索结果质量较差,更需要手动设置地址格式,也更加需要使用 Maps API。