このページは Cloud Translation API によって翻訳されました。

場所のカウント関数を使用してデータセットをクエリする

プレイスカウント関数は、BigQuery で実行される事前定義済みの SQL クエリであり、データセットを直接クエリすることを補完します。データを直接クエリする場合と関数を使用する場合の主な違いは、関数では最小カウントしきい値が適用されず、代わりに最小検索領域が適用されることです。

プレイスデータセットクエリは 5 以上のカウントのみを返しますが、検索エリアのサイズに制限はありません。
場所のカウント関数は、0 を含む任意のカウントを返すことができますが、検索エリアの最小サイズは 40.0 メートル × 40.0 メートル（1,600 m²）に制限されます。関数はプレイス ID を返すこともできます。これは、個々のプレイスに関する情報を検索するために使用できます。

クエリで結果が返されなかった場合を把握することが重要な場合や、5 未満の場所の数が少ないことを把握する必要がある場合は、場所のカウント関数を使用することをおすすめします。また、結果をスポットチェックするために個々の場所の情報を取得する必要がある場合にも便利です。

Places Count 関数はカウントのみを提供します。データ結合などのより複雑なクエリを実行する必要がある場合や、場所のグループの平均評価などの追加の分析情報を取得する必要がある場合は、データセットに直接クエリを実行します。

サポートされている場所のカウント関数と国

Places Insights は、次の関数をサポートしています。

PLACES_COUNT: 場所の数を含む単一行を返します。
PLACES_COUNT_PER_TYPE: 場所のタイプごとの場所の数を BigQuery テーブルで返します。
PLACES_COUNT_PER_GEO: 地域ごとの場所の数を BigQuery テーブルで返します。
PLACES_COUNT_PER_H3: H3 セルあたりの場所の数の BigQuery テーブルを返します。

PLACES_COUNT_PER_TYPE、PLACES_COUNT_PER_GEO、PLACES_COUNT_PER_H3 の各関数は、場所の数とともに、レスポンスの要素ごとに最大 250 個の場所 ID も返します。すべてのフィルタパラメータを表示。

場所 ID は、次のものに使用できます。

関数を使用してクエリを作成する

関数を呼び出すには、[project name (optional)].[table name].[function name] の形式を使用します。

プレイス分析の設定時にリンクされたデータセット名を変更した場合は、ここに記載されているデフォルトのテーブル名ではなく、カスタム名を使用してください。必要に応じて、プロジェクト名を含めることもできます。含まれていない場合、クエリはデフォルトでアクティブなプロジェクトになります。

次に例を示します。

PROJECT_NAME.places_insights___us.PLACES_COUNT

JSON_OBJECT を使用して、関数に引数を渡します。

検索結果を絞り込む

場所のカウント関数は、検索を絞り込むための多くのフィルタをサポートしています。これらのパラメータ（price_level や types など）では大文字と小文字が区別されるため、パラメータ名と正確に一致している必要があります。オプションの完全なリストについては、フィルタパラメータのリファレンスをご覧ください。

次の例では、フィルタを適用して、ユーザーの最低評価、価格帯、ビジネスステータス、犬の入店可否で検索を制限します。

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

場所のカウント関数の例

次の例では、PLACES_COUNT 関数を使用して、ニューヨーク市のエンパイアステートビルから 1,000 メートル以内の営業中のレストランの数を返します。

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

レスポンスには 1 つのカウントが含まれます。

ニューヨーク市の Place Count 関数の結果。

この例では、BigQuery の ST_GEOGPOINT 関数を使用して、ポイントから GEOGRAPHY 値を返し、その値を geography パラメータに渡します。また、ポイントを中心とした検索範囲と、検索する場所のタイプ "restaurant" も渡します。

タイプ、地域、H3 ごとの場所の数の例

PLACES_COUNT_PER_TYPE、PLACES_COUNT_PER_GEO、PLACES_COUNT_PER_H3 関数は、場所の数とともに、レスポンスに含まれる場所の場所 ID を最大 250 個返します。

たとえば、PLACES_COUNT_PER_TYPE 関数は、プレイスタイプごとの場所の数のテーブルを返します。レスポンスには、各タイプに一致する場所のプレイス ID の配列が含まれます。返されたプレイス ID を使用して、各場所に関する情報を検索できます。

次の関数呼び出しは、restaurant、cafe、bar のタイプの場所の数を返します。

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

この関数は、type、count、sample_place_ids の 3 つの列を含むテーブルを返します。count 列には各 type の場所の数が表示され、sample_place_ids 列には各 type の場所 ID が最大 250 個表示されます。

ニューヨーク市の Place Count Type 関数の結果。

結果を可視化する

BigQuery データから分析情報を得るには、分析ツールとビジネスインテリジェンスツールが不可欠です。BigQuery は、Places Insights データの関数結果の分析に使用できる、Google およびサードパーティのデータ可視化ツールをいくつかサポートしています。

関数の結果を可視化する例については、結果を可視化するをご覧ください。Places Insights の結果を可視化する方法と例については、クエリ結果を可視化するをご覧ください。

制限事項と要件

プレイスカウント関数には、次の制限と要件があります。

COUNT の分析情報のみがサポートされています。
最小検索エリアは 40.0 メートル × 40.0 メートル（1,600 m²）です。
Place 関数カウントパラメータの入力サイズは 1 MB に制限されています。
場所 ID、ブランド、EV 充電オプション、住所コンポーネントによるフィルタリングはサポートされていません。
場所のカウント関数にアクセスできるのは、登録した市区町村と国のみです。データセットへのアクセスについては、Places Insights を設定するをご覧ください。
フィルタパラメータ（geography や types など）では大文字と小文字が区別されます。パラメータ名と完全に一致しない場合、クエリは失敗します。