發出第一個要求

這份文件將逐步說明如何向 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 圖示 。
2. 視需要展開「顯示標準參數」，設定任何參數。
3. 選擇性步驟：編輯「要求主體」。
4. 選取「執行」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

5. 在 API Explorer 面板中，選取展開圖示 ，展開 API Explorer 視窗。

後續步驟

• 如要進一步瞭解 Places Aggregate API 的用途，請參閱範例。
• 進一步瞭解要求參數。
• 查看完整 API 說明文件。