2025 年 9 月 4 日リリースの Places Insights には、初回リリースからの以下の変更が含まれています。
- 任意の BigQuery ロケーションで Places Insights を購読する機能をサポートします。
Places Insights データセットをデータ クリーンルームから BigQuery データ エクスチェンジ リスティングに移動します。
データセット スキーマのアドレス フィールドは、
idフィールドとnameフィールドを個別の文字列フィールドまたは文字列配列フィールドに分割します。
リスティングに移行する
Places Insights の最初のプレビュー リリースでは、BigQuery のデータ クリーンルームにデータがデプロイされました。2025 年 9 月 4 日のリリースで、データセットを BigQuery のリスティングに移動しました。これにより、特定の BigQuery リージョンでデータセットをサブスクライブできるようになりました。この変更は、プレイス分析のプロダクト機能とユーザビリティには影響しません。
特定の地域の Places Insights に登録するには、BigQuery Sharing で新しいリスティングに登録する必要があります。新しいリスティングをサブスクライブすると、SQL クエリを変更する必要はありません。機能はこれまでと変わりません。
新規ユーザー: 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 |
この新しい形式は、フォーム administrative_area_level_N のすべてのフィールドに適用されます。ここで、N は 1 ～ 7 です。
新しいフィールドの使用例
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";