Tham số bộ lọc

Bạn có thể áp dụng bộ lọc cho các hàm đếm địa điểm bằng cách sử dụng các tham số được mô tả trong bảng bên dưới. Xin lưu ý rằng các tham số bắt buộc khác nhau đối với từng hàm:

Hàm này trả về lỗi đối số không hợp lệ nếu bạn không chỉ định tên và giá trị bộ lọc theo các yêu cầu dưới đây.

Tên bộ lọc Mô tả Loại Giá trị được hỗ trợ
geography

Đối với PLACES_COUNT, PLACES_COUNT_PER_TYPE và PLACES_COUNT_PER_H3

Chỉ định một khu vực để tìm kiếm. Mọi loại GEOGRAPHY đều được hỗ trợ, chẳng hạn như Point, LineString và Polygon.

Bạn có thể kết hợp tham số geography với geography_radius để thêm vùng đệm vào khu vực tìm kiếm.

Khu vực tìm kiếm tối thiểu là 40 m x 40 m (1.600 m2). Nếu bạn chỉ định một vùng tìm kiếm dưới giới hạn này, hàm sẽ trả về lỗi đối số không hợp lệ.

 GEOGRAPHY Mọi loại GEOGRAPHY.
geographies

Chỉ dành cho PLACES_COUNT_PER_GEO

Chỉ định một danh sách các khu vực để tìm kiếm. Mọi loại GEOGRAPHY đều được hỗ trợ, chẳng hạn như Point, LineString và Polygon.

Bạn có thể kết hợp tham số geographies với geography_radius để thêm vùng đệm vào khu vực tìm kiếm. Vùng đệm được thêm vào tất cả các khu vực địa lý được chỉ định.

Khu vực tìm kiếm tối thiểu là 40 m x 40 m (1.600 m2). Nếu bạn chỉ định một vùng tìm kiếm dưới giới hạn này, hàm sẽ trả về lỗi đối số không hợp lệ.

 ARRAY<GEOGRAPHY> Mọi loại GEOGRAPHY.
geography_radius

Thêm bán kính hoặc vùng đệm (tính bằng mét) vào khu vực địa lý đã chỉ định. Giá trị mặc định là "0".

Giá trị được chỉ định phải xác định diện tích tìm kiếm tối thiểu là 40 mét x 40 mét (1600 m2). Ví dụ: đối với một Point địa lý, bán kính tối thiểu là 23 mét.

 INT64 Giá trị tối thiểu là 0.
h3_resolution

Chỉ dành cho PLACES_COUNT_PER_H3

Độ phân giải H3 được dùng để tổng hợp số lượng địa điểm thành các ô H3.

 INT64 Từ 0 đến 8.
types

Chỉ định các loại địa điểm cần xem xét.

Mỗi địa điểm chứa một tập hợp các loại địa điểm, ví dụ: "restaurant" và "cafe". Nếu bạn không chỉ định loại nào, thì tất cả các loại địa điểm đều được xem xét trong kết quả.

 ARRAY<STRING>

Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Các loại địa điểm.

Ví dụ:

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

Chỉ định các loại chính cần xem xét.

Một địa điểm chỉ có thể có một loại chính, đó là loại mô tả địa điểm một cách chính xác nhất.

Nếu bạn không chỉ định loại chính nào, thì tất cả các loại chính của địa điểm sẽ được xem xét trong kết quả.

 ARRAY<STRING>

Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Các loại địa điểm.

Ví dụ:

["restaurant", "cafe", "bar"]
min_rating Chỉ định điểm xếp hạng tối thiểu của địa điểm cần xem xét.

Điểm xếp hạng của địa điểm dựa trên bài đánh giá của người dùng về địa điểm đó và có phạm vi từ 1 đến 5

Nếu bạn chỉ định một điểm xếp hạng nằm ngoài phạm vi này, hàm sẽ trả về lỗi đối số không hợp lệ.

 FLOAT Từ 1,0 đến 5,0.
max_rating

Chỉ định điểm xếp hạng tối đa của địa điểm cần xem xét.

Điểm xếp hạng của địa điểm dựa trên bài đánh giá của người dùng về địa điểm đó và có phạm vi từ 1 đến 5

Nếu bạn chỉ định một điểm xếp hạng nằm ngoài phạm vi này, hàm sẽ trả về lỗi đối số không hợp lệ.

 FLOAT Từ 1,0 đến 5,0.
min_user_rating_count

Chỉ định số lượng tối thiểu về lượt xếp hạng của người dùng cần xem xét.

Số lượt xếp hạng của người dùng là tổng số bài đánh giá mà một địa điểm có.

Giá trị tối thiểu là 0. Nếu bạn chỉ định một giá trị dưới 0, hàm sẽ trả về lỗi đối số không hợp lệ.

 INT64 Giá trị tối thiểu là 0.
max_user_rating_count

Chỉ định số lượng tối đa các lượt xếp hạng của người dùng cần xem xét.

Số lượt xếp hạng của người dùng là tổng số bài đánh giá mà một địa điểm có.

