PLACES_COUNT_PER_GEO 函式

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

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

• 輸入參數：

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

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

• 傳回：

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

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

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

注意： 由於回應資料表包含 geographies 欄位，因此您可以使用支援 BigQuery GEOGRAPHY 類型的工具，將其視覺化。如需函式結果的視覺化範例，請參閱「顯示結果」。如要進一步瞭解如何以視覺化方式呈現地點洞察資料結果，請參閱「以視覺化方式呈現查詢結果」一文。

本例使用 美國人口普查局資料 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 `maps-platform-analytics-hub.sample_places_insights_us.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. 填滿的地圖會如上所示。您可以視需要選取「圖表類型」->「樣式」，進一步設定地圖外觀。

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