本文档包含有关 Places API 的常见问题解答。如果您在此处找不到问题的答案,以下某些页面可能会对您有所帮助。
Places API 还拥有一个充满活力的开发者社区。如果您对代码有疑问,建议您将问题发布到社区。如需详细了解如何提问,请参阅支持页面。
搜索地点
为什么按类型过滤时,系统不会返回某些地点?
您要查找的地点可能尚未归类。
所有地点都会归类为通用类型“establishment”,直到 Google 获得有关某个地点的足够数据,可以将其归类为支持的地点类型之一。
作为权宜解决方法,您可以将地点 type 传递给 keyword 参数。keyword 参数与以下内容匹配:名称、类型、地址和客户评价。
如果您想自行将“type”类别添加到地点详情中,请提交地点修改。修改内容获得批准并发布后,系统会使用正确的 type 过滤条件显示这些内容。
为什么有些附近的地点未返回?
默认情况下,Places API 会在提供的 radius 内按 prominence 对结果进行排序。附近搜索请求最多可返回 60 条结果,分三页显示。如果某个地点在 prominence 中排名第 22 位,则会显示在结果的第二页,您可以通过分页访问该页面。如果某个地点在 prominence 中的排名高于 60,则该地点不会包含在搜索结果中,即使它更靠近搜索中心也是如此。
您可以按 distance(而非 prominence)对结果进行排序,方法是将查询中的 rankby 参数设置为 distance 并省略 radius 参数。系统将忽略相关性,并按与 location 的距离顺序返回地点。
如果您按类型过滤请求,则可能会从回答中滤除某些结果。如需了解详情,请参阅常见问题解答条目:为什么按类型过滤时未返回某些地点?
为什么按某些 types 过滤时最多只能收到两个结果?
Places API 旨在返回附近establishments(受支持地点类型第一个表中的任何内容)的列表,以及最多两个位置(受支持地点类型第二个表中的任何内容)结果,以帮助确定您要执行附近搜索请求的区域。
按地点 type(例如 locality 或 political)过滤附近搜索请求,会滤除 establishment 结果。
地点数据
如何添加或修改地点?
如果您是企业主,则可以使用商家资料在 Google 地图上添加、验证和管理您的商家信息。
如果您不是该地点的所有者,仍然可以建议更改。
问题排查
为什么我一直收到“status”:“REQUEST_DENIED”?
在以下情况下,Places API 会返回 "status": "REQUEST_DENIED":
- 您尚未在 Google Cloud 控制台中启用 Places API。
- 您的请求中缺少
key参数。 key参数与 Google Cloud 控制台中的 API 密钥不匹配。- 您的 API 密钥未在 Google Cloud 控制台中正确设置:
- 如果您使用的是受浏览器限制的 API 密钥,请检查您允许的引荐来源网址是否正确。
- 如果您使用的是受服务器限制的 API 密钥,请检查您允许的 IP 是否正确。
- 不支持具有 Android 或 iOS 限制的 API 密钥。使用通用(不受限)API 密钥,或存在浏览器或服务器限制的密钥。
- 请求未作为
HTTPS请求发送,所有 Places API 请求都需要HTTPS。 - 使用了错误的
HTTP method发送请求。