이 섹션에서는 Places Insights API에 대한 일련의 요청 예시를 설명합니다.

computeInsights를 사용하려면 다음 형식으로 HTTP POST 요청을 제출합니다.

https://areainsights.googleapis.com/v1:computeInsights

원 내의 장소 반환

런던 트라팔가 광장에서 반경 200m 이내의 모든 식당을 반환합니다.

  • 검색 지역은 특정 위도와 경도를 중심으로 한 원입니다. 이 원의 반지름은 200미터이며, 이는 검색 영역
  • 요청된 장소 유형이 음식점이고, 이는 다음을 사용하여 전달됩니다. type_filters 내에서 included_types.
  • 개수는 INSIGHTS_COUNT를 사용하여 요청되며 장소 IDINSIGHTS_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_typestype_filters로 변경합니다. 문자열 또는 배열을 사용할 수 있습니다. included_typesexcluded_types의 문자열.

이 예에서는 cafebakery의 두 장소 유형을 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"
            ]
        }
    }
}

기본 유형 사용

이 예에서는 첫 번째 예의 요청을 수정하여 집계에서 primaryTyperestaurant인 장소만 포함되도록 합니다.

{
  "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"
            ]
        }
    }
}