在本文档中,您将了解如何使用 Nearby Search(新)API 构建简单且经济实惠的
本地发现体验
本地发现体验可在用户搜索酒店或房地产时,向用户显示指定位置附近的主要景点。它通常由互动式地图以及一个包含地点选择器和照片库的附加面板组成。我们将向您介绍不同的 Google Maps Platform 产品和功能,以增强互动体验。
应用场景
现在,我们来了解本地发现集成的哪些元素可以为用户带来价值:
发现 - 显示各种类型的相关地点,让用户大致了解某个营业地点周围的环境。
互动 - 让用户能够选择地点并动态刷新数据
显示该位置的相关度
可视化 - 提供地点评价、照片
以及步行时间和距离,以便用户快速了解其是否符合自己的需求。
参考架构
本地发现
您可以通过多种方式打造本地用户发现体验。以下集成是用户体验的自定义示例,该示例利用了众所周知的 Google Maps Platform API 以及一些激动人心的新功能。如果您希望使用模板化方法进行本地发现,可以使用 Web 组件。
示例应用
示例演示
下表列出了应用的分解步骤,以及 Google Maps Platform API 的技术实现说明。
1. 含自动补全功能的营业地点搜索
- 加载 Maps JavaScript API。
- 地点自动补全查询或在地图上选择位置。
2. 使用 Nearby Search(新)API 显示本地地图注点
- 热门程度排名(相关度更高的结果)或距离排名。
includedTypes
、excludedTypes
;如果您经营的是酒店,则可以排除“lodging”类型,仅包含合适的类型,例如:“餐馆、咖啡馆、公园、tourit_attraction”。- 利用
includedPrimaryTypes
、excludedPrimaryTypes
更好地控制结果。 - `locationRestriction 中,以避免结果数量不足或距离太远的位置;如果结果为 0,请在显示结果之前扩大圆圈 / 矩形的大小。
预订酒店且请求了数据字段时的查询示例:
- 基本(
displayName
、types
、openingHours
、formattedAddress
) - 联系人(
websiteUri
、nationalPhoneNumber
、internationalPhoneNumber
) - 首选(
reviews
、priceLevel
、userRatingCount
)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes": ["lodging","convenience_store"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
搜索房地产并请求了数据字段时的查询示例:
- 基本(
displayName
、types
、openingHours
、formattedAddress
)
{ "includedTypes": ["school","transport","bus","convenience_store"], "excludedTypes": ["lodging"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
3. 使用 Dynamic Maps 和 Directions API 添加互动功能
- 通过查询 Directions API 获得最新的路程和步数。* 在下一部分使用时间。
4. 在互动时显示地点的详细信息
说明:
displayName
、types
、rating
、userRatingCount
、priceLevel
。时间:来自上一个 Directions API 查询。
评价:
reviews[i].author
、reviews[i].rating
、reviews[i].text
。图片:在 Nearby Search (New) API 的不受限制预览版期间,您必须使用
place.id
查询地点详情,以获取 photo_reference,从而在您的体验中逐一查询图片
查询数量和相关费用
- Maps JavaScript API:体验加载时加载 1 个地图。
- Places Autocomplete API:对每个输入的字符执行 1 个查询(如果使用 Autocomplete widget),可以对其进行自定义。
- Nearby Search(新)API:每显示 20 个地点 1 次查询。根据查询响应中的地点数据进行不同的结算。
- Directions API:1 次查询用户所选的每个地点。
- Place Photo API:对显示的每张照片执行 1 次查询。
总结
本地信息发现体验是为用户带来价值的有效方式。使用 Nearby Search(新)API 的特殊功能在 Google Maps Platform 上打造此类体验时,您可能会添加此演示实现中的许多功能。
后续步骤
建议深入阅读:
- Maps JavaScript API 中的 Web 组件
- 地点自动补全优化
- 其他地点服务
- 欢迎在下方提供反馈。
贡献者
主要作者:
Thomas Anglaret | Google Maps Platform 解决方案工程师