このプロダクトまたは機能は、pre-GA（一般提供前）のプレビュー版です。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、一般提供前のプロダクトや機能の変更は、他の一般提供前のバージョンと互換性がない可能性があります。pre-GA のサービスには、Google Maps Platform Service Specific Terms が適用されます。詳細については、リリースステージの説明をご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

人口動態の分析情報データについて

データを理解する

エンベディングは複数の国で利用できますが、スキーマはすべてのデータセットで一貫しています。エンベディングは、国ごとに個別の BigQuery リスティングに整理されています。

エンベディングベクトルの構造

features 列は 330 次元のベクトルです（BigQuery に REPEATED FLOAT 配列として保存されます）。配列の各セクションは、人口動態モデルによって抽出された特定のデータシグナルに対応しています。

この構造を理解することで、特徴の除去（たとえば、検索行動が売上を予測する程度を天気と比較して判断するなど）が可能になります。

ベクトルインデックス	データソース	説明
0 ～ 127	集計された検索トレンド	地域レベルで集計および匿名化された消費者の関心を捉えます（たとえば、「住宅リフォーム」、「ランニングシューズ」、「電気自動車」に対する相対的な地域の検索インタレスト）。未加工のクエリは公開されません。
128 ～ 255	マップと混雑状況	建造環境（レストラン、公園、学校などのスポット）と、集計および匿名化された公共施設の混雑状況を捉えます。
256 ～ 329	天気と大気質	環境コンテキスト（気温、降水量、AQI、風など）を捉えます。

主要な列とメタデータ

エンベディングテーブルには、地理空間分析、フィルタリング、他の Google Maps Platform サービスとの相互運用を可能にする空間メタデータが含まれています。

geo_id: リージョンのプライマリ ID。S2 セルデータセットの場合、これは 16 進文字列（たとえば、 '80ead45'）で表される S2 セルトークンです。これをプライマリ結合キーとして使用します。
geo_name: 人が読める形式のリージョン名。注: S2 グリッドデータセットの場合、数学的なセルには標準名がないため、この列には geo_id とまったく同じトークンが含まれます。これは、すべての人口動態サービスで一貫した列構造を維持するための設計です。
administrative_area_level_1_id: 最上位の行政境界（州や県など）の一意の Google マップのプレイス ID。
administrative_area_level_1_name: 最上位の境界の人が読める形式の名前（'California' など）。
administrative_area_level_2_id: 2 番目の行政境界（郡や区など）の一意の Google マップのプレイス ID。
administrative_area_level_2_name: 2 番目の境界の対人可読名（'Tulare County' など）。
features: コアの 330 次元のエンベディングベクトル。ネイティブに ARRAY<FLOAT64>として保存されます。これを Pandas Python ライブラリに読み込むには、平坦化するか NumPy 行列に変換する必要があります。

よくある質問（FAQ）

未加工の入力データ（特定の検索クエリや移動履歴など）にアクセスできますか？

いいえ。人口動態インサイトのエンベディングは、集計されたプライバシー保護シグナルから生成されます。ユーザーのプライバシーを保護するため、特定のユーザーの履歴、個々の検索履歴、未加工の移動パターンは提供していません。エンベディングは、未加工の分析ではなく、モデリングと予測に最適化されたこれらの行動の潜在的な表現を提供します。

ベクトルディメンションは解釈可能ですか（たとえば、ディメンション 5 は「コーヒー」ですか）？

ベクトルは潜在的な表現です。つまり、特定の対人可読ラベルではなく、抽象的なパターンを捉えます。インデックス 0 ～ 127 が検索トレンドから派生していることはわかっていますが、特定のインデックス（インデックス 5 など）は「コーヒー」などの単一のキーワードに 1 対 1 でマッピングされません。代わりに、モデルによって学習された検索行動の複雑な特徴を表します。

データセットにはポリゴン境界（シェープファイル）が含まれていますか？

データセットには、地理識別子（行政区画 1、行政区画 2 など）の S2 セルトークン（geo_id）とプレイス ID が用意されていますが、S2 セルリージョンの未加工のポリゴンジオメトリ（WKT/シェープファイル）は含まれていません。未加工のジオメトリを省略すると、ストレージの肥大化を防ぎ、特徴ベクトルのみを必要とする ML パイプラインの BigQuery スキャン費用を削減できます。さらに、S2 文字列トークンでの結合は、空間ポリゴンの交差を実行するよりも大幅に高速で、計算効率も優れています。

ポイント座標の場合: ポイントデータ（スポットの位置や店舗の中心など）を人口動態インサイトと結合するには、緯度/経度座標を S2 レベル 12 セルトークンに変換します。これには S2_CELLIDFROMPOINT と ST_GEOGPOINT を組み合わせます（ポイント座標を S2 レベル 12 の 16 進トークンに変換するをご覧ください）。
エリア境界の場合: カスタム境界を人口動態インサイトと交差させる必要がある場合は、カスタムポリゴンを S2 レベル 12 セルトークンに変換することをおすすめします（S2_COVERINGCELLIDS を使用）。ポリゴンの S2 レベル 12 セルトークンを生成するをご覧ください）。または、このデータセットを BigQuery 一般公開データで利用できる一般公開境界データセットと結合します。
可視化とジオメトリ変換の場合: BigQuery の組み込み地理空間関数は一方向の変換（ジオメトリ → S2 セル ID）を行います。マッピングツールや GIS ツールで S2 セルトークンをポリゴンジオメトリに変換するには、Python の s2sphereなどのクライアントサイドライブラリを使用します。コードサンプルと手順については、S2 レベル 12 の 16 進トークンから S2 セルジオメトリを取得するをご覧ください。