最初のリクエストを送信する

このドキュメントでは、Places Aggregate API への基本的なリクエストの作成と、一致する場所の数を含むレスポンスの理解について説明します。

試してみる

Places Aggregate API を使用するには、次のように computeInsights エンドポイントに HTTP POST リクエストを送信します。

https://areainsights.googleapis.com/v1:computeInsights

JSON 本文に region パラメータと type パラメータを指定して、リクエストを絞り込みます。次の例は、営業中で、中程度の価格帯で、評価が 4 ～ 5 のサンフランシスコのレストランの数を返すリクエストを示しています。

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
   "insights":[
      "INSIGHT_COUNT"
   ],
   "filter":{
      "locationFilter":{
         "region":{
            "place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo"
         }
      },
      "typeFilter":{
         "includedTypes":[
            "restaurant"
         ]
      },
      "operatingStatus":[
         "OPERATING_STATUS_OPERATIONAL"
      ],
      "priceLevels":[
         "PRICE_LEVEL_INEXPENSIVE"
      ],
      "ratingFilter":{
         "minRating":4.0,
         "maxRating":5.0
      }
   }
}'

Places Aggregate API レスポンス

上記のサンプル リクエストからの次のレスポンスは、条件に一致するレストランの数を示しています。

{
  "count": "850"
}

試してみる

API Explorer を使用すると、サンプル リクエストを作成して、API と API オプションに慣れることができます。

1. ページの右側にある API アイコン を選択します。
2. 必要に応じて [**Show standard parameters**] を開いて、 パラメータを設定します。
3. 必要に応じて [Request body] を編集します。
4. [Execute] ボタンを選択します。ダイアログで、リクエストの送信に使用するアカウント を選択します。

5. API Explorer パネルで、展開アイコン を選択して、API Explorer ウィンドウを開きます。

次のステップ

• Places Aggregate API で実現できることの例をさらに確認する。
• リクエスト パラメータの詳細を確認する。
• 完全な API ドキュメントを確認する。