이 섹션에서는 Places Insights API에 대한 일련의 요청 예시를 설명합니다.
computeInsights
를 사용하려면 다음 형식으로 HTTP POST 요청을 제출합니다.
https://areainsights.googleapis.com/v1:computeInsights
원 내의 장소 반환
런던 트라팔가 광장에서 반경 200m 이내의 모든 식당을 반환합니다.
- 검색 지역은 특정 위도와 경도를 중심으로 한 원입니다. 이 원의 반지름은 200미터이며, 이는 검색 영역
- 요청된 장소 유형이 음식점이고, 이는 다음을 사용하여 전달됩니다.
type_filters
내에서included_types
. - 개수는
INSIGHTS_COUNT
를 사용하여 요청되며 장소 ID는INSIGHTS_PLACES
를 사용하여 요청됨
{ "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"], "filter": { "location_filter": { "circle": { "lat_lng": { "latitude": 51.508, "longitude": -0.128}, "radius": 200 } }, "type_filter": { "included_types": "restaurant" } } }
장소 유형 제외
또한 개수에서 장소 유형을 제외할 수도 있습니다.
다음 요청은 첫 번째 예와 동일하지만
excluded_types
를 type_filters
로 변경합니다. 문자열 또는 배열을 사용할 수 있습니다.
included_types
및 excluded_types
의 문자열.
이 예에서는 cafe
및 bakery
의 두 장소 유형을
restaurant
개
{ "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"], "filter": { "location_filter": { "circle": { "lat_lng": { "latitude": 51.508, "longitude": -0.128}, "radius": 200 } }, "type_filter": { "included_types": "restaurant", "excluded_types": [ "cafe", "bakery" ] } } }
기본 유형 사용
이 예에서는 첫 번째 예의 요청을 수정하여 집계에서 primaryType
가 restaurant
인 장소만 포함되도록 합니다.
{ "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"], "filter": { "location_filter": { "circle": { "lat_lng": { "latitude": 51.508, "longitude": -0.128}, "radius": 200 } }, "type_filter": { "included_primary_types": "restaurant" } } }
맞춤 다각형
이 예에서는 맞춤 다각형을 사용하여 검색을 정의하는 방법을 보여줍니다.
영역입니다. INSIGHTS_PLACES
를 지정하면 최대 100개의 장소 ID를 반환할 만큼 작은 지역으로 검색이 제한됩니다. 넓은 영역에 대해서는
INSIGHTS_COUNT
: 서비스가 필요하지 않은 경우 이 제한을 우회합니다.
는 개별 장소 ID를 반환합니다.
이전과 마찬가지로 사용된 장소 유형은 restaurant
입니다. 이 예에서는 다른 세 가지 필터도 소개합니다.
operating_status
: 이 예에서는 운행되는 장소만 계산합니다.price_level
: 이 예시는 저렴하고 적당한 가격만 집계합니다. 있습니다.rating_filter
: 이 예는 다음 범위 내의 리뷰 점수가 있는 장소만 집계합니다. 4.0 및 5.0
{ "insights": [ "INSIGHT_COUNT" ], "filter": { "location_filter": { "custom_area": { "polygon": { "coordinates": [ { "latitude": 37.776, "longitude": -122.666 }, { "latitude": 37.130, "longitude": -121.898 }, { "latitude": 37.326, "longitude": -121.598 }, { "latitude": 37.912, "longitude": -122.247 }, { "latitude": 37.776, "longitude": -122.666 } ] } } }, "type_filter": { "included_types": "restaurant" }, "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ], "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ], "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 } } }
지역
이 예에서는 지리적 지역 장소 ID를 사용하여 검색 지역을 설정합니다.
이러한 장소 ID에는 마을이나 도시와 같은 장소의 도형이 포함됩니다. 이
여기에 사용된 장소 ID는 ChIJiQHsW0m3j4ARm69rRkrUF3w
이며, 이 ID는
도시 마운틴뷰
장소 ID를 Places Insights API에 전달하면 검색 영역이 지리적 지역의 경계로 설정됩니다. 장소 ID는 place
를 사용하여 전달됩니다.
places/<place_ID>
입니다.
다음과 같은 방법으로 지역 장소 ID를 가져올 수 있습니다.
{ "insights": [ "INSIGHT_COUNT" ], "filter": { "location_filter": { "region": { "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w" } }, "type_filter": { "included_types": [ "restaurant" ] } } }