Package google.maps.areainsights.v1

색인

AreaInsights

장소 집계 RPC의 서비스 정의입니다.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

이 메서드를 사용하면 지역, 장소 유형, 운영 상태, 가격 수준, 평점과 같은 다양한 필터를 사용하여 지역 관련 통계를 가져올 수 있습니다. 현재 '수' 및 '장소' 통계가 지원됩니다. '수치' 통계를 사용하면 '캘리포니아에 운영 중이며 저렴하고 평균 평점이 4개 이상인 음식점은 몇 개나 있나요?'와 같은 질문에 답변할 수 있습니다(자세한 내용은 insight enum 참고). '장소' 통계를 사용하면 요청된 필터와 일치하는 장소를 확인할 수 있습니다. 그러면 클라이언트는 이러한 장소 리소스 이름을 사용하여 Places API를 통해 각 장소에 관한 자세한 정보를 가져올 수 있습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

ComputeInsightsRequest

ComputeInsights RPC 요청

필드
insights[]

Insight

필수 항목입니다. 계산할 통계입니다. 현재는 INSIGHT_COUNT 및 INSIGHT_PLACES만 지원됩니다.
filter

Filter

필수 항목입니다. 통계 필터

ComputeInsightsResponse

ComputeInsights RPC의 응답입니다.

필드
place_insights[]

PlaceInsight

Insights.INSIGHT_PLACES의 결과입니다.
count

int64

Insights.INSIGHT_COUNT의 결과입니다.

필터

ComputeInsights RPC의 필터입니다.

필드
location_filter

LocationFilter

필수 항목입니다. 위치 필터로 지정된 지역에 있는 장소로 결과를 제한합니다.
type_filter

TypeFilter

필수 항목입니다. 장소 유형 필터
operating_status[]

OperatingStatus

선택사항입니다. 운영 상태가 이 목록에 포함된 장소로 결과를 제한합니다. operating_status가 설정되지 않으면 OPERATING_STATUS_OPERATIONAL이 기본값으로 사용됩니다.
price_levels[]

PriceLevel

선택사항입니다. 가격대가 이 목록에 포함된 장소로 결과를 제한합니다. price_levels가 설정되지 않으면 모든 가격 수준이 결과에 포함됩니다.
rating_filter

RatingFilter

선택사항입니다. 평균 사용자 평점이 rating_filter로 지정된 범위에 있는 장소로 결과를 제한합니다. rating_filter가 설정되지 않으면 모든 평점이 결과에 포함됩니다.

통계

지원되는 통계

열거형
INSIGHT_UNSPECIFIED 지정되지 않음
INSIGHT_COUNT

통계 수

이 통계를 지정하면 ComputeInsights는 지정된 필터 기준과 일치하는 장소 수를 반환합니다.

요청 예시:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

응답 예:

{
  "count": 1234
}
INSIGHT_PLACES

반품 장소

이 통계를 지정하면 ComputeInsights는 지정된 필터 기준과 일치하는 장소 ID를 반환합니다.

요청 예시:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

응답 예:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

LocationFilter

위치 필터

통계의 관심 영역을 지정합니다.

필드
통합 필드 area. 다음 중 하나를 지정해야 합니다. area은 다음 중 하나여야 합니다.
circle

Circle

면적을 원으로 표시합니다.
region

Region

지역으로 구역
custom_area

CustomArea

다각형으로 지정된 맞춤 영역

원

원 중심점과 반지름(미터)으로 원이 정의됩니다.

필드
radius

int32

선택사항입니다. 원의 반지름(미터)
통합 필드 center. 원의 중심입니다. center은 다음 중 하나여야 합니다.
lat_lng

LatLng

원 중심의 위도 및 경도입니다.
place

string

형식: places/PLACE_ID 형식이어야 하며 여기서 PLACE_ID은 장소의 고유 식별자입니다. 예를 들면 places/ChIJgUbEo8cfqokR5lP9_Wh_DaM입니다.

CustomArea

맞춤 영역

필드
polygon

Polygon

필수 항목입니다. 다각형으로 표시된 맞춤 영역

다각형

다각형은 시계 반대 방향으로 순서가 지정된 일련의 연결된 좌표로 표현됩니다. 좌표는 닫힌 루프를 형성하고 채워진 영역을 정의합니다. 첫 번째와 마지막 좌표는 동일하며 동일한 값을 포함해야 합니다. 이 형식은 GeoJSON 다각형의 단순화된 버전입니다 (반시계 방향 외부 링 하나만 지원됨).

