Places API를 사용하는 이유
위치 인식 기능을 만들어 사용자에게 자세한 위치 데이터를 제공하세요. Places API를 통해 제공되는 데이터는 실제 세계에서 가장 정확하고 최신이며 포괄적인 장소 모델 중 하나를 기반으로 합니다. 다음은 애플리케이션의 사용 사례 예입니다.
- 주요 대도시 내 아파트 임대 정보를 표시하고 도시를 구체적으로 타겟팅합니다.
- 수령 또는 배송 상태 업데이트에 장소 세부정보를 포함합니다.
- 사용자가 제출한 사진 및 리뷰와 함께 특정 지역의 공원 목록을 표시합니다.
- 여행을 계획하는 사용자에게 경로에 있는 시설의 연락처 정보, 리뷰, 가격 수준을 제공하세요.
Places API로 할 수 있는 작업
Places API를 사용하여 애플리케이션에 다음 기능을 포함할 수 있습니다.
- 텍스트 입력, 주변 위치, 모호하거나 범주형 사용자 검색어와 같은 다양한 유형의 사용자 검색어에서 장소 검색 결과를 제공합니다.
- 특정 텍스트 검색어 또는 카테고리 검색어와 같은 다양한 검색 유형에 자동 완성 기능을 사용 설정합니다.
- 영업시간, 요약, 사용자 리뷰, 사진 등 장소에 관해 반환되는 세부정보 유형을 세분화합니다.
- 애플리케이션에서 제공하는 위치에 고화질 사진을 추가합니다.
많은 Google Maps Platform API는 장소 ID를 지원합니다. 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 장소 ID를 가져오는 방법에는 여러 가지가 있습니다. Places API를 비롯하여 Geocoding API, Routes API, Address Validation API를 통해서도 가져올 수 있습니다.
장소 ID가 있으면 Places API를 사용하여 특정 시설 또는 관심 장소에 대한 세부정보(예: 전체 주소, 전화번호, 사용자 평점, 리뷰)를 요청할 수 있습니다.
Places API (신규)의 작동 방식
Places API (신규)는 /places 또는 places:searchText와 같은 특정 서비스 엔드포인트가 포함된 표준 URL로 요청을 수락하고 JSON 응답을 반환합니다. Places API (신규)는 API 키 및 OAuth 토큰을 통한 승인을 지원합니다.
다음 예에서는 API 키를 사용하여 장소 ID의 주소 구성요소를 반환하는 Place Details (New) 요청을 실행합니다.
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API 사용 방법
아래 단계에서는 Places API 서비스를 사용하는 일반적인 사용 사례 시나리오를 설명합니다. 솔루션을 빌드할 때 주변 지역 검색 (신규) 및 장소 사진 (신규)과 같은 추가 엔드포인트를 사용할 수 있습니다.| 1 | 설정하기 | Google Cloud 프로젝트 설정으로 시작하여 다음 설정 안내를 완료한 후 API 키 사용 방법을 알아봅니다. |
| 2 | 기본 텍스트 검색 사용해 보기 | 텍스트 검색 (신규)를 사용하여 텍스트 검색을 실행합니다. |
| 3 | 장소 ID를 사용하여 세부정보 확인하기 | 많은 Google Maps Platform API는 응답의 일부로 장소 ID를 반환합니다. 장소 ID를 사용하여 장소 세부정보 (신규)를 가져옵니다. |
| 4 | 장소의 사진을 가져오기 | 장소 사진 (신규) 서비스를 사용하면 장소 데이터베이스에 저장된 수백만 장의 사진에 액세스할 수 있습니다. 장소 사진 (신규)을 사용하여 장소의 사진에 액세스합니다. |