最初のリクエストを行う

このドキュメントでは、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": "850"
}

試してみよう:

API Explorer では、サンプル リクエストを実行して、API と API オプションを把握できます。

  1. ページの右側にある API アイコン API Explorer を開きます。 を選択します。
  2. 必要に応じて、[標準パラメータを表示する] を開いてパラメータを設定します。
  3. 必要に応じて、[リクエスト本文] を編集します。
  4. [Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。

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

次のステップ