關於 Places 洞察資料和查詢

Places Insights 資料

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

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

範例清單包含每個支援國家/地區的主要城市資料：

  • 阿姆斯特丹 (荷蘭)
  • 安卡拉 (TR)
  • 阿雷基帕 (PE)
  • 雅典 (GR)
  • 巴特加斯泰因 (奧地利)
  • 柏林 (德國)
  • 布爾諾 (捷克)
  • 布魯塞爾 (BE)
  • 布加勒斯特 (羅馬尼亞)
  • 布宜諾斯艾利斯 (AR)
  • 釜山 (KR)
  • 開羅 (EG)
  • 清邁 (泰國)
  • 哥本哈根 (丹麥)
  • 科克 (愛爾蘭)
  • 德布勒森 (匈牙利)
  • 河內 (越南)
  • 赫爾辛基 (FI)
  • 香港 (HK)
  • 雅加達 (印尼)
  • 吉達 (SA)
  • 約翰尼斯堡 (南非)
  • 吉隆坡 (MY)
  • 里斯本 (葡萄牙)
  • 倫敦 (英國)
  • 路薩爾 (卡達)
  • 馬德里 (西班牙)
  • 馬尼拉 (PH)
  • 麥德林 (哥倫比亞)
  • 墨西哥市 (MX)
  • 孟買 (IN)
  • 紐約市 (美國)
  • 奧斯陸 (NO)
  • 巴黎 (法國)
  • 普羅夫迪夫 (BG)
  • 里法 (巴林)
  • 羅馬 (IT)
  • 聖地牙哥 (CL)
  • 聖保羅 (巴西)
  • 沙迦 (AE)
  • 新加坡 (SG)
  • 斯德哥爾摩 (SE)
  • 雪梨 (澳洲)
  • 臺北 (TW)
  • 特拉維夫-雅法 (以色列)
  • 東京 (日本)
  • 多倫多 (加拿大)
  • 華沙 (PL)
  • 威靈頓 (紐西蘭)
  • 蘇黎世 (瑞士)

完整資料集包含每個支援國家/地區的資料，必須付費購買。如要申請使用 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 Count 函式的差異。

Places 計數函式 直接查詢資料集
優點
  • 傳回可用於查詢其他 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 的結果 (即排除資料列)。
支援屬性篩選條件 Places Count 函式篩選器參數支援的篩選器與直接查詢屬性篩選器相同，但下列除外：
  • 地點「id」
  • 地址元件
 支援完整結構定義。