移行ガイド

2025 年 9 月 4 日の Places Insights リリースでは、最初のリリースから次の点が変更されています。

任意の BigQuery ロケーションで Places Insights に登録できるようになりました。
Places Insights データセットがデータクリーンルームから BigQuery データエクスチェンジリスティングに移動しました。
データセットスキーマのアドレスフィールドで、id フィールドと name フィールドが個別の文字列フィールドまたは文字列配列フィールドに分割されました。

リスティングに移行する

Places Insights の最初のプレビュー版では、データが BigQuery データクリーンルームにデプロイされていました。 2025 年 9 月 4 日のリリースでは、特定の BigQuery リージョンでデータセットに登録できるように、データセットが BigQuery リスティングに移動しました。この変更は、Places Insights のプロダクト機能と使いやすさに影響しません。

特定のリージョンで Places Insights に登録するには、BigQuery Sharing で新しいリスティングに登録する必要があります。新しいリスティングに登録したら、SQL クエリを変更する必要はありません。これまでどおり機能します。

新規ユーザー: Places Insights を初めて使用する場合は、 Places Insights を設定するの手順に沿って、リスティングにアクセスするための開発環境を構成してください。
既存のユーザー: リスティングを使用するように移行するには、次の手順に沿って操作してください。

移行手順

リスティングに移行するには、次の操作を行う必要があります。

選択した都市と国のリスティングに登録します。手順については、Places Insights を設定するをご覧ください。

注: Places Insights を設定するときは、独自の命名規則を使用するようにデータセット名を設定してください。デフォルトのデータセット名のままにすると、従来のデータクリーンルームの名前と競合します。
クエリまたは関数のデータセット名を、上記で選択したデータセット名に更新します。
以前に関数を使用していた場合は、データクリーンルームで使用していたプロジェクト名（maps-platform-analytics-hub）を削除します。
既存のクエリまたは関数を変更して、プロジェクト名（省略可）と新しいアドレスフィールドを含めます。

リスティングを参照するときにプロジェクト名を含める（省略可）

リスティングでは、クエリにプロジェクト名を含めることができます。プロジェクト名を指定しない場合、クエリはデフォルトでアクティブなプロジェクトになります。

異なるプロジェクトで同じ名前のリンク済みデータセットがある場合や、アクティブなプロジェクト外のテーブルに対してクエリを実行する場合は、プロジェクト名を含めることをおすすめします。

プロジェクト名とデータセット名を含む更新されたクエリの例

このクエリにはプロジェクト名が含まれており、データセット名 my_dataset_name を使用しています。

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

新しいアドレスフィールドに移行する

Places Insights の最初のリリースでは、データセットスキーマは、id サブフィールドと name サブフィールドを含む STRUCT または RECORD としてアドレスフィールドを表していました。このリリースでは、スキーマがフラット化され、id と name の個別の最上位フィールドが定義されています。新しいフィールドは、文字列フィールドまたは文字列配列フィールドです。

たとえば、最初のリリースでの地域区分アドレスコンポーネントのスキーマは次のようになります。

`locality`		`STRUCT`
	`locality.id`	`STRING`
	`locality.name`	`STRING`

このリリースでは、データセットに 2 つの最上位文字列配列フィールドが含まれるようになりました。たとえば、更新された地域データスキーマは次のようになります。

`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 形式のすべてのフィールドに適用されます。

新しいフィールドを使用する例

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";