Places Insights のデータ
Places Insights は、BigQuery で完全なデータセットとサンプル データセットを提供します。
サンプル データセットは、Places Insights を試用して、完全なデータセットを購入する前にプロダクトのユーザビリティと価値を評価できるようにすることを目的としています。サンプル データセットには、都市自体のデータのみが含まれています。周辺の大都市圏のデータは含まれません。
サンプル リスティングには、サポートされている各国の主要都市のデータが含まれています。
| アムステルダム（オランダ） | ヘルシンキ（フィンランド） | プロヴディフ（BG） |
| アンカラ（TR） | 香港（HK） | リファー（バーレーン） |
| アレキパ（PE） | ジャカルタ（ID） | ローマ（IT） |
| アテネ（GR） | ジェッダ（SA） | サンティアゴ（CL） |
| バート ガスタイン（オーストリア） | ヨハネスブルグ（南アフリカ） | サンパウロ（ブラジル） |
| ベルリン（ドイツ） | クアラルンプール（マレーシア） | シャールジャ（AE） |
| ブルノ（チェコ） | リスボン（PT） | シンガポール（SG） |
| ブリュッセル（ベルギー） | ロンドン（GB） | ストックホルム（SE） |
| ブカレスト（RO） | ルサイル（カタール） | シドニー（オーストラリア） |
| ブエノスアイレス（AR） | マドリード（スペイン） | 台北（TW） |
| 釜山（韓国） | マニラ（フィリピン） | テルアビブ（IL） |
| カイロ（EG） | メデジン（CO） | 東京（日本） |
| チェンマイ（TH） | メキシコシティ（MX） | トロント（カナダ） |
| コペンハーゲン（DK） | ムンバイ（IN） | ワルシャワ（PL） |
| コーク（IE） | ニューヨーク市（米国） | ウェリントン（ニュージーランド） |
| デブレツェン（ハンガリー） | オスロ（NO） | チューリッヒ（CH） |
| ハノイ（VN） | パリ（フランス） |
完全なデータセットには、サポートされている各国のデータが含まれており、購入する必要があります。Places Insights への登録をご希望の場合は、リクエスト フォームにご記入ください。Places Insights データセットへのアクセスをリクエストする必要があるのは、データ サブスクライバーのみです。BigQuery プロジェクトでサブスクリプションが有効になると、そのプロジェクトにアクセスできるユーザーは、Places Insights データをクエリできるようになります。
各国のデータセットには独自のリスティングがあり、個別に登録する必要があります。リスティングのサブスクリプションの詳細については、Places Insights を設定するをご覧ください。
データセット スキーマ
各国の場所データセット スキーマは、次の 2 つの部分で構成されています。
たとえば、スペイン（ES）のデータセットを操作する場合は、コアスキーマと ES 固有のスキーマの両方を参照します。
brands データセットのスキーマでは、次の 3 つのフィールドが定義されています。
id: ブランド ID。name: ブランドの名前（「Hertz」、「Chase」など）。category: ブランドの上位カテゴリ（「ガソリン スタンド」、「飲食」、「宿泊」など）。
Places Insights データをクエリする
Places Insights では、次の 2 つの方法でデータセットをクエリできます。
- SQL を使用してデータセットを直接クエリする: データセット テーブルに対して標準の BigQuery SQL クエリを実行します。これにより、複雑なフィルタリング、独自のデータとの結合、カスタム分析、
COUNT以外の追加の集計関数（AVG、SUM、GROUP BYなど）のサポートを最も柔軟に行うことができます。ドキュメントをご覧ください。 - Places Count 関数を使用してデータセットをクエリする: Places Count 関数は、BigQuery で直接実行され、一般的なデータ取得タスクを簡素化する、事前定義された最適化された SQL クエリです。プレイス ID を返して個々の場所の詳細を検索するなど、より詳細な分析情報を提供します。ドキュメントをご覧ください。
直接クエリ
データを直接クエリすると、集計しきい値が適用されます。結果は、クエリが 5 つ以上の場所を集計する場合にのみ返されます。たとえば、検索条件の結果が 0、1、2、3、4 のいずれかの場合、その結果はレスポンスから除外されます。たとえば、特定のエリアのレストランの合計数をクエリすると、合計数が 5 以上の場合にのみレスポンスが返されます。それ以外の場合はレスポンスが返されません。
Places Count 関数のクエリ
Places Count 関数は、プレイス ID のリストを返すことができます。このリストを使用して、Places API や Places UI Kit などの他の GMP プロダクトで個々の場所の情報を検索できます。
Places Count 関数では、集計しきい値は適用されませんが、代わりに 40.0 m × 40.0 m（1, 600 m2）の最小検索エリアが適用されます。つまり、検索クエリが最小検索エリアより大きい限り、クエリに一致する場所が 0 件の場合でも、常に結果が返されます。
データを直接クエリするタイミングと関数を使用するタイミング
低い結果数を必要としない場合、AVG、SUM、COUNTIF などの数を超える分析情報を取得する場合、またはデータセットの結合などのより複雑なクエリを実行する必要がある場合は、データを直接クエリします。
結果が少ないかゼロかどうかを確認する必要がある場合や、場所の名前や住所などの個々の場所情報を取得する必要がある場合は、関数を使用してクエリを実行します。
次の表は、直接クエリと Places Count 関数の違いを詳しく比較したものです。
| Places Count 関数 | 直接データセット クエリ | |
|---|---|---|
| メリット |
|
|
| インターフェース | COUNT 分析情報を生成する 4 つの事前定義 SQL 関数: 単一カウント、タイプごとのカウント、地域ごとのカウント、H3 セルごとのカウント。JSON_OBJECT は関数に引数を渡します。 |
独自の SQL を記述して、COUNT、COUNT_IF、SUM、AVG. などの集計関数を実行します。JOIN、GROUP BY、WHERE などを使用して、追加の分析情報を生成できます。 |
| 制限事項 | 40.0 m × 40.0 m（1,600 m2）の最小検索エリアを適用します。関数は、集計数が 5 未満であっても、最小検索エリアが満たされていれば結果を返します。 | カウントが 5 未満の結果は、結果から除外されます（つまり、行が除外されます）。 |
| サポートされている属性フィルタ | Places Count 関数のフィルタ パラメータは、以下を除き、直接クエリの属性フィルタと同じものをサポートしています。
|
完全なスキーマがサポートされています。 |