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

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

試してみる

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

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

JSON 本文でリージョン パラメータとタイプ パラメータを指定して、リクエストを絞り込みます。この例は、サンフランシスコで営業しており、価格帯が中程度で、評価が 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. 必要に応じて、[標準パラメータを表示] を開いてパラメータを設定します。
3. 必要に応じて、[リクエスト本文] を編集します。
4. [Execute] ボタンを選択します。ダイアログで、リクエストの送信に使用するアカウントを選択します。

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

次のステップ

• Places Aggregate API でできることの例をご覧ください。
• リクエスト パラメータについて詳しく見ていきましょう。
• 完全な API ドキュメントをご覧ください。