遷移指南

重要事項： 本指南適用於從初始搶先版遷移的使用者。其他使用者已使用房源資訊，因此不需要遷移。

2025 年 9 月 4 日發布的「地點洞察」包含下列變更：

• 支援在您選擇的 BigQuery 位置訂閱 Places 洞察。

• 將 Places 洞察資料集從資料無塵室移至 BigQuery 資料交換目錄。

• 資料集結構定義中的地址欄位會將 id 和 name 欄位分成個別的字串或字串陣列欄位。

注意： 如要使用新的地址欄位，必須遷移至房源。 如果您決定不遷移至房源，而是繼續使用資料淨室，請繼續使用初始版本中的地址欄位和資料集結構定義。

遷移至房源

Places 洞察的初始搶先版會在 BigQuery資料無塵室中部署資料。自 2025 年 9 月 4 日發布的版本起，我們已將資料集移至 BigQuery 目錄，方便您在特定 BigQuery 區域中訂閱資料集。這項異動不會影響 Places Insights 的產品功能和可用性。

如要訂閱特定區域的「地點洞察」，您必須在 BigQuery Sharing 中訂閱新商家資訊。訂閱新房源後，您不需要修改 SQL 查詢。但功能維持不變。

• 新使用者：如果您是 Places Insights 新使用者，請按照「設定 Places Insights」一文中的步驟，設定開發環境以存取商家資訊。

• 現有使用者：請按照下列步驟遷移至使用商品資訊

注意： 如果您是現有客戶，則在預覽期間不必遷移至房源。不過，當「地點洞察」進入正式版後，將只支援商家資訊。

遷移步驟

如要遷移至房源，請完成下列步驟：

1. 訂閱所選城市和國家/地區的房源資訊。如需操作說明，請參閱「設定地點洞察」。

   注意： 設定地點洞察時，請使用自己的命名慣例設定資料集名稱。如果保留預設資料集名稱，會與舊版資料無塵室的名稱衝突。

2. 將查詢或函式中的資料集名稱，更新為您在上方選擇的資料集名稱。

3. 如果您先前使用函式，請移除與資料無塵室搭配使用的專案名稱 (maps-platform-analytics-hub)。

4. 修改現有查詢或函式，加入專案名稱 (選用) 和新的地址欄位。

參照房源資訊時，請附上專案名稱 (選用)

使用清單時，您可以在查詢中加入專案名稱。如未指定專案名稱，查詢會預設為使用中的專案。

如果您已在不同專案中連結名稱相同的資料集，或是要查詢作用中專案以外的資料表，建議您加入專案名稱。

更新後的查詢範例 (含專案和資料集名稱)

這項查詢包含專案名稱，並使用資料集名稱 my_dataset_name：

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

改用新的地址欄位

在 Places Insights 的初始版本中，資料集結構定義將地址欄位表示為 STRUCT 或 RECORD，其中包含 id 和 name 子欄位。這個版本會將結構定義扁平化，為 id 和 name 定義個別的頂層欄位。新欄位為字串或字串陣列欄位。

注意： 如要使用新的地址欄位，您必須從資料淨室遷移至商家資訊。如果決定不遷移至房源，請繼續使用初始版本中的地址欄位。

舉例來說，初始版本的地區地址元件結構定義如下：

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

在此版本中，資料集現在包含兩個頂層字串陣列欄位。舉例來說，更新後的地區資料結構定義如下所示：

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

請參閱完整的架構參考資料。

注意： 部分國家/地區無法使用所有欄位。如要查看您所在國家/地區可用的欄位清單，請參閱國家/地區專屬結構化資料參考資料。

非陣列欄位

在此版本中，id 和 name 欄位現在是頂層 STRING 欄位，適用於非陣列地址欄位：

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

這個新格式適用於表單中的所有欄位，其中 N 為 1 到 7。administrative_area_level_N

注意： 部分administrative_area_level_N欄位可能不適用於某些國家/地區。如要查看您所在國家/地區可用的欄位清單，請參閱特定國家/地區的結構化資料參考資料。

使用新欄位的範例

在 Places Insights 的初始版本中，您會在 WHERE 子句中使用 administrative_area_level_1.name 欄位來篩選結果：

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

使用新欄位時，請使用 administrative_area_level_1_name 欄位編寫查詢：

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";