使用 Nearby Search（新）API 改进本地搜索

在本文档中，您将了解如何使用 Nearby Search（新）API 构建简单且经济实惠的

本地发现体验。

在用户搜索酒店或房地产时，本地发现体验会向用户显示您指定位置附近的主要景点。它通常由互动式地图以及一个包含地点选择器和照片库的附加面板组成。您将看到不同的 Google Maps Platform 产品和功能，以增强互动体验。

本地发现示例

使用场景

现在，我们来了解本地发现集成的哪些元素可以为用户带来价值：

  • 发现 - 显示各种类型的相关地点，让用户大致了解单个营业地点周围的环境。

  • 互动性 - 让用户能够选择地点并动态刷新数据

    相对于该地点。

  • 可视化 - 提供地点评价、照片

    以及步行时间和距离，以便用户快速了解它是否符合他们的需求。

参考架构

alt_text

本地发现

您可以通过多种方式打造本地发现体验。以下集成是利用众所周知的 Google Maps Platform API 以及一些令人兴奋的新功能打造的用户体验的自定义示例。如果您希望采用模板化方法进行本地发现，可以使用 Web 组件。

示例应用

演示示例

下表将示例应用分解为若干步骤，并说明了使用 Google Maps Platform API 的技术实现。

1. 使用自动补全功能进行位置搜索

  • 加载 Maps JavaScript API。
  • 使用地点自动补全功能进行查询，或在地图上选择地点。

自动补全示例

2. 使用 Nearby Search（新）API 显示本地地图注点

  • 热门程度排名（更相关的结果）或距离排名。
  • includedTypes、excludedTypes；如果您是酒店，则可以排除“住宿”类型，仅包含适合的类型，例如“餐厅、咖啡馆、公园、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 and Directions API 添加互动功能

  • 通过查询 Directions API 获取最新的路段和步骤。 * 在下一部分中使用时间。

示例路线

4. 在互动时显示地点的详细信息

  1. 说明：displayName、types、rating、userRatingCount、priceLevel。

    时间：来自之前的 Directions API 查询。

  2. 评价：reviews[i].author、reviews[i].rating、reviews[i].text。

  3. 图片：在附近搜索（新版）API 的无限制预览版期间，您必须使用 place.id 查询地点详情以获取 photo_reference，然后在您的体验中一次查询一个

地点详情

查询次数和相关费用

总结

本地发现体验是一种强大的用户价值创造方式。此演示实现包含许多功能，您在 Google Maps Platform 上使用 Nearby Search (New) API 的特殊功能打造此类体验时，可能会包含这些功能。

后续步骤

建议的进一步阅读材料：

贡献者

主要作者：

Thomas Anglaret | Google Maps Platform 解决方案工程师