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 sẽ khác nhau đối với từng hàm:

Tên bộ lọc và giá trị của bộ lọc phân biệt chữ hoa chữ thường. Bạn phải chỉ định chính xác như trong bảng. Nếu không, truy vấn sẽ trả về lỗi đối số không hợp lệ.

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ể sử dụng tham số geography kết hợp với geography_radius để thêm vùng đệm vào khu vực tìm kiếm.

Chúng tôi áp dụng khu vực tìm kiếm tối thiểu là 40,0 mét x 40,0 mét (1600 m2). Nếu bạn chỉ định khu vực tìm kiếm dưới mức 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 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ể sử dụng tham số geographies kết hợp 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.

Chúng tôi áp dụng khu vực tìm kiếm tối thiểu là 40,0 mét x 40,0 mét (1600 m2). Nếu bạn chỉ định khu vực tìm kiếm dưới mức 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ý được chỉ định. Giá trị mặc định là "0".

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

 INT64 Tối thiểu là 0.
h3_resolution

Chỉ dành cho PLACES_COUNT_PER_H3

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

 INT64 Từ 0 đến 11.
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ó, xem Các loại địa điểm.

Ví dụ:

["restaurant", "cafe", "bar"]
primary_type

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 đó phù hợp 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 đề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 bài viết Các loại địa điểm.

Ví dụ:

["restaurant", "cafe", "bar"]
brand_ids

Chỉ dành cho PLACES_COUNT_PER_H3, PLACES_COUNT_V2 và PLACES_COUNT_PER_TYPE_V2

Chỉ định các mã thương hiệu cần xem xét.

Mỗi địa điểm có thể được liên kết với mã thương hiệu. Nếu bạn không chỉ định mã thương hiệu nào, thì tất cả các thương hiệu (và địa điểm không có thương hiệu) đều được xem xét trong kết quả.

Lưu ý: Dữ liệu về thương hiệu chỉ được hỗ trợ ở một số quốc gia. Hiện tại: Hoa Kỳ (US), Canada (CA), Vương quốc Anh (GB) và Úc (AU).

 ARRAY<STRING>

Mảng mã thương hiệu. Để biết thêm thông tin về dữ liệu thương hiệu, hãy xem Viết truy vấn bằng dữ liệu thương hiệu.

Ví dụ:

["brand_001", "brand_002"]
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.0 đến 5.0

Nếu bạn chỉ định điểm xếp hạng 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.0 đến 5.0

Nếu bạn chỉ định điểm xếp hạng 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ượt xếp hạng tối thiểu 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 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ượt xếp hạng tối đa 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 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

Chỉ định các mức giá cần xem xét.

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 kinh doanh cần xem xét. Bạn có thể chỉ định nhiều trạng thái kinh doanh. ARRAY<STRING>

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

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

Ví dụ:

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