요청 매개변수

이 문서에서는 Places Insights API를 제공합니다. 각 옵션을 자세히 다루면서 유용한 정보와 를 참조하시기 바랍니다.

Places Insights API를 사용하면 다음과 같은 여러 주요 기능을 수행할 수 있습니다.

  • 장소 수 계산: 특정 조건과 일치하는 장소의 수를 확인합니다. 검색 조건을 설정할 수 있습니다.
  • 장소 세부정보 검색: 다음을 충족하는 장소의 이름을 가져옵니다. 지정한 필터를 사용하면 Places API입니다.
  • 유연한 필터링: 포괄적인 필터를 적용하여 정확한 통계를 얻을 수 있습니다. 사용 가능한 필터는 다음과 같습니다. <ph type="x-smartling-placeholder">
      </ph>
    • 지리적 영역 (원, 지역 또는 맞춤 다각형)
    • 장소 유형
    • 영업 상태
    • 가격 수준
    • 등급 범위

필수 매개변수

이 섹션에서는 Places Insights API를 제공합니다. 각 요청은 다음을 제공해야 합니다.

  • 통계의 한 유형입니다.
  • 위치 필터 및 유형 필터

통계

계산할 통계 유형을 지정합니다. 다음 통계 유형 지원됨:

  • INSIGHT_COUNT: 필터 기준과 일치하는 장소의 수를 반환합니다.
  • INSIGHT_PLACES: 필터 기준과 일치하는 장소 ID를 반환합니다.

참고: 이 옵션을 선택하면 Places Insights API에서 장소 ID를 반환합니다. count가 100 이하인 경우에만

필터

장소를 필터링하는 기준을 지정합니다. 최소한 LocationFilter 및 TypeFilter.

위치 필터

위치 필터에는 다음 유형 중 하나가 있을 수 있습니다.

  • circle: 중심과 반지름이 있는 원으로 영역을 정의합니다.
  • region: 영역을 지역으로 정의합니다.
  • custom_area: 영역을 맞춤 다각형으로 정의합니다.
원

지역을 원형으로 선택한 경우 center을 제공해야 합니다. 및 radius입니다. 중심은 위도 및 경도이거나 장소가 될 수 있습니다. 원 중심의 ID입니다.

  • 센터: <ph type="x-smartling-placeholder">
      </ph>
    • lat_lng: 원 중심의 위도와 경도입니다. 위도 -90 이상, 90 이하의 숫자여야 합니다. 경도는 숫자여야 합니다. -180 이상, 180 이하입니다.
    • place: 원 중심의 장소 ID입니다. 한 가지 포인트만 지원되지 않습니다. 이 문자열은 places/ 프리픽스로 시작해야 합니다.
  • radius: 원의 반지름(미터)입니다. 이 숫자는 양수여야 합니다.
지역

place 매개변수를 사용하여 지역을 지역으로 정의할 수 있습니다. 장소 ID 사용 지리적 영역 (예: 다각형). 예를 들어, 플로리다주 탬파의 장소 ID는 places/ChIJ4dG5s4K3wogRY7SWr4kTX6c

<ph type="x-smartling-placeholder">
지원되지 않는 지역 유형
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise

Geocoding API 호출의 types 필드를 사용하여 장소 ID와 연결된 위치 또는 주소의 유형(예: 선택할 수 있습니다.

맞춤 지역

좌표를 사용하여 맞춤 다각형의 영역을 정의합니다.

https://geojson.io/에서 맞춤 다각형을 그리고 해당 좌표를 요청에 입력합니다. 다각형에는 최소 4개가 있어야 합니다. 첫 번째와 마지막 좌표가 동일합니다. 첫 번째와 마지막 좌표의 경우 다른 중복된 좌표가 없어야 합니다. 예를 들면 다음과 같습니다.

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

유형 필터

포함하거나 제외할 장소의 유형을 지정합니다. 이 두 가지 기본 및 Places Insights API가 지원하는 두 번째 장소 유형에 대한 자세한 내용은 표 Places API 장소 유형 가이드 아래 (신규). included_types 또는 included_primary_types 유형 중 하나 이상이 포함됩니다.

  • included_types: 포함된 장소 유형 목록입니다.
  • excluded_types: 제외된 장소 유형 목록입니다.
  • included_primary_types: 포함된 기본 장소 유형의 목록입니다.
  • excluded_primary_types: 제외된 기본 장소 유형 목록입니다.

유형 필터와 장소 유형의 작동 방식에 대해 자세히 알아보려면 유형 자세히 알아보기 필터를 제공합니다.

선택적 매개변수

나머지 3개의 필터는 선택사항입니다.

  • operating_status: 포함하거나 제외할 장소의 상태를 지정합니다. 기본값은 operating_status: OPERATING_STATUS_OPERATIONAL 기준 필터링입니다. (하나의 특정 값)
  • price_levels: 장소의 가격 수준을 지정합니다. 기본값은 '아니요'입니다. 필터링 (모든 가격 수준이 결과에 포함됨)을 선택합니다.
  • rating_filter: 장소의 평점 범위를 지정합니다. 기본값은 '아니요'입니다. 필터링 (모든 평점이 결과에 포함됨)을 선택합니다.

영업 상태

작동 상태 (예: 운영 상태 또는 일시적으로)를 기준으로 필터링합니다. 닫힘).

가격 수준

가격 수준 (예: 무료, 보통, 비쌈)을 기준으로 필터링합니다.

평점 필터

평균 사용자 평점을 기준으로 장소를 필터링합니다. 이 두 필드 모두 선택사항이므로 생략할 경우 기본적으로 광고를 게재할 수 있습니다.

  • min_rating: 최소 평균 사용자 평점 (1.0~5.0)
  • max_rating: 최대 평균 사용자 평점 (1.0~5.0)입니다.