借助 Places API,您可以使用各种类别(包括场所、著名地图注点和地理位置)搜索地点信息。您可以按距离或文本字符串搜索地点。地点搜索会返回地点列表以及每个地点的摘要信息;您可以使用地点详情(旧版)查询获取更多信息。
比较搜索类型
有三种搜索端点可供选择,各有不同特点。下表着重说明了其中的一些差异。
类型 | 字段选择 | 文本搜索(旧版) | 模糊不清的文本 | 位置过滤条件 | 其他过滤条件 |
---|---|---|---|---|---|
查找地点(旧版) | input |
||||
附近搜索(旧版) | keyword |
||||
文本搜索(旧版) | query |
字段选择
您无法将“附近搜索”(旧版)或“文本搜索”(旧版)限制为仅返回特定字段。为避免请求不需要的数据并为之付费,请改用“查找地点(旧版)”请求。
模糊不清的文本
“查找地点(旧版)”和“文本搜索(旧版)”针对在多个字段中匹配模糊文本进行了优化,而“附近搜索(旧版)”则仅限于在部分字段中进行严格匹配。
其他过滤条件
“附近搜索(旧版)”和“文本搜索(旧版)”允许使用其他参数来过滤结果(例如 minprice
、maxprice
、opennow
和 type
)。