Giá trị tối thiểu là 0. Nếu bạn chỉ định một giá trị dưới 0, hàm sẽ trả về lỗi đối số không hợp lệ.

 INT64 Giá trị tối thiểu là 0.
price_level

Xác định các mức giá cần cân nhắc.

Bạn có thể chỉ định nhiều mức giá.

 ARRAY<STRING>

Các giá trị được hỗ trợ:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

Ví dụ:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status Chỉ định trạng thái doanh nghiệp cần xem xét. Bạn có thể chỉ định nhiều trạng thái của doanh nghiệp. ARRAY<STRING>

Các giá trị được hỗ trợ:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

Ví dụ:

["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout Cân nhắc những địa điểm có dịch vụ mang đi. BOOLEAN TRUE, FALSE
delivery Cân nhắc những nơi có dịch vụ giao hàng. BOOLEAN TRUE, FALSE
dine_in Cân nhắc những địa điểm có phục vụ dùng bữa tại chỗ. BOOLEAN TRUE, FALSE
curbside_pickup Cân nhắc những địa điểm có dịch vụ nhận hàng ở lề đường. BOOLEAN TRUE, FALSE
reservable Cân nhắc những địa điểm có thể đặt trước. BOOLEAN TRUE, FALSE
outdoor_seating Cân nhắc những địa điểm có chỗ ngồi ngoài trời. BOOLEAN TRUE, FALSE
live_music Cân nhắc những nơi có nhạc sống. BOOLEAN TRUE, FALSE
allows_dogs Cân nhắc những nơi cho phép mang theo chó. BOOLEAN TRUE, FALSE
restroom Cân nhắc những nơi có nhà vệ sinh. BOOLEAN TRUE, FALSE
serves_breakfast Cân nhắc những địa điểm phục vụ bữa sáng. BOOLEAN TRUE, FALSE
serves_lunch Cân nhắc những địa điểm phục vụ bữa trưa. BOOLEAN TRUE, FALSE
serves_dinner Cân nhắc những địa điểm phục vụ bữa tối. BOOLEAN TRUE, FALSE
serves_beer Xem xét những địa điểm phục vụ bia. BOOLEAN TRUE, FALSE
serves_wine Xem xét những địa điểm phục vụ rượu vang. BOOLEAN TRUE, FALSE
serves_brunch Cân nhắc những địa điểm phục vụ bữa sáng muộn. BOOLEAN TRUE, FALSE
serves_vegetarian_food Cân nhắc những địa điểm phục vụ đồ ăn chay. BOOLEAN TRUE, FALSE
serves_cocktails Cân nhắc những nơi phục vụ cocktail. BOOLEAN TRUE, FALSE
serves_dessert Cân nhắc những địa điểm có phục vụ món tráng miệng. BOOLEAN TRUE, FALSE
serves_coffee Xem xét những địa điểm phục vụ cà phê. BOOLEAN TRUE, FALSE
menu_for_children Cân nhắc những địa điểm có thực đơn dành cho trẻ em. BOOLEAN TRUE, FALSE
good_for_children Cân nhắc những địa điểm phù hợp với trẻ em. BOOLEAN TRUE, FALSE
good_for_groups Hãy cân nhắc những địa điểm phù hợp cho nhóm. BOOLEAN TRUE, FALSE
good_for_watching_sports Cân nhắc những địa điểm phù hợp để xem thể thao. BOOLEAN TRUE, FALSE
accepts_credit_cards Hãy cân nhắc những nơi chấp nhận thẻ tín dụng. BOOLEAN TRUE, FALSE
accepts_debit_cards Hãy cân nhắc những nơi chấp nhận thẻ ghi nợ. BOOLEAN TRUE, FALSE
accepts_cash_only Hãy cân nhắc những địa điểm chỉ chấp nhận tiền mặt. BOOLEAN TRUE, FALSE
accepts_nfc Hãy cân nhắc những nơi chấp nhận thanh toán qua NFC. BOOLEAN TRUE, FALSE
free_parking_lot Xem xét những nơi có bãi đỗ xe miễn phí. BOOLEAN TRUE, FALSE
paid_parking_lot Cân nhắc những địa điểm có bãi đỗ xe có tính phí. BOOLEAN TRUE, FALSE
free_street_parking Cân nhắc những nơi có chỗ đỗ xe miễn phí trên đường. BOOLEAN TRUE, FALSE
paid_street_parking Cân nhắc những địa điểm có bãi đỗ xe có tính phí trên đường. BOOLEAN TRUE, FALSE
valet_parking Cân nhắc những nơi có dịch vụ hỗ trợ đỗ xe. BOOLEAN TRUE, FALSE
free_garage_parking Cân nhắc những nơi có gara đỗ xe miễn phí. BOOLEAN TRUE, FALSE
paid_garage_parking Cân nhắc những nơi có gara đỗ xe có tính phí. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Cân nhắc những địa điểm có chỗ đỗ xe cho xe lăn. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Xem xét những địa điểm có lối vào dành cho xe lăn. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Xem xét những địa điểm có nhà vệ sinh cho xe lăn. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Xem xét những địa điểm có chỗ ngồi cho xe lăn. BOOLEAN TRUE, FALSE