개요

플랫폼 선택: Android iOS JavaScript 웹 서비스
Places API는 다양한 메서드를 통해 위치 데이터에 대한 HTTP 요청을 수락하는 서비스입니다. 시설, 지리적 위치 또는 주요 관심 장소에 관한 형식이 지정된 위치 데이터와 이미지를 반환합니다.

Places API를 사용하는 이유

사용자가 자세한 위치 데이터를 쉽게 사용할 수 있도록 위치 인식 기능을 만드세요. Places API를 통해 제공되는 데이터는 실제 세계에서 가장 정확하고 포괄적인 최신 장소 모델 중 하나를 기반으로 합니다. 다음은 애플리케이션 사용 사례의 예입니다.

  • 주요 대도시 지역의 콘도 임대를 표시하고 도시별로 검색결과를 표시합니다.
  • 수령 또는 배송 상태 업데이트에 장소 세부정보를 포함하세요.
  • 특정 지역의 공원 목록을 사용자가 제출한 사진 및 리뷰와 함께 표시합니다.
  • 여행을 계획하는 사람들에게 시설의 연락처 정보, 리뷰, 가격 수준을 제공하세요.

Places API로 할 수 있는 작업

Places API를 사용하여 애플리케이션에 다음 기능을 포함할 수 있습니다.

  • 텍스트 입력, 주변 위치, 모호하거나 범주형 사용자 쿼리 등 다양한 유형의 사용자 쿼리로 장소 검색결과를 제공합니다.
  • 다양한 검색 유형(특정 텍스트 쿼리 또는 카테고리 쿼리)에 자동 완성 기능을 사용 설정하세요.
  • 영업시간, 요약, 사용자 리뷰, 사진 등 장소에 대해 반환된 세부정보 유형을 세분화합니다.
  • 애플리케이션에서 제공하는 위치에 고화질 사진을 추가합니다.

많은 Google Maps Platform API에서 장소 ID를 지원합니다. 장소 ID는 Google Places 데이터베이스 및 Google 지도에서 장소를 고유하게 식별합니다. 장소 ID를 가져오는 방법은 Places API뿐만 아니라 Geocoding API, Routes API, Address Validation API에서도 가능합니다.

장소 ID가 있으면 Places API를 사용하여 전체 주소, 전화번호, 사용자 평점, 리뷰 등 특정 시설이나 관심 장소에 대한 추가 세부정보를 요청할 수 있습니다.

Places API 버전 선택

Places API는 두 가지 API 버전을 지원합니다. Places API는 기존 API이고 Places API(신규)는 API의 차세대 버전입니다.

Places API (신규)가 출시됨에 따라 첫 번째 작업은 사용할 API 집합을 결정하는 것입니다. 신규 고객이거나 API를 이미 사용 중인 기존 고객에게 해당합니다. 이 가이드를 통해 두 API의 주요 차이점을 알아보세요.

Places API 작동 방식

Places API(신규)

Places API (신규)는 /places 또는 places:searchText와 같은 특정 서비스 엔드포인트가 있는 표준 URL로 요청을 수락하고 JSON 응답을 반환합니다. Places API (신규)는 API 키 및 OAuth 토큰을 사용한 승인을 지원합니다. 다음 예에서는 장소 세부정보를 요청하여 API 키를 사용하여 장소 ID의 주소 구성요소를 반환합니다.

https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY

Places API

Places API는 /place 또는 /photo와 같은 특정 서비스 엔드포인트가 있는 표준 URL로 요청을 수락합니다. 또한 엔드포인트는 요청에 지정된 형식 유형(JSON 또는 XML)을 허용합니다. 서비스 요청은 특정 엔드포인트와 관련된 매개변수를 사용하여 반환되는 데이터를 미세 조정합니다. 다음 예에서는 장소 세부정보를 요청하여 장소 ID의 주소 구성요소를 JSON 형식으로 반환합니다.

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 텍스트 검색 (신규) 장소 찾기의 새로운 버전은 없습니다. 텍스트 검색 (신규)이 이 기능을 대체했습니다.
주변 검색 주변 검색 (신규) Nearby Search (신규)가 텍스트 입력을 지원하지 않으므로 텍스트 쿼리가 포함된 기존 API를 사용하는 모든 요청은 텍스트 검색 (신규)을 사용해야 합니다.
텍스트 검색 텍스트 검색 (신규)
장소 세부정보 장소 세부정보 (신규)
장소 사진 장소 사진 (신규)
Place Autocomplete 자동 완성 (신규) 현재 미리보기 버전임
쿼리 자동 완성 자동 완성 (신규) 자동 완성 미리보기 버전에 추가된 기능 (신규)

Places API 사용 방법

아래 단계에서는 Places API 서비스를 사용하기 위한 일반적인 사용 사례 시나리오를 설명합니다. 솔루션을 빌드하면서 주변 검색 및 장소 사진과 같은 추가 엔드포인트를 사용할 수 있습니다.
1 설정 Google Cloud 프로젝트 설정으로 시작하여 다음의 설정 안내를 완료한 다음 API 키를 사용하는 방법을 알아보세요. Places API (신규)의 경우 OAuth 토큰을 사용할 수도 있습니다.
2 기본 텍스트 검색 사용해 보기 텍스트 검색 (신규) 또는 텍스트 검색을 사용하여 간단한 텍스트 검색을 실행합니다.
3 자세한 내용은 장소 ID를 사용하세요 많은 Google Maps Platform API에서 응답의 일부로 장소 ID를 반환합니다. 장소 ID를 사용하여 장소에 대한 세부정보를 가져옵니다. 장소 세부정보 (신규)장소 세부정보를 참고하세요.
4 장소 사진 찍기 장소 사진 서비스를 사용하면 장소 데이터베이스에 저장된 수백만 개의 사진에 액세스할 수 있습니다. 장소 사진에 액세스하려면 장소 사진 (신규) 또는 장소 세부정보를 사용하세요.