Places Aggregate API 是一項服務，可根據地點、類型、營業狀態、價格等級和使用者評分等條件，提供指定區域內的地點洞察資料。這項服務可協助分析指定地點周圍特定地點類型的密度，並回答「這個地點 5 公里半徑內有多少間 5 星級 $$$ 餐廳？」等問題。
結果會以匯總計數或感興趣搜尋區域中識別的地點 ID 形式傳回。使用者可以透過 Place Details API 擷取這些地點 ID 的詳細資訊。
為什麼要使用 Places Aggregate API
Places Aggregate API 可讓使用者根據您提供的各種地點詳細資訊，做出資料導向的決策。這項功能採用準確且最新的地點模型，支援下列主要用途：
- 商家：分析競爭情況，以及新分店的潛在位置。
- 開發人員：建構可提供個人化建議的應用程式。
- 研究人員：查看特定領域的趨勢和模式。
Places Aggregate API 的用途
透過 Places Aggregate API，您可以取得下列資訊：
- 計數：擷取符合條件的地點數量。
- 地點 ID：擷取符合您條件的特定地點 ID。
你也可以使用篩選器，根據各種屬性 (例如地點類型、營業時間、價位和顧客評分) 縮小搜尋範圍。
範例
本節說明 Places Aggregate API 的範例用途，並提供每個範例的有效程式碼。
開設新咖啡廳
某餐廳老闆想開一間新咖啡廳，為此，他們首先想以視覺化方式呈現咖啡廳的熱點，以便找出高濃度和低濃度區域，做為業務決策的依據。商家可使用 Places Aggregate API，根據營業狀態、價格等級和顧客評分等屬性，分析特定半徑內的咖啡廳數量，然後根據資料做出決定，選擇下一個開店地點。
房地產投資公司
房地產投資公司想強化財務模型，並準確判斷預計房地產投資的投資報酬率。他們可以透過 Places Aggregate API 收集潛在投資房產附近的設施詳細資料，例如 ATM、醫院、大眾運輸站點和雜貨店，瞭解潛在投資房產附近的設施。
零售配送服務
零售外送服務拓展至新城市時，需要根據熱門消費者目的地 (例如餐廳、便利商店和酒類商店) 的密度，決定要為該區域分配多少外送司機。外送服務可使用 API 計算整個城市中這類場所的總數，以便有效規劃及分配資源。
Places Aggregate API 的運作方式
您可以使用 Places Aggregate API 指定篩選條件，縮小搜尋條件範圍。
選取 INSIGHT_COUNT 或 INSIGHT_PLACES 的洞察類型後，即可新增篩選條件，包括：
- 地點：使用圓形、區域或自訂多邊形定義感興趣的區域。
- 類型：指定您感興趣的地點類型。
- 營運狀態：根據地點的營運狀態篩選地點。
- 價位：根據價位篩選地點。
- 評分：根據使用者評分篩選地點。
API 回應 ComputeInsightsResponse 物件包含要求洞察結果。舉例來說，如果您選取 INSIGHT_COUNT，回應會包含地點總數；如果您選取 INSIGHT_PLACES，回應會包含地點 ID 清單。
如何使用 Places Aggregate API
| 1 | 完成設定。 | 請先設定 Google Cloud 專案，然後按照後續操作說明完成設定。 |
| 2 | 提出要求，取得相符地點的數量。 | 請參閱「發出第一項要求」。 |
| 3 | 瞭解要求參數。 | 請參閱「要求參數」。 |