🏞️ GIS & RS/📚 GIS (지리정보시스템)

[GIS] Google Map 장소 세부정보란? (Places API)

김 홍시 2025. 1. 19.
반응형

Places API: 장소 세부정보 가이드 요약

이 문서는 Google Maps Platform의 Places API를 활용하여 특정 장소의 세부정보를 요청하고 이를 처리하는 방법을 설명합니다. 주요 내용을 정리하면 다음과 같습니다.


1. 장소 세부정보 요청 개요

  • 장소 세부정보 요청은 place_id를 기반으로 특정 장소에 대한 포괄적인 정보를 반환합니다.
    • 예시 정보:
      • 전체 주소, 전화번호
      • 사용자 평가 및 리뷰
      • 운영 상태 등.
  • 요청 형식:
    https://maps.googleapis.com/maps/api/place/details/output?parameters
    • output: 응답 형식 선택 (JSON 권장, XML 가능).
    • parameters: 요청에 필요한 매개변수와 필드 지정.

2. 요청 매개변수

  1. 필수 매개변수
    • place_id: 장소를 고유하게 식별하는 ID. Place Search API로 얻을 수 있음.
  2. 선택 매개변수
    • fields: 반환할 데이터 유형을 쉼표로 구분해 지정.
      • 데이터 유형은 세 가지 카테고리로 나뉨:
        1. 기본 (Basic): 주소, 이름, 아이콘 등. 추가 요금 없음.
        2. 연락처 (Contact): 전화번호, 웹사이트 등.
        3. 분위기 (Atmosphere): 리뷰, 가격 수준, 평점 등.
    • language: 결과를 반환할 언어 설정.
    • region: 국가별 상위 도메인(ccTLD) 코드 설정.
    • reviews_no_translations: 리뷰 번역 여부 설정.
    • reviews_sort: 리뷰 정렬 방식 설정 (최신순 또는 관련도 순).
    • sessiontoken: 자동완성 세션 식별용 토큰. 비용 절감을 위해 고유 토큰 사용 권장.

3. 세부정보 응답 구조

  • 응답 데이터는 JSON 또는 XML 형식으로 제공되며, 주요 필드는 다음과 같습니다:
    • result: 요청한 장소에 대한 세부정보 포함.
    • html_attributions: 데이터 제공자 정보.
    • status: 요청 상태 코드.

주요 데이터 필드

  1. 기본 정보
    • formatted_address: 사람이 읽기 쉬운 주소.
    • geometry: 장소의 위치 및 뷰포트(지도 상의 경계).
    • place_id: 장소 식별자.
    • icon: 장소를 나타내는 아이콘 URL.
  2. 연락처 정보
    • formatted_phone_number: 지역 형식 전화번호.
    • international_phone_number: 국제 형식 전화번호.
    • website: 장소 공식 웹사이트.
  3. 분위기 정보
    • rating: 사용자 평점(1~5점).
    • reviews: 최대 5개의 사용자 리뷰.
    • price_level: 가격 수준(0~4).
    • opening_hours: 영업 시간 정보.

4. 장소 사진

  • Place Photo API를 통해 장소의 이미지를 요청 가능.
  • 주요 필드:
    • photo_reference: 사진 요청에 사용되는 식별자.
    • width, height: 이미지 크기.

5. 오류 상태 코드

  • OK: 요청 성공.
  • ZERO_RESULTS: 유효한 장소 ID지만 결과가 없는 경우.
  • NOT_FOUND: 데이터베이스에 장소 ID가 없는 경우.
  • INVALID_REQUEST: 요청이 잘못된 경우.
  • OVER_QUERY_LIMIT: 요청 제한 초과.
  • REQUEST_DENIED: 요청이 거부된 경우(잘못된 API 키 등).
  • UNKNOWN_ERROR: 알 수 없는 오류 발생.

6. 비용 및 과금

  • fields 매개변수에 따라 과금:
    • 기본 필드는 기본 요금.
    • 연락처 및 분위기 필드는 추가 요금 적용.
  • 필드 미지정 시, 모든 필드가 반환되며 추가 요금이 발생.

7. 사용 예시

요청 URL

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

응답 (JSON 예시)

{
  "result": {
    "name": "Google Workplace 6",
    "rating": 4.0,
    "formatted_phone_number": "(02) 9374 4000"
  },
  "status": "OK"
}

8. 주의 사항

  • 응답에 포함된 데이터는 그대로 표시해야 하며, 수정 또는 변경 불가.
  • 장소 정보는 국가별 라이선스 제한으로 인해 일부 정보가 제공되지 않을 수 있음.
  • 요청에서 fields를 지정하지 않으면 기본적으로 모든 필드가 반환되어 불필요한 비용이 발생할 수 있음.

 

https://developers.google.com/maps/documentation/places/web-service/details?hl=ko&_gl=1*1vpspjt*_up*MQ..*_ga*MTAwMDE2NzUyOC4xNzM3Mjg2NDI0*_ga_NRWSTWS78N*MTczNzI4NjQyNC4xLjEuMTczNzI4Njc2Ni4wLjAuMA..

 

장소 세부정보  |  Places API  |  Google for Developers

이제 Places API (신규)가 출시되면서 차세대 Places API를 사용할 수 있습니다. 이 페이지는 Cloud Translation API를 통해 번역되었습니다. 의견 보내기 장소 세부정보 컬렉션을 사용해 정리하기 내 환경설

developers.google.com

 

반응형

댓글