PLACES_COUNT_PER_TYPE 函式

PLACES_COUNT_PER_TYPE 函式會傳回表格，其中列出函式中指定的每個地點類型的計數。舉例來說，如果您搜尋 doctor、hospital 和 pharmacy 類型，回應會包含一個表格，其中每種型別各占一行。

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

  • 輸入參數：

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

      如需使用不同類型搜尋地理區域 (例如可視區和線條) 的範例，請參閱 PLACES_COUNT 函式。

    • 必要：types filter 參數，用於指定要搜尋的地點類型。

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

  • 傳回：

    • 表格，每個 types 值各佔一行。資料表包含「type」(STRING)、「count」(INT64) 和「place_ids」(ARRAY<STRING>) 資料欄，其中「place_ids」最多可包含每個「type」的 250 個地點 ID。

示例：傳回餐廳、咖啡廳和酒吧的數量

在這個範例中，您會在紐約市以多邊形定義的指定搜尋區域中，搜尋所有營業中的餐廳、咖啡廳和酒吧。

types 參數會採用 STRING 值陣列，指定要搜尋的地點類型。如需可能值的完整清單，請參閱地點類型。

這個範例也會使用 BigQuery ST_GEOGFROMTEXT 函式，從多邊形傳回 GEOGRAPHY 值。

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

這個函式會傳回含有三列的表格，每種型別各一列：

紐約市的 Place Count Type 函式結果。