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

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