개요

Places API는 다양한 메서드를 통해 위치 데이터에 대한 HTTP 요청을 수락하는 서비스입니다. 시설, 지리적 위치, 주요 관심 장소에 관한 형식의 위치 데이터와 이미지를 반환합니다.

Places API를 사용하는 이유

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

  • 주요 대도시 지역의 콘도 임대를 보여 주며 구체적으로 도시를 타겟팅합니다.
  • 수령 또는 배송 상태 업데이트에 장소 세부정보를 포함합니다.
  • 지역의 공원 목록이 사용자가 제출한 사진 및 리뷰와 함께 표시됩니다.
  • 여행을 계획 중인 사람들에게 연락처 정보, 리뷰, 가격대 정보를 제공하세요.

Places API로 무엇을 할 수 있나요?

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

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

Places API의 작동 방식

Places API는 /place 또는 /photo와 같은 특정 서비스 엔드포인트가 포함된 표준 URL로 요청을 허용합니다. 엔드포인트는 요청에 지정된 형식 유형(JSON 또는 XML)도 허용합니다. 마지막으로 서비스 요청은 해당 엔드포인트와 관련된 매개변수를 사용하여 반환되는 데이터를 미세 조정합니다. 예를 들어 주소 구성요소의 다음 장소 세부정보 요청은 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를 통해 사용할 수 있는 리소스와 리소스가 반환되는 데이터가 요약되어 있습니다.

데이터 리소스 반환된 데이터 반환 형식
장소 검색 기기 위치 또는 검색 문자열을 기준으로 장소 목록을 반환합니다.

자세한 내용은 장소 검색 응답, 주변 검색 응답텍스트 검색 응답을 참고하세요.

  • JSON
  • XML
장소 세부정보 사용자 리뷰를 비롯하여 특정 장소에 대한 자세한 정보를 반환합니다.

자세한 내용은 장소 세부정보 응답을 참고하세요.

  • JSON
  • XML
장소 사진 Google의 장소 데이터베이스에 저장된 수백만 개의 장소 관련 사진에 대한 액세스를 제공합니다.

자세한 내용은 장소 사진 응답을 참고하세요.

  • JSON
  • XML
장소 자동 완성 사용자가 입력하면 장소의 이름 또는 주소를 자동으로 채웁니다.

자세한 내용은 장소 자동 완성 응답을 참고하세요.

  • JSON
  • XML
쿼리 자동 완성 텍스트 기반 지역 검색을 위한 쿼리 예측 서비스를 제공하여 사용자 입력 시 추천 쿼리를 반환합니다.

자세한 내용은 쿼리 자동 완성 응답을 참조하세요.

  • JSON
  • XML

Places API 사용 방법

아래 단계에서는 Places API 서비스에서 세 가지 엔드포인트를 사용하는 일반적인 사용 사례 시나리오를 다룹니다. 솔루션을 빌드할 때 주변 검색, 장소 사진, 쿼리 자동 완성과 같은 추가 엔드포인트를 사용할 수 있습니다.
1 설정 Google Cloud 프로젝트 설정에서 시작하여 설정 안내를 완료한 다음, API 키를 사용하는 방법을 알아보세요.
2 기본 텍스트 검색 사용해 보기 API 키가 있으면 텍스트 검색 가이드의 기본 텍스트 검색 예시에 설명된 대로 간단한 텍스트 검색을 실행합니다.
3 Find Place 요청 사용하기 장소 찾기 요청은 장소 ID, 요청한 데이터 필드(예: 영업시간, 주소, 사진)를 반환합니다. 장소 예 찾기를 참고하여 사용 사례와 관련된 한 가지 예를 더 찾아보세요.
4 Find Place 응답 기본사항 이해하기 Find Place 응답에서 반환된 데이터를 탐색합니다. 자세한 내용은 장소 응답 찾기를 참고하세요.
5 장소 ID를 사용하여 자세히 알아보기 장소 찾기 응답은 특정 장소에 사용 가능한 모든 데이터를 제공하지는 않습니다. 장소 찾기 응답에서 반환된 장소 ID를 사용하여 장소에 대한 세부정보를 확인할 수 있습니다. 장소 세부정보를 참고하세요.

사용 가능한 클라이언트 라이브러리

다음 클라이언트 라이브러리 중 하나를 통해 원하는 언어로 이 API를 호출합니다.

Google 지도 서비스용 자바 클라이언트, Python 클라이언트, Go 클라이언트, Node.js 클라이언트는 Apache 2.0 라이선스에 따라 오픈소스로 제공되는 커뮤니티 지원 클라이언트 라이브러리입니다. GitHub에서 다운로드할 수 있으며 설치 안내 및 샘플 코드도 제공됩니다.

다음 단계