반응형
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. 요청 매개변수
- 필수 매개변수
place_id
: 장소를 고유하게 식별하는 ID. Place Search API로 얻을 수 있음.
- 선택 매개변수
fields
: 반환할 데이터 유형을 쉼표로 구분해 지정.- 데이터 유형은 세 가지 카테고리로 나뉨:
- 기본 (Basic): 주소, 이름, 아이콘 등. 추가 요금 없음.
- 연락처 (Contact): 전화번호, 웹사이트 등.
- 분위기 (Atmosphere): 리뷰, 가격 수준, 평점 등.
- 데이터 유형은 세 가지 카테고리로 나뉨:
language
: 결과를 반환할 언어 설정.region
: 국가별 상위 도메인(ccTLD) 코드 설정.reviews_no_translations
: 리뷰 번역 여부 설정.reviews_sort
: 리뷰 정렬 방식 설정 (최신순 또는 관련도 순).sessiontoken
: 자동완성 세션 식별용 토큰. 비용 절감을 위해 고유 토큰 사용 권장.
3. 세부정보 응답 구조
- 응답 데이터는 JSON 또는 XML 형식으로 제공되며, 주요 필드는 다음과 같습니다:
result
: 요청한 장소에 대한 세부정보 포함.html_attributions
: 데이터 제공자 정보.status
: 요청 상태 코드.
주요 데이터 필드
- 기본 정보
formatted_address
: 사람이 읽기 쉬운 주소.geometry
: 장소의 위치 및 뷰포트(지도 상의 경계).place_id
: 장소 식별자.icon
: 장소를 나타내는 아이콘 URL.
- 연락처 정보
formatted_phone_number
: 지역 형식 전화번호.international_phone_number
: 국제 형식 전화번호.website
: 장소 공식 웹사이트.
- 분위기 정보
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
를 지정하지 않으면 기본적으로 모든 필드가 반환되어 불필요한 비용이 발생할 수 있음.
장소 세부정보 | Places API | Google for Developers
이제 Places API (신규)가 출시되면서 차세대 Places API를 사용할 수 있습니다. 이 페이지는 Cloud Translation API를 통해 번역되었습니다. 의견 보내기 장소 세부정보 컬렉션을 사용해 정리하기 내 환경설
developers.google.com
반응형
'🏞️ GIS & RS > 📚 GIS (지리정보시스템)' 카테고리의 다른 글
[GIS] NDS (Navigation Data Standard)란? (0) | 2025.02.05 |
---|---|
[GIS] HD Map(고정밀지도)란? (0) | 2025.02.05 |
[GIS] Google Map 장소 ID란? (Places API) (0) | 2025.01.19 |
[GIS] Google Places API의 응답 데이터 (0) | 2025.01.18 |
[GIS] Google Geocoding API의 응답 데이터 (0) | 2025.01.18 |
댓글