提交第一个请求

本文档将引导您完成向 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 选项。

  1. 选择页面右侧的 API 图标 展开 API Explorer。。
  2. （可选）展开显示标准参数以设置任何参数。
  3. 您可以视需要修改请求正文。
  4. 选择执行按钮。在对话框中，选择您要用于提出请求的账号。

  5. 在 API Explorer 面板中，选择展开图标 展开 API Explorer。 以展开 API Explorer 窗口。

后续步骤

  • 探索更多示例，了解如何利用 Places Aggregate API 实现各种功能。
  • 详细了解请求参数。
  • 查看完整的 API 文档。