本文档将引导您向 Places Aggregate API 发出基本请求并了解响应,其中包括匹配地点的数量。
如需使用 Places Aggregate API,请向 computeInsights 端点发送 HTTP POST 请求,如下所示:
https://areainsights.googleapis.com/v1:computeInsights
通过在 JSON 正文中提供区域和类型参数来优化您的请求。此示例展示了一个请求,用于返回旧金山营业、价格适中且评级在 4 星到 5 星之间的餐厅数量。
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"insights":[
"INSIGHT_COUNT"
],
"filter":{
"locationFilter":{
"region":{
"place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo"
}
},
"typeFilter":{
"includedTypes":[
"restaurant"
]
},
"operatingStatus":[
"OPERATING_STATUS_OPERATIONAL"
],
"priceLevels":[
"PRICE_LEVEL_INEXPENSIVE"
],
"ratingFilter":{
"minRating":4.0,
"maxRating":5.0
}
}
}'
Places Aggregate API 响应
以下示例请求的响应显示了符合条件的餐厅数量。
{ "count": "850" }
试试看!
借助 API Explorer,您可以发出示例请求,以便熟悉 API 和 API 选项。
- 选择页面右侧的 API 图标
,
。 - 您可以选择展开显示标准参数 以设置 任何参数。
- 您可以选择修改请求正文 。
- 选择执行 按钮。在对话框中,选择您要用于发出请求的账号 。
在 API Explorer 面板中,选择展开图标
以展开 API Explorer 窗口。