Places Insights 資料
Places Insights 會提供 BigQuery 完整和範例資料集。
我們提供範例資料集，方便試用 Places Insights，評估產品的實用性和價值，再決定是否購買完整資料集。範例資料集只包含該城市的資料，不含周邊都會區的資料。
範例清單包含每個支援國家/地區的主要城市資料：
| 阿姆斯特丹 (荷蘭) | 赫爾辛基 (FI) | 普羅夫迪夫 (BG) |
| 安卡拉 (TR) | 香港 (HK) | Riffa (BH) |
| 阿雷基帕 (PE) | 雅加達 (ID) | 羅馬 (IT) |
| 雅典 (希臘) | 吉達 (沙烏地阿拉伯) | 聖地牙哥 (CL) |
| 巴特加斯泰因 (奧地利) | 約翰尼斯堡 (南非) | 聖保羅 (BR) |
| 柏林 (德國) | 吉隆坡 (馬來西亞) | 沙迦 (AE) |
| 布爾諾 (捷克) | 里斯本 (PT) | 新加坡 (SG) |
| 布魯塞爾 (比利時) | 倫敦 (英國) | 斯德哥爾摩 (SE) |
| 布加勒斯特 (羅馬尼亞) | 路薩爾 (卡達) | 雪梨 (澳洲) |
| 布宜諾斯艾利斯 (AR) | 馬德里 (西班牙) | 臺北 (TW) |
| 釜山 (KR) | 馬尼拉 (PH) | 特拉維夫-雅法 (IL) |
| 開羅 (EG) | 麥德林 (哥倫比亞) | 東京 (日本) |
| 清邁 (泰國) | 墨西哥市 (MX) | 多倫多 (加拿大) |
| 哥本哈根 (DK) | 孟買 (IN) | 華沙 (PL) |
| 科克 (愛爾蘭) | 紐約市 (美國) | 威靈頓 (紐西蘭) |
| 德布勒森 (匈牙利) | 奧斯陸 (NO) | 蘇黎世 (CH) |
| 河內 (越南) | 巴黎 (法國) |
完整資料集包含每個支援國家/地區的資料，必須付費購買。如要申請使用 Places Insights，請填寫申請表單。只有資料訂閱者需要要求 Places Insights 資料集的存取權。在 BigQuery 專案中啟用訂閱項目後，凡是有權存取該專案的使用者，都能查詢 Places Insights 資料。
每個國家/地區資料集都有各別商家資訊，您必須分別訂閱。如要進一步瞭解如何訂閱商家資訊，請參閱「設定 Places Insights」。
資料集結構定義
每個國家/地區的地點資料集結構定義都包含兩個部分：
- 所有國家/地區資料集通用的核心結構定義。
- 國家/地區專屬結構定義，定義該國家/地區專屬的結構定義元件。
舉例來說，如果您要處理西班牙 (ES) 的資料集，請同時參考核心結構定義和 ES 專屬結構定義。
品牌資料集的結構定義定義了三個欄位：
id：品牌 ID。name：品牌名稱，例如「Hertz」或「Chase」。category：品牌的高階類別，例如「加油站」、「餐飲」或「住宿」。
查詢 Places Insights 資料
Places Insights 提供兩種查詢資料集的方式：
- 直接使用 SQL 查詢資料集：對資料集資料表執行標準 BigQuery SQL 查詢。這項功能可讓您靈活執行複雜的篩選作業、與自己的資料彙整、自訂分析，以及支援
COUNT以外的其他匯總函式，例如AVG、SUM和GROUP BY。請參閱說明文件。 - 使用 Places Count 函式查詢資料集：Places Count 函式是預先定義、經過最佳化的 SQL 查詢，可直接在 BigQuery 中執行，並簡化常見的資料擷取工作。這類 API 可提供更精細的洞察資料，例如傳回地點 ID，以便查詢個別地點的詳細資料。請參閱說明文件。
直接查詢
直接查詢資料時，系統會強制套用匯總門檻。只有在查詢匯總至少 5 個 Places 時，系統才會傳回結果。舉例來說，如果搜尋條件結果的計數為 0、1、2、3 或 4，則結果會從回應中省略。舉例來說，如果查詢特定區域的餐廳總數，只有在總數為 5 以上時，系統才會傳回回應，否則不會傳回任何回應。
Places Count 函式查詢
Places Count 函式可傳回地點 ID 清單，可用於透過其他 GMP 產品 (例如 Places API 和 Places UI Kit) 查詢個別地點資訊。
Places 計數函式不會強制執行匯總門檻，而是強制執行 40.0 公尺 x 40.0 公尺 (1600 平方公尺) 的最小搜尋區域。也就是說，只要搜尋查詢大於最小搜尋區域，就一定會取得結果，即使沒有符合查詢的地點也一樣。
何時應直接查詢資料，何時應使用函式
如果您不需要低結果計數、想取得計數以外的深入分析 (例如 AVG、SUM 或 COUNTIF)，或需要執行更複雜的查詢 (例如彙整資料集)，請直接查詢資料。
如要瞭解結果數量是否偏低或為零，或需要擷取個別地點資訊 (例如地點名稱或地址)，請使用函式進行查詢。
下表詳細比較直接查詢和 Places 計數函式的差異。
| Places 計數函式 | 直接查詢資料集 | |
|---|---|---|
| 優點 |
|
|
| 介面 | 四個預先定義的 SQL 函式，可生成COUNT洞察資料：單一計數、依類型計數、依地理位置計數、依 H3 儲存格計數。JSON_OBJECT 會將引數傳遞至函式。 |
自行編寫 SQL 來執行匯總函式，例如 COUNT、COUNT_IF、SUM 和 AVG.。您也可以使用 JOIN、GROUP BY、WHERE 等函式，產生其他洞察資料。 |
| 限制 | 強制執行 40.0 公尺 x 40.0 公尺 (1600 平方公尺) 的最小搜尋區域。只要符合最小搜尋區域，即使匯總計數小於 5，函式也會傳回結果。 | 計數少於 5 的結果會從結果中省略 (即排除資料列)。 |
| 支援的屬性篩選條件 | Places Count 函式篩選器參數支援與直接查詢屬性篩選器相同的參數，但下列除外：
|
支援完整結構定義。 |