Places Insights のデータ
Places Insights では、BigQuery で 完全なデータセットとサンプル データセットが提供されます。
サンプル データセットは、Places Insights を試して、完全なデータセットを購入する前にプロダクトの使いやすさと価値を評価できるようにするためのものです。サンプル データセットには、都市自体のデータのみが含まれます。周辺の都市圏のデータは含まれません。
サンプル リスティングには、サポートされている各国の主要都市のデータが含まれています。
| アムステルダム（オランダ） | ヘルシンキ（フィンランド） | プロブディフ（ブルガリア） |
| アンカラ（トルコ） | 香港（香港） | リッファ（バーレーン） |
| アレキパ（ペルー） | ジャカルタ（インドネシア） | ローマ（イタリア） |
| アテネ（ギリシャ） | ジッダ（サウジアラビア） | サンティアゴ（チリ） |
| バートガスタイン（オーストリア） | ヨハネスブルグ（南アフリカ） | サンパウロ（ブラジル） |
| ベルリン（ドイツ） | クアラルンプール（マレーシア） | シャルジャ（アラブ首長国連邦） |
| ブルノ（チェコ） | リスボン（ポルトガル） | シンガポール（シンガポール） |
| ブリュッセル（ベルギー） | ロンドン（イギリス） | ストックホルム（スウェーデン） |
| ブカレスト（ルーマニア） | ルサイル（カタール） | シドニー（オーストラリア） |
| ブエノスアイレス（アルゼンチン） | マドリード（スペイン） | 台北（台湾） |
| 釜山（韓国） | マニラ（フィリピン） | テルアビブ-ヤッファ（イスラエル） |
| カイロ（エジプト） | メデジン（コロンビア） | 東京（日本） |
| チェンマイ（タイ） | メキシコシティ（メキシコ） | トロント（カナダ） |
| コペンハーゲン（デンマーク） | ムンバイ（インド） | ワルシャワ（ポーランド） |
| コーク（アイルランド） | ニューヨーク（米国） | ウェリントン（ニュージーランド） |
| デブレツェン（ハンガリー） | オスロ（ノルウェー） | チューリッヒ（スイス） |
| ハノイ（ベトナム） | パリ（フランス） |
完全なデータセットには、サポートされている各国のデータが含まれており、購入する必要があります。 Places Insights への登録をご希望の場合は、リクエスト フォームにご記入ください。 Places Insights データセットへのアクセス権をリクエストする必要があるのは、データ サブスクライバーのみです。BigQuery プロジェクトでサブスクリプションが有効になると、そのプロジェクトにアクセスできるユーザーは誰でも Places Insights のデータをクエリできます。
各国のデータセットには、個別にサブスクライブする必要がある独自のリスティングがあります。 リスティングのサブスクライブについて詳しくは、Places Insightsを設定するをご覧ください。
データセット スキーマ
各国のプレイス データセット スキーマは、次の 2 つの部分で構成されています。
たとえば、スペイン（ES）のデータセットを使用している場合は、コア スキーマと ES 固有のスキーマの両方を参照します。
ブランド データセットのスキーマでは、次の 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 のリストを返すことができます。このリストを使用して、 他の GMP プロダクト（Places API や Places UI Kit など）を使用して個々のプレイス情報を検索できます。
Places Count 関数では、集計のしきい値は適用されませんが、代わりに 最小検索エリアは 40.0 メートル × 40.0 メートル（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 メートル × 40.0 メートル（1,600 m2）に設定されます。最小検索エリアが満たされていれば、集計カウントが 5 未満の場合でも、関数は結果を返します。 | カウントが 5 未満の結果は、結果から除外されます（つまり、行が除外されます）。 |
| サポートされている属性フィルタ | Places Count 関数のフィルタ パラメータは、直接クエリの属性フィルタと同じものをサポートしています。ただし、次のものは除きます。
|
完全なスキーマがサポートされています。 |