첫 번째 요청하기

이 문서에서는 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 탐색기를 사용하면 API 및 API 옵션에 익숙해지도록 샘플 요청을 할 수 있습니다.

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

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

다음 단계

  • Places Aggregate API로 할 수 있는 작업의 예시를 자세히 알아보세요.
  • 요청 매개변수를 자세히 살펴보세요.
  • 전체 API 문서를 확인하세요.