Places Aggregate API は、場所、タイプ、営業状況、料金レベル、ユーザー評価などの条件に基づいて、指定したエリア内の場所に関するインサイトを提供するサービスです。このサービスを使用すると、特定の 場所タイプの周辺にある特定の場所の密度を分析したり、「この場所から半径 5 km 以内にある、5 つ星評価の $$$ レストランは何軒ありますか？」といった質問に答えたりできます。
結果は、対象の検索エリア内の集計数または特定されたプレイス ID として返されます。ユーザーは Place Details API を使用して、これらのプレイス ID に関する詳細情報を 取得できます。
Places Aggregate API を使用する理由
Places Aggregate API を使用すると、さまざまな場所に関する包括的な情報に基づいて、データに基づいた意思決定を行うことができます。正確で最新の場所モデルを活用することで、次の主なユースケースをサポートできます。
- 企業: 競合他社や新しい 支店の候補地を分析します。
- デベロッパー: パーソナライズされたおすすめを提供するアプリケーションを構築します。
- 研究者: 特定のエリアのトレンドとパターンを調査します。
Places Aggregate API でできること
Places Aggregate API を使用すると、次の情報を取得できます。
- カウント: 条件に一致する場所の数を取得します。
- プレイス ID: 条件に一致する特定の場所のプレイス IDを取得します 。
フィルタ を使用して、場所のタイプ、営業時間、料金レベル、顧客評価などのさまざまな属性に基づいて検索を絞り込むこともできます。
例
このセクションでは、Places Aggregate API の使用例について説明し、各例の動作するコードを示します。
新しいカフェのオープン
レストランのオーナーが新しいカフェをオープンしたいと考えています。そのため、まずカフェのホットスポットを可視化して、集中度の高いエリアと低いエリアを特定し、ビジネス上の意思決定に役立てたいと考えています。Places Aggregate API を使用すると、営業状況、料金レベル、顧客評価などの属性に基づいて、特定の半径内のカフェの数を分析し、次の店舗をオープンする場所についてデータに基づいた意思決定を行うことができます。
不動産投資会社
不動産投資会社は、財務モデルを強化し、計画している不動産投資の投資収益率を正確に判断したいと考えています。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 | リクエスト パラメータについて学習する。 | リクエスト パラメータをご覧ください。 |