PLACES_COUNT_PER_GEO 函式

PLACES_COUNT_PER_GEO 函式會採用要搜尋的地理區域陣列，並傳回每個區域的地點計數表。舉例來說，如果您指定郵遞區號陣列做為搜尋區域，回應會包含表格，每個郵遞區號各占一行。

由於 PLACES_COUNT_PER_GEO 函式會傳回資料表，請使用 FROM 子句呼叫該函式。

• 輸入參數：

  • 必要：指定搜尋區域的 geographies filter 參數。geographies 參數會採用由 BigQuery GEOGRAPHY 資料類型定義的值陣列，支援點、線串和多邊形。

  • 選用：其他篩選參數，可修正搜尋結果。

• 傳回：

  • 表格，每個地理區域各占一行。資料表包含 geography (GEOGRAPHY)、count (INT64) 和 sample_place_ids (ARRAY<STRING>) 資料欄，其中 sample_place_ids 包含每個地理區域最多 250 個地點 ID。

範例：計算紐約市各郡的餐廳數量

這個範例會產生表格，列出紐約市各郡的營業餐廳數量。

本例使用 美國人口普查局資料 BigQuery 公開資料集，取得紐約市三個郡的邊界：「皇后區」、「布魯克林」和「紐約」。每個郡的邊界都包含在 county_geom 欄中。

這個範例接著會使用 BigQuery ST_SIMPLIFY 函式，傳回 county_geom 的簡化版本。ST_SIMPLIFY 函式會將近乎筆直的邊緣鏈結取代為單一長邊緣。

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `places_insights___us___sample.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

函式的回應：

以視覺化方式呈現結果

下圖顯示 Looker Studio 中的這項資料，以填滿地圖的形式呈現，包括每個郡的輪廓：

如要將資料匯入 Looker Studio，請按照下列步驟操作：

1. 執行上述函式，即可產生結果。

2. 在 BigQuery 結果中，依序點選「開啟方式」->「Looker Studio」。系統會自動將結果匯入 Looker Studio。

3. Looker Studio 會建立預設報表頁面，並以結果的標題、表格和長條圖初始化該頁面。

   

4. 選取網頁上的所有內容並刪除。

5. 按一下「插入」->「填滿地圖」，即可在報表中加入填滿地圖。

6. 在「圖表類型 -> 設定」下方，設定欄位，如下所示：

   

7. 填滿的地圖會如上所示。您可以視需要選取「圖表類型」->「樣式」，進一步設定地圖外觀。

如要進一步瞭解如何以視覺化方式呈現地點洞察結果，請參閱「以視覺化方式呈現查詢結果」。