필드
coordinates[]

LatLng

선택사항입니다. 다각형을 정의하는 좌표입니다.

지역

지역은 도시, 우편번호, 군, 주 등과 같은 지리적 경계입니다.

필드
통합 필드 region. 지리적 지역을 정의합니다. 한 번에 하나의 지역 유형 (예: 장소)만 지정할 수 있습니다. region은 다음 중 하나여야 합니다.
place

string

특정 지역의 고유 식별자입니다.

OperatingStatus

장소의 운영 상태입니다.

열거형
OPERATING_STATUS_UNSPECIFIED 지정되지 않음 이 값은 사용하면 안 됩니다.
OPERATING_STATUS_OPERATIONAL 장소가 운영 중이며 지정된 시간에 영업합니다.
OPERATING_STATUS_PERMANENTLY_CLOSED 더 이상 영업하지 않는 장소입니다.
OPERATING_STATUS_TEMPORARILY_CLOSED 장소가 일시적으로 폐쇄되었으며 향후 다시 열릴 예정입니다.

PlaceInsight

장소에 관한 정보를 보유합니다.

필드
place

string

장소의 고유 식별자입니다. 이 리소스 이름은 Places API를 사용하여 장소에 관한 세부정보를 가져오는 데 사용할 수 있습니다.

PriceLevel

장소의 가격 수준입니다.

열거형
PRICE_LEVEL_UNSPECIFIED 지정되지 않음 이 값은 사용하면 안 됩니다.
PRICE_LEVEL_FREE 장소에서 무료 서비스를 제공합니다.
PRICE_LEVEL_INEXPENSIVE 저렴한 서비스를 제공하는 장소입니다.
PRICE_LEVEL_MODERATE 장소에서 적당한 가격의 서비스를 제공합니다.
PRICE_LEVEL_EXPENSIVE 비용이 비싼 서비스를 제공하는 장소입니다.
PRICE_LEVEL_VERY_EXPENSIVE 장소에서 매우 비싼 서비스를 제공합니다.

RatingFilter

평균 사용자 평점 필터

필드
min_rating

float

선택사항입니다. 평균 사용자 평점이 min_rating 이상인 장소로 결과를 제한합니다. 값은 1.0과 5.0 사이여야 합니다.
max_rating

float

선택사항입니다. 평균 사용자 평점이 max_rating보다 작거나 같은 장소로 결과를 제한합니다. 값은 1.0과 5.0 사이여야 합니다.

TypeFilter

장소 유형 필터

표 a의 장소 유형만 지원됩니다.

장소에는 하나의 기본 유형만 연결할 수 있습니다. 예를 들어 기본 유형은 'mexican_restaurant' 또는 'steak_house'일 수 있습니다. included_primary_types 및 excluded_primary_types를 사용하여 장소의 기본 유형에 따라 결과를 필터링합니다.

장소에 여러 유형 값이 연결될 수도 있습니다. 예를 들어 레스토랑의 유형은 'seafood_restaurant', 'restaurant', 'food', 'point_of_interest', 'establishment'일 수 있습니다. included_types 및 excluded_types를 사용하여 장소와 연결된 유형 목록에서 결과를 필터링합니다.

검색에 여러 유형 제한이 지정된 경우 모든 제한을 충족하는 장소만 반환됩니다. 예를 들어 {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}를 지정하면 'restaurant' 관련 서비스를 제공하지만 주로 'steak_house'로 운영되지 않는 장소가 반환됩니다.

충돌하는 유형이 있는 경우(즉, 유형이 included_types 및 excluded_types 유형 또는 included_primary_types 및 excluded_primary_types에 모두 표시되는 경우) INVALID_ARGUMENT 오류가 반환됩니다.

included_types 또는 included_primary_types 중 하나를 설정해야 합니다.

필드
included_types[]

string

선택사항입니다. 포함된 장소 유형
excluded_types[]

string

선택사항입니다. 제외된 장소 유형
included_primary_types[]

string

선택사항입니다. 기본 장소 유형을 포함했습니다.
excluded_primary_types[]

string

선택사항입니다. 기본 장소 유형을 제외했습니다.