發出第一個要求

本文會逐步說明如何向 Places Insights API 提出基本要求，並瞭解回應內容，包括相符地點的計數。

試試看！

如要使用 Place Insights，請將 HTTP POST 要求傳送至 computeInsights 端點，如下所示：

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": "850"
}

試試看！

您可以使用 API Explorer 建立範例要求，熟悉 API 和 API 選項。

  1. 選取頁面右側的 API 圖示 展開 API Explorer。。
  2. 您可以視需要展開「Show standard parameters」，然後設定任何參數。
  3. 您可以選擇編輯要求主體。
  4. 選取「執行」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。

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

後續步驟