소개
Places API는 다양한 방법을 통해 위치 데이터에 대한 HTTP 요청을 수락하는 서비스입니다. 시설, 지리적 위치 또는 유명한 관심 장소에 관한 형식화된 위치 데이터와 이미지를 반환합니다.Places API (신규)를 사용하는 이유
위치 인식 기능을 만들어 사용자에게 자세한 위치 데이터를 제공하세요. Places API (신규)를 통해 제공되는 데이터는 가장 정확하고 최신이며 포괄적인 실제 장소 모델을 기반으로 합니다. 다음은 애플리케이션의 사용 사례입니다.
- 주요 대도시 지역 내의 콘도 임대 정보를 도시를 구체적으로 타겟팅한 검색 결과와 함께 표시합니다.
- 수령 또는 배송 상태 업데이트에 장소 세부정보를 포함합니다.
- 사용자가 제출한 사진과 리뷰와 함께 해당 지역의 공원 목록을 표시합니다.
- 여행을 계획하는 사용자에게 연락처 정보, 리뷰, 이동 경로에 있는 시설의 가격대를 제공합니다.
Places API (신규)로 할 수 있는 작업
Places API (New)를 사용하여 애플리케이션에 다음 기능을 포함할 수 있습니다.
- 텍스트 입력, 주변 위치, 모호하거나 범주화된 사용자 쿼리와 같은 다양한 유형의 사용자 쿼리에서 장소 검색 결과를 제공합니다.
- 특정 텍스트 쿼리 또는 카테고리 쿼리와 같은 다양한 검색 유형에 자동 완성 기능을 사용 설정합니다.
- 영업시간, 요약, 사용자 리뷰, 사진 등 장소에 관해 반환되는 세부정보의 유형을 개선합니다.
- 애플리케이션에서 제공하는 위치에 고화질 사진을 추가합니다.
많은 Google Maps Platform API가 장소 ID를 지원합니다. 장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. Places API (신규)뿐만 아니라 Geocoding API, Routes API, Address Validation API에서도 장소 ID를 가져올 수 있습니다.
장소 ID가 있으면 Places API (New)를 사용하여 전체 주소, 전화번호, 사용자 평점, 리뷰 등 특정 시설이나 관심 장소에 대한 자세한 정보를 요청할 수 있습니다.
Places API (신규) 작동 방식
Places API (New)는 /places 또는 places:searchText과 같은 특정 서비스 엔드포인트가 있는 표준 URL로 요청을 수락하고 JSON 응답을 반환합니다.
Places API (New)는 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 | 설정하기 | 결제를 설정하고, Places API (New)를 사용 설정하고, 첫 번째 요청을 합니다. |
| 2 | 기본 텍스트 검색 사용해 보기 | 텍스트 검색 (신규)을 사용하여 텍스트 검색을 실행합니다. |
| 3 | 장소 ID를 사용하여 자세한 정보 확인하기 | 많은 Google Maps Platform API가 응답의 일부로 장소 ID를 반환합니다. 장소 ID를 사용하여 장소 세부정보 (신규)를 가져옵니다. |
| 4 | 장소의 사진 가져오기 | 장소 사진 (신규)을 사용하면 장소 데이터베이스에 저장된 수백만 장의 사진에 액세스할 수 있습니다. 장소 사진 (신규)을 사용하여 장소의 사진에 액세스합니다. |