이 제품은 기존 상태입니다. 2026년 10월부터는 새 Google Cloud 프로젝트에 Places API (기존)를 더 이상 사용 설정할 수 없습니다. 기존 프로젝트는 계속해서 완전히 지원됩니다. 새로운 기능과 향상된 성능을 위해 Places API (신규)로 이전하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

장소 검색

유럽 경제 지역 (EEA) 개발자

참고: 서버 측 및 클라이언트 측 라이브러리

Places API는 Google 지도 서비스용 Java 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트에서도 사용할 수 있습니다. Places API 및 클라이언트 라이브러리는 서버 애플리케이션에서 사용하기 위한 것입니다.

클라이언트 측 애플리케이션을 빌드하는 경우 Android용 Places SDK (신규), iOS용 Places SDK (신규), 장소 라이브러리, Maps JavaScript API를 살펴보세요.

Places API를 사용하면 시설, 주요 관심 장소, 지리적 위치 등 다양한 카테고리를 사용하여 장소 정보를 검색할 수 있습니다. 근접성 또는 텍스트 문자열로 장소를 검색할 수 있습니다. 장소 검색은 각 장소에 관한 요약 정보와 함께 장소 목록을 반환합니다. 장소 세부정보 (기존) 쿼리를 사용하여 추가 정보를 확인할 수 있습니다.

검색 유형 비교

특성이 서로 다른 세 가지 검색 엔드포인트를 사용할 수 있습니다. 다음 표에서는 이러한 차이점 중 일부를 보여줍니다.

유형	필드 선택	텍스트 검색 (기존)	모호한 텍스트	위치 필터	추가 필터
장소 찾기 (기존)		`input`
Nearby Search (기존)		`keyword`
텍스트 검색 (기존)		`query`

필드 선택

특정 필드만 반환하도록 주변 검색 (기존) 또는 텍스트 검색 (기존)을 제한할 수 있는 방법은 없습니다. 필요하지 않은 데이터를 요청하고 비용을 지불하지 않으려면 장소 찾기(기존) 요청을 대신 사용하세요.

모호한 텍스트

장소 검색 (기존) 및 텍스트 검색 (기존)은 여러 필드에서 모호한 텍스트를 일치시키는 데 최적화되어 있는 반면, 주변 검색 (기존)은 필드의 하위 집합에서 엄격한 일치로 제한됩니다.

추가 필터

주변 검색 (기존) 및 텍스트 검색 (기존)에서는 검색 결과를 필터링하는 추가 매개변수(예: minprice, maxprice, opennow, type)를 허용합니다.