이 제품 또는 기능은 기존 상태입니다. 기존 상태에 대한 자세한 내용은
기존 제품 및 기능을 참고하세요. Places API (신규)로 이전하려면
이전 가이드를 참고하세요.
장소 검색
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Places API를 사용하면 시설, 주요 관심 장소, 지리적 위치 등 다양한 카테고리를 사용하여 장소 정보를 검색할 수 있습니다. 근접성 또는 텍스트 문자열로 장소를 검색할 수 있습니다. 장소 검색은 각 장소에 관한 요약 정보와 함께 장소 목록을 반환합니다. 장소 세부정보 (기존) 쿼리를 사용하여 추가 정보를 확인할 수 있습니다.
검색 유형 비교
특성이 서로 다른 세 가지 검색 엔드포인트를 사용할 수 있습니다. 다음 표에서는 이러한 차이점 중 일부를 보여줍니다.
필드 선택
특정 필드만 반환하도록 주변 검색 (기존) 또는 텍스트 검색 (기존)을 제한할 수 있는 방법은 없습니다. 필요하지 않은 데이터를 요청하고 비용을 지불하지 않으려면 장소 찾기(기존) 요청을 대신 사용하세요.
모호한 텍스트
장소 검색 (기존) 및 텍스트 검색 (기존)은 여러 필드에서 모호한 텍스트를 일치시키는 데 최적화되어 있는 반면, 주변 검색 (기존)은 필드의 하위 집합에서 엄격한 일치로 제한됩니다.
추가 필터
주변 검색 (기존) 및 텍스트 검색 (기존)에서는 검색 결과를 필터링하는 추가 매개변수(예: minprice
, maxprice
, opennow
, type
)를 허용합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[],[],null,["# Place Search\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n**Note: Server-side\nand client-side libraries**\n\nThe Places API is also available with the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/places/web-service/client-library).\nThe Places API and the client libraries are for\nuse in server applications.\n\nIf you're building a client-side\napplication, take a look at the\n[Places SDK for Android (New)](/maps/documentation/places/android-sdk), the\n[Places SDK for iOS (New)](/maps/documentation/places/ios-sdk), and the\n[Places Library, Maps JavaScript API](/maps/documentation/javascript/places).\n\nThe Places API lets you search for place information\nusing a variety of categories, including establishments, prominent points of\ninterest, and geographic locations. You can search for places either by\nproximity or a text string. A Place Search returns a list of places along with\nsummary information about each place; additional information is available using\na [Place Details (Legacy)](/maps/documentation/places/web-service/details) query.\n\nCompare search types\n--------------------\n\nThere are three search endpoints available with different characteristics. The following table\nhighlights some of these differences.\n\n| Type | [Field selection](#field-selection) | Text Search (Legacy) | [Ambiguous text](#ambiguous-text) | Location filter | [Additional filters](#additional-filters) |\n|----------------------------------------------------------------------------------------|-------------------------------------|----------------------|-----------------------------------|-----------------|-------------------------------------------|\n| [Find Place (Legacy)](/maps/documentation/places/web-service/legacy/search-find-place) | | `input` | | | |\n| [Nearby Search (Legacy)](/maps/documentation/places/web-service/legacy/search-nearby) | | `keyword` | | | |\n| [Text Search (Legacy)](/maps/documentation/places/web-service/legacy/search-text) | | `query` | | | |\n\n### Field selection\n\nThere is no way to constrain Nearby Search (Legacy) or Text Search (Legacy) to only return specific fields. To\nkeep from requesting (and paying for) data that you don't need, use a Find Place (Legacy) request instead.\n\n### Ambiguous text\n\nFind Place (Legacy) and Text Search (Legacy) are optimized for matching ambiguous text across a number of fields\nwhile Nearby Search (Legacy) is constrained to strict matches on a subset of fields.\n\n### Additional filters\n\nNearby Search (Legacy) and Text Search (Legacy) allow additional parameters to filter results,\n(e.g. `minprice`, `maxprice`, `opennow`, and `type`)."]]