Places API는 다양한 메서드를 통해 위치 데이터에 대한 HTTP 요청을 수락하는 서비스입니다. 시설, 지리적 위치 또는 주요 관심 장소에 관한 형식화된 위치 데이터와 이미지를 반환합니다.
Places API (신규)를 사용하는 이유
위치 인식 기능을 만들어 사용자에게 자세한 위치 데이터를 제공합니다. Places API (신규)를 통해 제공되는 데이터는 실제 세계에서 가장 정확하고 최신이며 포괄적인 장소 모델 중 하나를 기반으로 합니다. 다음은 애플리케이션의 사용 사례 예입니다.
주요 대도시 내 아파트 임대 정보를 표시하고 도시를 구체적으로 타겟팅합니다.
수령 또는 배송 상태 업데이트에 장소 세부정보를 포함합니다.
사용자가 제출한 사진 및 리뷰와 함께 특정 지역의 공원 목록을 표시합니다.
여행을 계획하는 사용자에게 경로 중간에 있는 시설의 연락처 정보, 리뷰, 가격 수준을 제공하세요.
Places API (신규)로 할 수 있는 작업
Places API (신규)를 사용하여 애플리케이션에 다음 기능을 포함할 수 있습니다.
텍스트 입력, 주변 위치, 모호하거나 범주형 사용자 검색어와 같은 다양한 유형의 사용자 검색어에서 장소 검색 결과를 제공합니다.
특정 텍스트 검색어 또는 카테고리 검색어와 같은 다양한 검색 유형에 자동 완성 기능을 사용 설정합니다.
영업시간, 요약, 사용자 리뷰, 사진 등 장소에 관해 반환되는 세부정보 유형을 세분화합니다.
애플리케이션에서 제공하는 위치에 고화질 사진을 추가합니다.
많은 Google Maps Platform API는 장소 ID를 지원합니다. 여기서 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 식별합니다. Places API (신규)를 비롯하여 Geocoding API, Routes API, Address Validation API 등 다양한 방법으로 장소 ID를 가져올 수 있습니다.
장소 ID가 있으면 Places API(신규)를 사용하여 특정 시설 또는 관심 장소에 대한 세부정보(예: 전체 주소, 전화번호, 사용자 평점, 리뷰)를 더 요청할 수 있습니다.
Places API (신규)의 작동 방식
Places API (신규)는 /places 또는 places:searchText와 같은 특정 서비스 엔드포인트가 포함된 표준 URL로 요청을 수락하고 JSON 응답을 반환합니다.
Places API (신규)는 API 키 및 OAuth 토큰으로 승인을 지원합니다.
다음 예에서는 API 키를 사용하여 장소 ID의 주소 구성요소를 반환하는 Place Details (신규) 요청을 실행합니다.
[null,null,["최종 업데이트: 2025-08-22(UTC)"],[[["\u003cp\u003eThe Places API provides location data and imagery for establishments, geographic locations, and points of interest through various methods.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the Places API to create location-aware features, such as place search, autocomplete, details retrieval, and photo integration.\u003c/p\u003e\n"],["\u003cp\u003eThe Places API offers two versions: Places API and Places API (New), with differences outlined in a guide for choosing the best fit for your project.\u003c/p\u003e\n"],["\u003cp\u003eYou can access places data through requests to specific service endpoints using an API key or OAuth token, receiving responses in JSON or XML format.\u003c/p\u003e\n"],["\u003cp\u003eDetailed steps for using the API include setup, text search, place details retrieval using place IDs, and accessing place photos.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/places/android-sdk/overview \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/place \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/overview \"View this page for the Web Service platform docs.\") \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\nIntroduction The Places API is a service that accepts HTTP requests for location data through a variety of methods. It returns formatted location data and imagery about establishments, geographic locations, or prominent points of interest. **Note:** Google Maps Platform provides separate versions of the Places library for [Android](/maps/documentation/places/android-sdk/overview), [iOS](/maps/documentation/places/ios-sdk/overview), and [JavaScript](/maps/documentation/javascript/places). We recommend that you use the version of the Places library specific to your platform. That is, if you are developing an Android app, you should use the Android version of Places.\n\nWhy use the Places API (New)\n\nCreate location-aware features to make detailed location data\navailable to your users. The data available through the\nPlaces API (New) is built on one of the most accurate, up-to-date,\nand comprehensive place models of the real world. Here are example use\ncases for applications:\n\n- Display condo rentals within major metropolitan areas with results targeted specifically to cities.\n- Include place details in a pickup or delivery status update.\n- Display a list of parks in an area along with user-submitted photos and reviews.\n- Provide people planning trips with contact information, reviews, and price levels for establishments along the way.\n\n| **Note:** Places API (New) is the current version. Places API is now Legacy and can no longer be enabled. Legacy documentation and migration guides are available on the [Legacy](/maps/documentation/places/web-service/overview-legacy) tab.\n\nWhat can you do with the Places API (New)\n\nYou can use the Places API (New) to include the following features\nin your applications:\n\n- Provide place search results from different types of users queries, such as text input, nearby locations, and ambiguous or categorical user queries.\n- Enable autocomplete features for different search types, either specific text queries or categorical queries.\n- Refine the type of details returned about a place, such as operating hours, a summary, user reviews, and a photo.\n- Add high-quality photos to locations served by your application.\n\nMany Google Maps Platform APIs support [place IDs](/maps/documentation/places/web-service/place-id), where\nthe place ID uniquely identifies a place in the Google Places database and\non Google Maps. There are many ways to obtain a place ID, including from\nthe Places API (New), but also from the [Geocoding API](/maps/documentation/geocoding), [Routes API](/maps/documentation/routes), and [Address Validation API](/maps/documentation/address-validation).\n\nOnce you have a place ID, you can use the Places API (New) to\nrequest more details about a particular establishment or point of\ninterest, such as its complete address, phone number, user rating, and\nreviews.\n\nHow the Places API (New) works\n\nPlaces API (New) accepts requests as a standard URL with a\nspecific service endpoint, such as `/places` or\n`places:searchText` and returns a JSON response.\nPlaces API (New) supports authorization by API key and OAuth token.\nThe following example makes a Place Details (New) request to return\nthe address components for a place ID using an API key: \n\n```html\nhttps://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY\n```\n\nHow to use the Places API (New) The steps below cover a typical use case scenario for using the Places API service. As you build out your solution, you can use additional endpoints, such as Nearby Search (New) and Place Photos (New).\n\n|---|---------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow and then learn [how to use your API key](/maps/documentation/places/web-service/get-api-key). |\n| 2 | **Try a basic text search** | Issue a text search by using [Text Search (New)](/maps/documentation/places/web-service/text-search). |\n| 3 | **Use the place ID for more details** | Many Google Maps Platform APIs return a place ID as part of a response. Use place IDs to get [Place Details (New)](/maps/documentation/places/web-service/place-details). |\n| 4 | **Get a photo for a place** | Place Photos (New) gives you access to the millions of photos stored in the Places database. Use [Place Photos (New)](/maps/documentation/places/web-service/place-photos) to access photos for a place. |"]]
