Places API (New)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Places API를 사용하면 개발자가 장소의 다양한 검색 및 가져오기 엔드포인트에 액세스할 수 있습니다.
서비스: places.googleapis.com
이 서비스를 호출하려면 Google에서 제공하는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 서비스를 호출해야 한다면 API를 요청할 때 다음 정보를 사용하세요.
검색 문서
검색 문서는 머신에서 읽을 수 있는 사양이며 REST API를 설명하고 사용하는 데 참조할 수 있습니다. 또한 클라이언트 라이브러리, IDE 플러그인, 기타 Google API와 상호작용하는 도구를 빌드하는 데 사용됩니다. 하나의 서비스는 여러 개의 검색 문서를 제공할 수 있습니다. 이 서비스는 다음 검색 문서를 제공합니다.
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기본 URL입니다. 하나의 서비스에 여러 서비스 엔드포인트가 있을 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.
https://places.googleapis.com
| 방법 |
autocomplete |
POST /v1/places:autocomplete
지정된 입력에 대한 예측을 반환합니다. |
get |
GET /v1/{name=places/*}
리소스 이름(places/{place_id} 형식의 문자열)을 기준으로 장소의 세부정보를 가져옵니다. |
searchNearby |
POST /v1/places:searchNearby
위치 주변 장소를 검색합니다. |
searchText |
POST /v1/places:searchText
텍스트 쿼리 기반 장소 검색 |
| 방법 |
getMedia |
GET /v1/{name=places/*/photos/*/media}
사진 참조 문자열이 포함된 사진 미디어를 가져옵니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eThe Places API gives developers access to search and retrieval endpoints for places data.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers functionalities such as place autocomplete, details retrieval, nearby search, and text-based search.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can retrieve photos associated with places using the \u003ccode\u003eplaces.photos\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eThe service endpoint for the Places API is \u003ccode\u003ehttps://places.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGoogle-provided client libraries are recommended for interacting with the API.\u003c/p\u003e\n"]]],["The Places API offers `v1.places` and `v1.places.photos` resources via the `places.googleapis.com` service. Developers can utilize Google-provided client libraries or their own to make API requests. The `v1.places` resource supports methods for place-related actions such as `autocomplete`, `get` (details), `searchNearby`, and `searchText`. The `v1.places.photos` resource's `getMedia` method retrieves photo media using a photo reference string. The service's base URL is `https://places.googleapis.com`.\n"],null,["# Places API (New)\n\nThe Places API allows developers to access a variety of search and retrieval endpoints for a Place.\n\n- [REST Resource: v1.places](#v1.places)\n- [REST Resource: v1.places.photos](#v1.places.photos)\n\nService: places.googleapis.com\n------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://places.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://places.googleapis.com`\n\nREST Resource: [v1.places](/maps/documentation/places/web-service/reference/rest/v1/places)\n-------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| [autocomplete](/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete) | `POST /v1/places:autocomplete` Returns predictions for the given input. |\n| [get](/maps/documentation/places/web-service/reference/rest/v1/places/get) | `GET /v1/{name=places/*}` Get the details of a place based on its resource name, which is a string in the `places/{place_id}` format. |\n| [searchNearby](/maps/documentation/places/web-service/reference/rest/v1/places/searchNearby) | `POST /v1/places:searchNearby` Search for places near locations. |\n| [searchText](/maps/documentation/places/web-service/reference/rest/v1/places/searchText) | `POST /v1/places:searchText` Text query based place search. |\n\nREST Resource: [v1.places.photos](/maps/documentation/places/web-service/reference/rest/v1/places.photos)\n---------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|\n| [getMedia](/maps/documentation/places/web-service/reference/rest/v1/places.photos/getMedia) | `GET /v1/{name=places/*/photos/*/media}` Get a photo media with a photo reference string. |"]]
