GOOGLE_PLACES 返回 Google 搜索的“地点”标签页针对某个查询列出的地点,也就是本地结果包下方“更多地点”打开的列表。它每页读取 20 个地点,最多读取 5 页,并且每一页都从同一个城市搜索,因此你能按 Google 在该城市的排序获得最多 100 个地点。可用于在整个城市的本地列表中追踪商家排名,或收集 Google 在某个城市为某项服务展示的商家。
请求
下面的请求获取在罗得岛州曼维尔搜索长期护理机构时 Google 列出的前 100 个地点: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 与原始响应。- 其他请求错误见错误。