地點洞察資料
Places Insights 會提供 BigQuery 完整和範例資料集。
我們提供範例資料集，方便試用 Places Insights，評估產品的實用性和價值，再決定是否購買完整資料集。資料集範例只包含該城市的資料，不含周邊都會區的資料。
範例商家資訊包含各支援國家/地區的熱門城市資料：雪梨 (澳洲)、聖保羅 (巴西)、多倫多 (加拿大)、蘇黎世 (瑞士)、柏林 (德國)、馬德里 (西班牙)、巴黎 (法國)、倫敦 (英國)、雅加達 (印尼)、孟買 (印度)、羅馬 (義大利)、東京 (日本)、墨西哥市 (墨西哥)、紐約市 (美國)。
完整資料集包含每個支援國家/地區的資料，且必須購買。 如有意購買完整資料集，請填寫申請表單。 只有資料訂閱者需要要求存取 Places Insights 資料集。在 BigQuery 專案中啟用訂閱後，任何有權存取該專案的使用者都能查詢地點洞察資料。
每個國家/地區的資料集都有各自的商家資訊，您必須分別訂閱。 如要進一步瞭解如何訂閱商家檔案，請參閱「設定 Places Insights」。
資料集結構定義
每個國家/地區的地點資料集結構定義都包含兩個部分：
- 所有國家/地區資料集通用的核心結構定義。
- 國家/地區專屬結構定義，定義該國家/地區專屬的結構定義元件。
舉例來說，如果您要處理西班牙 (ES) 的資料集，請同時參照核心結構定義和 ES 專屬結構定義。
品牌資料集的結構定義會定義三個欄位：
id：品牌 ID。name：品牌名稱，例如「Hertz」或「Chase」。category：品牌的高階類別，例如「加油站」、「食品和飲料」或「住宿」。
查詢 Places 洞察資料
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 公尺2) 的最小搜尋區域。也就是說，只要搜尋查詢大於最小搜尋區域，系統一律會提供結果，即使沒有任何地點符合查詢條件也一樣。
何時應直接查詢資料，何時應使用函式
如果不需要低結果計數，想取得計數以外的洞察資料 (例如 AVG、SUM 或 COUNTIF)，或是需要執行更複雜的查詢 (例如聯結資料集)，請直接查詢資料。
如需瞭解結果數量是否偏少或為零，或是需要擷取個別地點資訊 (例如地點名稱或地址)，請使用函式查詢。
下表詳細比較直接查詢和地點計數函式的差異。
| 地點計數函式 | 直接查詢資料集 | |
|---|---|---|
| 優點 |
|
|
| 介面 | 四個預先定義的 SQL 函式，可產生 COUNT 洞察資料：單一計數、依類型計數、依地理位置計數、依 H3 儲存格計數。JSON_OBJECT 會將引數傳遞至函式。 |
自行編寫 SQL，執行 COUNT、COUNT_IF、SUM 和 AVG. 等匯總函式。您也可以使用 JOIN、GROUP BY、WHERE 等函式產生其他洞察資料。 |
| 限制 | 強制執行 40.0 公尺 x 40.0 公尺 (1600 公尺2) 的最小搜尋範圍。只要符合最低搜尋區域，即使匯總計數少於 5，函式仍會傳回結果。 | 系統會從結果中省略計數少於 5 的結果 (即排除資料列)。 |
| 支援的屬性篩選條件 | 地點計數函式篩選參數支援與直接查詢屬性篩選器相同的參數，但下列參數除外：
|
支援完整結構定義。 |