发出您的第一个请求

本文档将引导您向 Places Insights 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 Insights API 响应

上述示例请求的以下响应显示了与条件匹配的餐厅数量。

{
  "count": "846"
}

后续步骤

  • 探索更多示例,了解您可以使用地点数据分析实现哪些目标。
  • 详细了解请求参数
  • 查看完整的 API 文档