關於 Places 洞察資料和查詢

Places Insights 資料

Places Insights 會提供 BigQuery 完整和範例資料集。

我們提供範例資料集，方便試用 Places Insights，評估產品的實用性和價值，再決定是否購買完整資料集。資料集範例只包含該城市的資料，不含周邊都會區的資料。

範例商家資訊包含每個支援國家/地區的熱門城市資料：

完整資料集包含每個支援國家/地區的資料，且必須購買。如有意申請使用 Places Insights，請填寫要求表單。只有資料訂閱者需要要求存取 Places Insights 資料集。在 BigQuery 專案中啟用訂閱後，任何有權存取該專案的使用者都能查詢地點洞察資料。

每個國家/地區的資料集都有各別商家資訊，您必須分別訂閱。如要進一步瞭解如何訂閱商家檔案，請參閱「設定 Places Insights」。

每個國家/地區的地點資料集結構定義都包含兩個部分：

舉例來說，如果您要處理西班牙 (ES) 的資料集，請同時參照核心結構定義和 ES 專屬結構定義。

品牌資料集的結構定義會定義三個欄位：

Places Insights 提供兩種查詢資料集的方式：

使用 SQL 直接查詢資料集：對資料集表格執行標準 BigQuery SQL 查詢。這樣一來，您就能以最靈活的方式進行複雜的篩選、與自己的資料合併、自訂分析，以及支援 COUNT 以外的匯總函式，例如 AVG、SUM 和 GROUP BY。請參閱說明文件。
使用地點計數函式查詢資料集：地點計數函式是預先定義的 SQL 查詢，經過最佳化處理，可直接在 BigQuery 中執行，並簡化常見的資料擷取工作。這類要求可提供更精細的洞察資料，例如傳回地點 ID，以便查詢個別地點的詳細資料。請參閱說明文件。

直接查詢資料會強制執行匯總門檻。只有在查詢彙整至少 5 個地點時，系統才會傳回結果。舉例來說，如果搜尋條件的結果是 0、1、2、3 或 4，則回應中會省略該結果。舉例來說，如果查詢特定區域的餐廳總數，只有在總數為 5 以上時才會傳回回應，否則不會傳回任何回應。

地點數量函式可以傳回地點 ID 清單，您可以使用這份清單，透過其他 GMP 產品 (例如 Places API 和 Places UI Kit) 查詢個別地點資訊。

地點數量函式不會強制執行匯總門檻，而是強制執行 40.0 公尺 x 40.0 公尺 (1600 公尺²) 的最小搜尋範圍。也就是說，只要搜尋查詢大於最小搜尋範圍，系統一律會提供結果，即使沒有任何地點符合查詢條件也一樣。

如果不需要低結果計數，想取得計數以外的洞察資料 (例如 AVG、SUM 或 COUNTIF)，或是需要執行更複雜的查詢 (例如聯結資料集)，請直接查詢資料。

如需瞭解結果數量偏少或為零，或是需要擷取個別地點資訊 (例如地點名稱或地址)，請使用函式查詢。

下表詳細比較直接查詢和地點計數函式的差異。

	地點計數函式	直接查詢資料集
優點	傳回可用於查詢其他 API 的地點 ID。可以傳回任何計數。效能最佳化，處理成本低廉。簡單易用。不必編寫複雜的查詢。驗證輸入參數並傳回錯誤，方便使用及偵錯。	可進行進階篩選和彙整等複雜查詢。不會強制設定最小搜尋範圍。除了 `COUNT` 以外，還支援其他匯總函式，例如 `AVG`、`SUM` 和 `GROUP BY`。
介面	四個預先定義的 SQL 函式，可產生 `COUNT` 洞察資料：單一計數、依類型計數、依地理位置計數、依 H3 儲存格計數。`JSON_OBJECT` 會將引數傳遞至函式。	自行編寫 SQL，執行 `COUNT`、`COUNT_IF`、`SUM` 和 `AVG.` 等匯總函式。您也可以使用 `JOIN`、`GROUP BY`、`WHERE` 等函式產生其他洞察資料。
限制	強制執行 40.0 公尺 x 40.0 公尺 (1600 公尺²) 的最小搜尋範圍。只要符合最低搜尋區域，即使匯總計數少於 5，函式仍會傳回結果。	如果結果的計數少於 5，系統會從結果中省略 (即排除資料列)。
支援的屬性篩選條件	地點計數函式篩選器參數支援與直接查詢屬性篩選器相同的參數，但下列參數除外：地點：`id` 地址元件營業時間電動車充電選項品牌	支援完整結構定義。