Places Aggregate API は、場所、タイプ、営業状況、価格帯、ユーザー評価などの条件に基づいて、指定したエリア内の場所に関する分析情報を提供するサービスです。このサービスは、特定の場所の周辺にある特定の場所タイプの密度を分析し、「この場所の半径 5 km 以内に 5 つ星の $$$ レストランはいくつあるか」などの質問に回答するのに役立ちます。
結果は、対象の検索エリア内の集計数または特定されたプレイス ID のいずれかとして返されます。ユーザーは Place Details API を使用して、これらの Place ID に関する詳細情報を取得できます。
Places Aggregate API を使用する理由
Places Aggregate API を使用すると、さまざまな場所に関する包括的な情報を提供して、ユーザーがデータドリブンな意思決定を行えるようになります。正確で最新の場所モデルを活用し、次の主なユースケースをサポートします。
- ビジネス: 競合状況と、新規支店の候補地を分析します。
- デベロッパー: パーソナライズされたおすすめを提供するアプリを作成します。
- 研究者: 特定の分野の傾向やパターンを調べる。
Places Aggregate API でできること
Places Aggregate API を使用すると、次の情報を取得できます。
- カウント: 条件に一致する場所の数を取得します。
- プレイス ID: 条件に一致する特定の場所のプレイス ID を取得します。
また、フィルタリングを使用して、場所の種類、営業時間、価格帯、顧客評価など、さまざまな属性に基づいて検索を絞り込むこともできます。
例
このセクションでは、Places Aggregate API のユースケースの例と、各例の動作コードについて説明します。
新しいカフェを開業する
レストランのオーナーが新しいカフェを開きたいと考えています。そのために、まずカフェのホットスポットの場所を可視化して、集中度の高いエリアと低いエリアを特定し、ビジネス上の意思決定に役立てたいと考えています。Places Aggregate API を使用すると、営業状況、価格帯、顧客評価などの属性に基づいて特定の半径内のカフェの数を分析し、次に店舗をオープンする場所をデータに基づいて決定できます。
不動産投資会社
ある不動産投資会社が、財務モデルを強化し、計画している不動産投資の ROI を正確に決定したいと考えています。Places Aggregate API を使用すると、投資対象となる物件の近くにある ATM、病院、交通機関の駅、食料品店などの設備に関する詳細なデータを収集して、投資対象となる物件の近くにある設備を把握できます。
小売配送サービス
小売配送サービスが新しい都市に拡大する場合、レストラン、コンビニエンス ストア、酒屋など、人気のある消費者向けのスポットの密度に基づいて、地域に割り当てる配送ドライバーの数を決定する必要があります。配送サービスは、API を使用して市内のこれらの施設の合計数をカウントし、リソースを効果的に計画して割り当てることができます。
Places Aggregate API の仕組み
Places Aggregate API では、フィルタを指定して検索条件を絞り込むことができます。分析情報の種類（INSIGHT_COUNT または INSIGHT_PLACES）を選択したら、次のフィルタ条件を追加できます。
- 位置情報: 円、領域、カスタム ポリゴンを使用して、対象エリアを定義します。
- タイプ: 興味のある場所のタイプを指定します。
- 営業状況: 営業状況に基づいて場所をフィルタします。
- 料金レベル: 料金レベルに基づいて場所をフィルタします。
- 評価: ユーザーの評価に基づいて場所をフィルタします。
API レスポンスの ComputeInsightsResponse オブジェクトには、リクエスト分析情報の結果が含まれます。たとえば、INSIGHT_COUNT を選択した場合、レスポンスには場所の合計数が含まれ、INSIGHT_PLACES を選択した場合は、レスポンスにプレイス ID のリストが含まれます。
Places Aggregate API の使用方法
| 1 | セットアップする。 | まず、Google Cloud プロジェクトを設定するから始め、以降の手順を完了します。 |
| 2 | リクエストを送信して、一致する場所の数を取得します。 | 最初のリクエストを送信するをご覧ください。 |
| 3 | リクエスト パラメータの詳細 | リクエスト パラメータをご覧ください。 |