跳转到主要内容
GOOGLE_PLACES 返回 Google 搜索的“地点”标签页针对某个查询列出的地点,也就是本地结果包下方“更多地点”打开的列表。它每页读取 20 个地点,最多读取 5 页,并且每一页都从同一个城市搜索,因此你能按 Google 在该城市的排序获得最多 100 个地点。可用于在整个城市的本地列表中追踪商家排名,或收集 Google 在某个城市为某项服务展示的商家。

请求

下面的请求获取在罗得岛州曼维尔搜索长期护理机构时 Google 列出的前 100 个地点:
如果你的系统已为每个地点保存了 Google 的 uule,可以用它代替 city。下面的值对应内华达州里诺:
任务异步执行。按异步任务中的说明读取结果。limit: 100 的任务通常在一到两分钟内完成。

参数

不发送 city 和 uule 时,由 Google 决定搜索位置。

响应

例如上面曼维尔请求的结果:
后面的页面再次列出的地点只计一次。如果 Google 的列表在达到 limit 之前结束,places 会包含 Google 列出的全部地点;小城镇常常不足 100 个。Google 没有为某个地点展示的字段会被省略。除 name、position 和 page 外,请把每个字段都当作可选字段。

积分

每读取一个地点页扣 1 积分。提交时,任务按 limit 所需的页数冻结积分,每 20 个地点一页:默认为 1,limit: 100 为 5。完成时按实际读取的页数扣费,因此 Google 的列表在第 3 页结束时扣 3 积分。失败的任务扣 0。见积分与限制。

限制与错误

  • 已完成任务中的 places 为空,表示 Google 在该位置没有为该查询列出任何地点。返回前会在第二个浏览器上确认,并扣 1 积分。
  • 超出 1-100 的 limit、为空或超过 100 个字符的 city,或与 uule 或 location 一起发送的 city,返回 422 VALIDATION_ERROR。
  • 不是 w+ 形式 UULE 的 uule 返回 400 VALIDATION_ERROR。
  • location 返回 422。请用 city 或 uule 指定地点。
  • include.rawResponse 不起作用,include.html 和 include.analysis 返回 422。见Markdown 与原始响应。
  • 其他请求错误见错误。

相关内容