Places Aggregate API는 위치, 유형, 운영 상태, 가격대, 사용자 평점과 같은 기준에 따라 지정된 지역 내 장소에 관한 유용한 정보를 제공하는 서비스입니다. 이 서비스를 사용하면 지정된 위치 주변의 특정 장소 유형의 밀도를 분석하고 '이 위치에서 반경 5km 이내에 있는 별점 5개짜리 $$$ 레스토랑은 무엇이며 몇 개인가?'와 같은 질문에 답할 수 있습니다.
결과는 집계된 수 또는 관심 검색 영역에서 식별된 장소 ID로 반환됩니다. 사용자는 Place Details API를 사용하여 이러한 장소 ID에 관한 자세한 정보를 검색할 수 있습니다.
Places Aggregate API를 사용해야 하는 이유
Places Aggregate API를 사용하면 다양한 장소에 관해 제공되는 포괄적인 정보를 기반으로 사용자가 데이터 기반 결정을 내릴 수 있습니다. 정확하고 최신 장소 모델을 활용하여 다음과 같은 주요 사용 사례를 지원합니다.
필터링을 사용하여 장소 유형, 영업시간, 가격대, 고객 평가와 같은 다양한 속성을 기준으로 검색을 세부적으로 조정할 수도 있습니다.
예
이 섹션에서는 Places Aggregate API의 사용 사례를 설명하고 각 예시의 작동 코드를 포함합니다.
새 카페를 오픈하는 경우
레스토랑 주인이 새 카페를 열고 싶어 합니다. 이를 위해 먼저 카페의 핫스팟을 시각화하여 밀도가 높고 낮은 지역을 파악하여 비즈니스 결정을 내리고자 합니다. Places Aggregate API를 사용하면 운영 상태, 가격대, 고객 평가와 같은 속성을 기반으로 특정 반경 내 카페 수를 분석하여 다음 매장을 열 위치에 관한 데이터 기반 결정을 내릴 수 있습니다.
부동산 투자 회사는 재무 모델을 개선하고 계획된 부동산 투자의 ROI를 정확하게 파악하려고 합니다. Places Aggregate API를 사용하면 ATM, 병원, 대중교통역, 식료품점 등 잠재적 투자 부동산 근처의 편의시설에 관한 자세한 데이터를 수집하여 잠재적 투자 부동산 근처의 편의시설을 파악할 수 있습니다.
소매 배송 서비스
새 도시로 확장할 때 소매 배송 서비스는 레스토랑, 편의점, 주류 판매점과 같은 인기 있는 소비자 목적지의 밀도를 기반으로 지역에 할당할 배송 기사의 수를 결정해야 합니다. 배달 서비스는 API를 사용하여 도시 전체의 이러한 업체의 총수를 파악하여 리소스를 효과적으로 계획하고 할당할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Overview\n\n\u003cbr /\u003e\n\nThe Places Aggregate API is a service that provides insights about places within a\nspecified area based on criteria such as location, type, operating status, price\nlevel, and user ratings. This service can help analyze the density of specific\n[Place Types](/maps/documentation/places/web-service/place-types) around a given location, and answer questions like \"What, or\nhow many, 5-star rated $$$ restaurants are within a 5km radius of this\nlocation?\"\n\nResults are returned as either aggregated counts or the identified place IDs in\nthe search area of interest. Users can use the [Place Details API](/maps/documentation/places/web-service/place-details) to\nretrieve more information about those Place IDs.\n\nWhy use the Places Aggregate API\n--------------------------------\n\nThe Places Aggregate API empowers your users to make data-driven decisions based on\nthe comprehensive information you provide about various places. It leverages\naccurate and up-to-date place models, which supports the following key use\ncases:\n\n- **Businesses**: Analyze competition and potential locations for new branches.\n- **Developers**: Build applications that provide personalized recommendations.\n- **Researchers**: Examine trends and patterns in specific areas.\n\nWhat you can do with the Places Aggregate API\n---------------------------------------------\n\nWith the Places Aggregate API, you can get the following information:\n\n- **Counts**: Retrieve the number of places that match your criteria.\n- **Places IDs** : Retrieve [Place IDs](/maps/documentation/places/web-service/place-id) of specific places that match your criteria.\n\nYou can also use **filtering** to refine your search based on various attributes\nsuch as place types, operating hours, price levels, and customer ratings.\n| **Note:** Place IDs are returned only if the `count` is 100 or lower.\n\nExamples\n--------\n\nThis section describes example uses case for Places Aggregate API and includes\nworking code for each example.\n| **Tip:** The [Google Maps Platform Architecture Center](/maps/architecture) contains example use cases to help you build apps with Google Maps Platform. For an example using Places Aggregate API, see [Use Places Aggregate API to create a\n| custom location score](/maps/architecture/places-aggregate-location-score). This score will instantly communicate how suitable a location is for your customer's needs.\n\n### Opening a new cafe\n\nA restaurant owner wants to open a new cafe. To do so, they first want to\nvisualize where the hotspots of cafes are so that they can identify areas of\nhigh and low concentration to inform their business decision. The\nPlaces Aggregate API can help analyze the number of cafes within a specific radius\nbased on attributes like operation status, price levels, and customer ratings to\nmake a data-backed decision on where to open their next location.\n\n[View Sample](https://jsfiddle.net/29wufjrt/)\n\n### Real estate investment firm\n\nA real estate investment firm wants to enhance their financial models and\naccurately determine the ROI on their planned property investments. By using\nthe Places Aggregate API, they can gather detailed data on the amenities near\npotential investment properties, such as ATMs, hospitals, transit stations, and\ngrocery stores, so that they can understand the amenities near potential\ninvestment properties.\n\n### Retail delivery service\n\nWhen expanding into a new city, a retail delivery service needs to determine the\nnumber of delivery drivers to allocate to a region based on the density of\npopular consumer destinations, such as restaurants, convenience stores and\nliquor stores. Using the API, the delivery service counts the total number of\nthese establishments throughout the city so that they can plan and allocate\nresources effectively.\n\n[View Sample](https://jsfiddle.net/yb7c9q23/)\n\nHow the Places Aggregate API works\n----------------------------------\n\nThe Places Aggregate API lets you specify filters to narrow your search criteria.\nAfter you select an **Insight Type** of either `INSIGHT_COUNT` or\n`INSIGHT_PLACES`, you can add filter criteria, including the following:\n\n- **Location**: Define the area of interest using circles, regions, or custom polygons.\n- **Type**: Specify the types of places you're interested in.\n- **Operations Status**: Filter places based on their operational status.\n- **Price levels**: Filter places based on price levels.\n- **Ratings**: Filter places based on user ratings.\n\nThe API response [`ComputeInsightsResponse`](/maps/documentation/places-aggregate/reference/rest/v1/TopLevel/computeInsights#response-body) object contains the results of\nthe request insight. For example, if you selected `INSIGHT_COUNT`, the response\ncontains a total number of places, and if you selected `INSIGHT_PLACES`, the\nresponse contains a list of Place IDs.\n\nHow to use the Places Aggregate API\n-----------------------------------\n\n|---|---------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/places-aggregate/cloud-setup) and complete the instructions that follow. |\n| 2 | **Make a request to get the count of matching places.** | See [Make your first request](/maps/documentation/places-aggregate/make-your-first-request). |\n| 3 | **Learn about request parameters.** | See [Request parameters](/maps/documentation/places-aggregate/request-parameters). |\n\nWhat's next\n-----------\n\n- [Review pricing and usage limits](/maps/documentation/places-aggregate/usage-and-billing)\n- [View the API reference](/maps/documentation/places-aggregate/reference/rest)\n- [Review the FAQ](/maps/documentation/places-aggregate/faq)\n- [Review support options](/maps/documentation/places-aggregate/support)"]]
