在本文档中，您将了解如何使用 Nearby Search（新）API 更改为 打造简单且经济实惠的
本地发现体验。
在用户搜索酒店或房地产时，本地发现体验会向用户显示您指定位置附近的主要景点。它通常由 还有一个包含地点选择器和 图库中的照片。您将看到不同的 Google Maps Platform 产品和功能，以便通过互动性提升体验。
使用场景
现在，我们来了解一下本地发现集成的哪些元素能够吸引用户 值：
探索 - 让用户大致了解某个营业地点周围的环境 显示各种类型的相关地点。
互动 - 让用户能够选择地点并动态刷新数据
相对于该地点。
可视化 - 提供地点评价、照片
以及步行时间和距离 以便用户快速了解其是否适合 满足自己的需求
参考架构
本地发现
您可以通过多种方式打造本地发现体验。以下集成是利用众所周知的 Google Maps Platform API 以及一些令人兴奋的新功能打造的用户体验的自定义示例。如果您 希望通过模板化方法发现本地，可以使用网络 组件。
示例应用
演示示例
下表将示例应用分解为若干步骤，并说明了使用 Google Maps Platform API 的技术实现。
1. 使用自动补全功能进行位置搜索
- 加载 Maps JavaScript API。
- 使用地点自动补全查询或在地图上选择地点。
2. 使用 附近搜索（新）API 显示本地地图注点
- 热门程度排名（更相关的结果）或距离排名。
includedTypes、excludedTypes；如果是酒店，则可以排除 “lodging”类型，仅包含合适的类型，例如：“餐馆、咖啡馆、公园、 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 添加互动功能
- 通过查询路线获取最新的路程和步数 API。 * 在下一部分中使用时间。
4. 在互动时显示地点的详细信息
说明：
displayName、types、rating、userRatingCount、priceLevel。时间：来自之前的 Directions API 查询。
评价：
reviews[i].author、reviews[i].rating、reviews[i].text。图片：在附近搜索（新版）API 的无限制预览版期间，您必须使用
place.id查询地点详情以获取 photo_reference，然后在您的体验中一次查询一个
查询次数和相关费用
- Maps JavaScript API：在体验加载时，1 张地图。
- Places Autocomplete API：对输入的每个字符执行 1 次查询（如果使用 自动填充 Widget） 可以进行自定义
- 附近搜索（新）API：每显示 20 个地点，计 1 次查询。根据查询响应中的地点数据采用不同的结算方式。
- Directions API：每当用户选择一个地点时，系统会发出 1 次查询。
- 地点照片 API： 显示的每张照片 1 次查询。
总结
本地信息发现体验是为用户带来价值的有效方式。此演示实现包含许多功能，您在 Google Maps Platform 上使用 Nearby Search（新版）API 的特殊功能打造此类体验时，可能会包含这些功能。
后续步骤
建议的进一步阅读材料：
- Maps JavaScript API 中的 Web 组件
- 地点自动补全优化
- 其他地点服务
- 欢迎在下方提供反馈。
贡献者
主要作者：
Thomas Anglaret |Google 地图 平台解决方案工程师