概览
Google Maps Platform 适用于 Web(JS、TS)、Android 和 iOS,还提供用于获取地点、路线和距离相关信息的网络服务 API。本指南中的示例仅基于其中一种平台,如需在其他平台上实现增强型交易,请参阅提供的文档链接。
交易语句对用户而言通常很难理解,使用“ACMEHCORP”等缩写(而非“Acme Houseware”这样的商家名称)可能会导致客户服务电话增加,还可能引发代价高昂的争议。增强型交易可提供商家的全称和业务类别、店面照片、商家地址及在地图上的位置、完整的联系信息等等,从而简化并直观呈现这些交易语句。这不仅有助于提高用户满意度和透明度,还可减少客户服务电话、提高净推荐值,以及吸引用户在应用内停留更长时间。
在本主题中,我们介绍了增强型交易实现指南和自定义设置提示,建议利用 Google Maps Platform API 的最优组合,打造出色的交易记录用户体验。本实现指南将向您介绍如何将营业地点与特定商家进行匹配,以及如何显示商家的详细信息。
![增强型交易示例屏幕](https://developers.google.cn/static/maps/solutions/enriched-transactions/images/diagram.png?authuser=8&hl=fi)
启用 API
若要实现增强型交易,您必须在 Google Cloud 控制台中启用以下 API。您可以通过以下超链接前往 Google Cloud 控制台,为您选择的项目启用各个 API:
如需详细了解设置方法,请参阅 Google Maps Platform 使用入门。实现指南的各个部分
以下是本主题涵盖的实现方法和自定义设置。
- 对勾标记图标表示核心实现步骤。
- 星形图标表示可选但建议采用的自定义设置,可以强化解决方案。
使用 Google Maps Platform 匹配商家 | 将交易记录中的商家与 Google Maps Platform 中的地点相关联。 | |
显示商家详情 | 显示包含丰富数据的交易,其中会提供商家的相关实用信息,以便用户快速识别交易。 | |
添加商家营业地点地图 | 添加商家营业地点地图。 |
使用 Google Maps Platform 匹配商家
此示例使用的是:Places API |
下图展示了您的应用如何使用现有商家数据库中的地点详情或通过“地点搜索”请求对商家交易进行匹配,从而返回相关结果:
![商家匹配流程矩阵](https://developers.google.cn/static/maps/solutions/enriched-transactions/images/decision-matrix-diagram.png?authuser=8&hl=fi)
获取 Google Maps Platform 地点 ID
您可能会有一个包含商家名称和商家地址等基本信息的商家数据库。若要从 Google Maps Platform 中获取此地点的相关信息(包括联系信息和用户贡献的信息),您需要使用与数据库中的每个商家相对应的 Google Maps Platform 地点 ID。
若要获取商家所对应的地点 ID,请在 Places API 中向 /findplacefromtext 端点发出请求,并仅请求 place_id
字段,以便将该请求作为免费的查找地点 - 仅返回 ID 调用进行计费。如果商家有多个营业地点,请将商家名称与城市或街道名称搭配使用。调用返回的数据质量会有所不同,因此您需要验证返回的结果是否确实与所需商家相匹配。
以下示例展示了如何使用商家名称和城市请求 Google 台北办事处的地点 ID:
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
请务必对 API 请求中的输入参数进行网址编码。
存储地点 ID
若要存储 Google Maps Platform 中的商家相关信息以用于将来的请求,您可以在数据库中无限期存储此地点 ID,将其作为商家记录的一种属性。您应该只需对每个商家执行一次“查找地点”请求。您也可以在每次用户请求交易详情时搜索地点 ID。
为确保您始终获得最准确的信息,请使用包含 place_id
参数的地点详情请求,每 12 个月刷新一次地点 ID。
如果您显示的地点详情与发生交易的商家不匹配,建议您允许用户就商家匹配质量提供反馈。
显示商家详情
此示例使用的是:Places API | 同样适用于:Places SDK for Android | Places SDK for iOS | Maps JavaScript API 地点库 |
在用户前往您的某个营业地点之后,您可以分享用户需要了解的地点详情。有了丰富的地点详情(例如联系信息、营业时间、用户评分和用户照片),您的应用就可以针对用户已完成的交易向他们发出提醒。调用 Places API 以获取地点详情后,您可以通过信息窗口、网页边栏或其他您喜欢的方式过滤并呈现响应结果。
![商家详情示例屏幕](https://developers.google.cn/static/maps/solutions/enriched-transactions/images/enriched-transactions.png?authuser=8&hl=fi)
如需查询地点详情,您需要每个营业地点的地点 ID。请参阅获取地点 ID 来检索营业地点的地点 ID。
以下“地点详情”请求会针对 Google 台北 101 地点 ID 在 json
输出中返回地址、坐标、网站、电话号码、评分和营业时间:
https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
添加商家营业地点地图
此示例使用的是:Geocoding API | Maps Static API | 同样适用于:Android | iOS |
确定商家营业地点
Maps Static API 接受在地址或坐标上放置标记。如果您的商家记录中已有地址,则可以跳到下一部分,但我们建议您使用坐标而非地址,以确保地图精确度。
如果您的商家数据库中包含街道地址但没有地理坐标,并且您尚未请求地点详情,则可以在服务器端使用 Geocoding API 将街道地址转换为纬度/经度坐标,然后将坐标存储在数据库中,并且至少每 30 天刷新一次坐标。
下例展示了如何使用 Geocoding API 获取 Google 台北办事处地点 ID 的经纬度:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a
在地图上为商家营业地点添加标记
由于用户会查看地图来确认交易,而不是浏览或导航,因此您需要创建具有一定互动性的地图。
对于桌面版网站和移动网站,请创建 Maps Static API 网址并将一个标记放置在商家的纬度/经度坐标或地址处。您可以通过网络服务调用来使用 Maps Static API,该调用将根据您指定的参数创建地图的图片版本。对于移动设备,请跳至下一部分“在移动应用中添加地图”。
下方的调用显示了一个路线图,该图尺寸为 640x480 像素,以放置在 Google 台北办事处的标记为中心,并且采用默认缩放级别。该图还指定了一个红色的送货地点标记和一个云端地图样式:
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
它可分为以下几部分:
API 网址 | https://maps.googleapis.com/maps/api/staticmap? |
图片尺寸 | size=640x480 |
商家营业地点标记(使用网址编码) | markers=color:red%7C25.033976%2C121.5645389 |
云端地图样式 | map_id=b224095f76859890 |
API 密钥 | key=YOUR_API_KEY |
数字签名(了解如何对请求进行数字签名) | signature=BASE64_SIGNATURE |
解决方案渠道参数(请参阅参数文档) | solution_channel=GMP_guides_enrichedtransactions_v1_a |
上述代码会生成如下所示的图片:
您也可以使用地址作为标记位置:
https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a
如需了解其他参数选项,请参阅 Maps Static API 文档。
在移动应用中添加地图
如果您使用的是 Maps SDK for Android 或 Maps SDK for iOS,则可以根据地点详情信息中的坐标来放置标记。
由于用户会查看地图来确认交易,而不是浏览或导航,因此请选择具有一定互动性的地图。