첫 번째 요청 만들기

이 문서에서는 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 탐색기를 사용하면 샘플 요청을 실행하여 API 및 API 옵션을 익힐 수 있습니다.

  1. 페이지 오른쪽에 있는 API 아이콘 API 탐색기를 펼칩니다.을 선택합니다.
  2. 원하는 경우 표준 매개변수 표시를 펼치고 매개변수를 설정합니다.
  3. 원하는 경우 요청 본문을 수정합니다.
  4. 실행 버튼을 선택합니다. 대화상자에서 요청하는 데 사용할 계정을 선택합니다.

  5. API 탐색기 패널에서 펼치기 아이콘 API 탐색기를 펼칩니다.을 선택하여 API 탐색기 창을 펼칩니다.

다음 단계