最初のリクエストを行う

このドキュメントでは、Places Insights 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 Insights API レスポンス

上記のリクエストの例のレスポンスでは、条件に一致するレストランの数が表示されます。

{
  "count": "846"
}

次のステップ