使用 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. 使用 附近搜索（新）API 显示本地地图注点

  • 热门程度排名（更相关的结果）或距离排名。
  • includedTypes、excludedTypes；如果您是酒店，则可以排除“住宿”类型，仅包含适合的类型，例如“餐厅、咖啡馆、公园、tourit_attraction”。
  • 利用 includedPrimaryTypes、excludedPrimaryTypes 可更好地控制结果。
  • `locationRestriction，以避免结果数量不足或地点距离过远；如果没有结果，请在显示结果之前扩大圆形 / 矩形的大小。

附近地点示例

预订酒店时查询示例，其中包含请求的数据字段：

  • 基本（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（新版）API 的特殊功能打造此类体验时，可能会包含这些功能。

后续步骤

建议的补充阅读材料：

贡献者

主要作者：

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