필터 매개변수

아래 표에 설명된 매개변수를 사용하여 장소 수 함수에 필터를 적용할 수 있습니다. 필수 매개변수는 함수마다 다릅니다.

필터 이름과 값이 아래 요구사항에 따라 지정되지 않으면 함수는 잘못된 인수 오류를 반환합니다.

필터 이름 설명 유형 지원되는 값
geography

PLACES_COUNT, PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_H3의 경우

검색할 영역을 지정합니다. Point, LineString, Polygon와 같은 모든 유형의 GEOGRAPHY이 지원됩니다.

geography 매개변수를 geography_radius와 함께 사용하여 검색 영역에 버퍼를 추가할 수 있습니다.

최소 검색 영역은 40.0m x 40.0m (1600m2)입니다. 이 제한 미만의 검색 영역을 지정하면 함수에서 잘못된 인수 오류를 반환합니다.

 GEOGRAPHY 모든 유형의 GEOGRAPHY
geographies

PLACES_COUNT_PER_GEO에만 해당

검색할 영역 목록을 지정합니다. Point, LineString, Polygon와 같은 모든 유형의 GEOGRAPHY이 지원됩니다.

geographies 매개변수를 geography_radius와 함께 사용하여 검색 영역에 버퍼를 추가할 수 있습니다. 버퍼는 지정된 모든 지리적 위치에 추가됩니다.

최소 검색 영역은 40.0m x 40.0m (1600m2)입니다. 이 제한 미만의 검색 영역을 지정하면 함수에서 잘못된 인수 오류를 반환합니다.

 ARRAY<GEOGRAPHY> 모든 유형의 GEOGRAPHY
geography_radius

지정된 지역에 반경 또는 버퍼를 미터 단위로 추가합니다. 기본값은 0입니다.

지정된 값은 최소 40.0m x 40.0m (1600m2)의 검색 영역을 정의해야 합니다. 예를 들어 Point 지역의 경우 최소 반경은 23미터입니다.

 INT64 최솟값은 0입니다.
h3_resolution

PLACES_COUNT_PER_H3에만 해당

장소 수를 H3 셀로 집계하는 데 사용되는 H3 해상도입니다.

 INT64 0~8 사이
types

고려할 장소 유형을 지정합니다.

각 장소에는 "restaurant", "cafe"과 같은 장소 유형 집합이 포함됩니다. 유형을 지정하지 않으면 결과에 모든 장소 유형이 고려됩니다.

 ARRAY<STRING>

가능한 값의 전체 목록은 장소 유형의 표 A와 표 B를 참고하세요.

예:

["restaurant", "cafe", "bar"]
primary_types

고려할 기본 유형을 지정합니다.

장소에는 위치를 가장 잘 설명하는 유형인 기본 유형이 하나만 있을 수 있습니다.

기본 유형을 지정하지 않으면 모든 장소 기본 유형이 결과에 포함됩니다.

 ARRAY<STRING>

가능한 값의 전체 목록은 장소 유형의 표 A와 표 B를 참고하세요.

예:

["restaurant", "cafe", "bar"]
min_rating 고려할 최소 장소 평가를 지정합니다.

장소 평점은 장소에 대한 사용자 리뷰를 기반으로 하며 범위는 1.0~5.0입니다.

이 범위를 벗어나는 등급을 지정하면 함수에서 잘못된 인수 오류를 반환합니다.

 FLOAT 1.0~5.0
max_rating

고려할 최대 장소 평가를 지정합니다.

장소 평점은 장소에 대한 사용자 리뷰를 기반으로 하며 범위는 1.0~5.0입니다.

이 범위를 벗어나는 등급을 지정하면 함수에서 잘못된 인수 오류를 반환합니다.

 FLOAT 1.0~5.0
min_user_rating_count

고려할 최소 사용자 평가 수를 지정합니다.

사용자 평점 수는 장소에 있는 총 리뷰 수입니다.

최솟값은 0입니다. 0 미만의 값을 지정하면 함수는 잘못된 인수 오류를 반환합니다.

 INT64 최솟값은 0입니다.
max_user_rating_count

고려할 최대 사용자 평가 수를 지정합니다.

사용자 평점 수는 장소에 있는 총 리뷰 수입니다.

최솟값은 0입니다. 0 미만의 값을 지정하면 함수는 잘못된 인수 오류를 반환합니다.

 INT64 최솟값은 0입니다.
price_level

고려할 가격대를 지정합니다.

여러 가격대를 지정할 수 있습니다.

 ARRAY<STRING>

지원되는 값:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

예:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status 고려할 비즈니스 상태를 지정합니다. 비즈니스 상태를 여러 개 지정할 수 있습니다. ARRAY<STRING>

지원되는 값:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

예:

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout 테이크아웃을 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
delivery 배달을 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
dine_in 실내 식사가 가능한 장소를 고려합니다. BOOLEAN TRUE, FALSE
curbside_pickup 매장 밖 수령을 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
reservable 예약 가능한 장소를 고려하세요. BOOLEAN TRUE, FALSE
outdoor_seating 야외 좌석이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
live_music 라이브 음악을 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
allows_dogs 반려견 동반이 가능한 장소를 고려하세요. BOOLEAN TRUE, FALSE
restroom 화장실이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_breakfast 아침 식사를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_lunch 점심을 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_dinner 저녁 식사를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_beer 맥주를 판매하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_wine 와인을 판매하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_brunch 브런치를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_vegetarian_food 채식 요리를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_cocktails 칵테일을 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_dessert 디저트를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
serves_coffee 커피를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
menu_for_children 어린이 메뉴를 제공하는 장소를 고려합니다. BOOLEAN TRUE, FALSE
good_for_children 아이들에게 좋은 장소를 고려하세요. BOOLEAN TRUE, FALSE
good_for_groups 단체에 적합한 장소를 고려하세요. BOOLEAN TRUE, FALSE
good_for_watching_sports 스포츠 경기를 관람하기에 좋은 장소를 고려하세요. BOOLEAN TRUE, FALSE
accepts_credit_cards 신용카드를 사용할 수 있는 장소를 고려하세요. BOOLEAN TRUE, FALSE
accepts_debit_cards 체크카드를 사용할 수 있는 장소를 고려하세요. BOOLEAN TRUE, FALSE
accepts_cash_only 현금만 받는 장소를 고려하세요. BOOLEAN TRUE, FALSE
accepts_nfc NFC 결제를 지원하는 장소를 고려하세요. BOOLEAN TRUE, FALSE
free_parking_lot 무료 주차장이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
paid_parking_lot 유료 주차장이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
free_street_parking 무료 노상 주차가 가능한 장소를 고려합니다. BOOLEAN TRUE, FALSE
paid_street_parking 유료 노상 주차가 가능한 장소를 고려합니다. BOOLEAN TRUE, FALSE
valet_parking 발레파킹이 가능한 장소를 고려합니다. BOOLEAN TRUE, FALSE
free_garage_parking 무료 실내 주차가 가능한 장소를 고려합니다. BOOLEAN TRUE, FALSE
paid_garage_parking 유료 실내 주차가 가능한 장소를 고려합니다. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking 휠체어 이용 가능 주차장이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance 휠체어 진입로가 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom 휠체어 이용 가능 화장실이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating 휠체어 이용 가능 좌석이 있는 장소를 고려합니다. BOOLEAN TRUE, FALSE