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는 다음 두 가지 API 버전을 지원합니다. Places API는 기존 API 및 Places API (신규)는 차세대 버전의 API입니다.
Places API (신규)가 출시됨에 따라 가장 먼저 해야 할 일은 사용할 API 집합입니다. 이는 신규 고객이든 기존 고객인 경우에도 마찬가지입니다. 이미 API를 사용 중인 고객입니다 사용 이 가이드를 읽고 차이점을 확인할 수 있습니다
Places API의 작동 방식
Places API(신규)
Places API (신규)는 특정 URL이 포함된 표준 URL로 요청을 수락합니다.
서비스 엔드포인트(예: /places 또는 places:searchText)
JSON 응답을 반환합니다 Places API (신규)는
API 키 및 OAuth 토큰입니다.
다음 예에서는 장소 세부정보 요청을 통해
장소 ID를 가져올 수 있습니다.
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Places API
Places API는 특정 URL이 포함된 표준 URL로 요청을 수락합니다.
서비스 엔드포인트(예: /place 또는 /photo) 또한 엔드포인트는
요청에 지정된 형식 유형(JSON 또는 XML)을 수락해야 합니다. 서비스
요청은 해당 특정 엔드포인트와 관련된 매개변수를 사용하여 반환된 데이터를 미세 조정합니다.
다음 예에서는 장소 세부정보 요청을 통해
JSON 형식의 장소 ID:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
이 경우 서비스는 제공된 장소 ID를 사용하여 요청된 장소를 찾고 JSON 형식으로 주소 구성요소를 반환합니다.
리소스
다음 표에는 Places API입니다.
| Places API | Places API(신규) | 참고 |
|---|---|---|
| Find Place | 텍스트 검색 (신규) | Find Place의 새로운 버전은 없습니다. 텍스트 검색 (신규)로 대체되었습니다. |
| 주변 검색 | 주변 검색 (신규) | 텍스트 쿼리가 포함된 기존 API를 사용하는 모든 요청은 텍스트 검색 (신규) 주변 검색 (신규)은 텍스트 입력을 지원하지 않기 때문입니다. |
| 텍스트 검색 | 텍스트 검색 (신규) | |
| 장소 세부정보 | Place Details (신규) | |
| 장소 사진 | 장소 사진 (신규) | |
| Place Autocomplete | 자동 완성 (신규) | |
| 쿼리 자동 완성 | 자동 완성 (신규) | 자동 완성에 추가된 기능 (신규) |
Places API 사용 방법
아래 단계에서는 Places API 서비스를 사용하는 일반적인 사용 사례 시나리오를 설명합니다. 빌드 시 주변 검색 및 장소 사진과 같은 추가 엔드포인트를 사용할 수 있습니다.| 1 | 설정하기 | 먼저 설정 Google Cloud 프로젝트를 클릭하고 이어지는 설정 안내를 완료한 후 API 키 사용 방법을 알아보세요. Places API (신규)의 경우 OAuth 토큰. |
| 2 | 기본 텍스트 검색 사용해 보기 | 텍스트 검색 (신규)을 사용하여 간단한 텍스트 검색을 실행합니다. 텍스트 검색. |
| 3 | 장소 ID를 사용하여 세부정보 확인하기 | 많은 Google Maps Platform API는 응답의 일부로 장소 ID를 반환합니다. 사용 장소 ID를 사용하여 장소에 대한 세부정보를 가져옵니다. 장소 세부정보 (신규) 및 장소 세부정보를 참고하세요. |
| 4 | 장소 사진 받기 | 장소 사진 서비스를 사용하면 Google 지역 정보에 저장된 수백만 개의 사진에 액세스할 수 있습니다. 데이터베이스입니다. 장소 사진 (신규) 사용 또는 장소 세부정보 장소 사진에 액세스 |