첫 번째 요청하기

이 문서에서는 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 아이콘 , 을 선택합니다.
2. 원하는 경우 표준 매개변수 표시 를 펼쳐 매개변수를 설정합니다.
3. 원하는 경우 요청 본문 을 수정합니다.
4. 실행 버튼을 선택합니다. 대화상자에서 요청을 만드는 데 사용할 계정 을 선택합니다.

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

다음 단계

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