Tham số bộ lọc

Bạn có thể áp dụng bộ lọc cho các hàm Places Count 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 có phân biệt chữ hoa chữ thường. Bạn phải chỉ định chính xác các giá trị này 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ể 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.

Diện tích 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.

Diện tích 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 (1.600 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 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ó, hãy 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ả chính xác nhất về địa điểm đó.

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

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

Chỉ định mã nhận dạng 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ã nhận dạng thương hiệu, thì tất cả thương hiệu (và địa điểm không có thương hiệu) sẽ đượ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ột 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 bài viết 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 đế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 điểm xếp hạng từ 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

Chỉ đị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 kinh doanh. ARRAY<STRING>

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

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

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 địa điểm 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ụ ăn 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 địa điểm 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 Cân nhắc 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 địa điểm phục vụ cocktail. BOOLEAN TRUE, FALSE
serves_dessert Cân nhắc những địa điểm 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 nơi 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 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 Xem xét 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 trên đường miễn phí. BOOLEAN TRUE, FALSE
paid_street_parking Xem xét những địa điểm có chỗ đỗ xe trên đường có tính phí. 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 Xem xét những nơi có gara đỗ xe có tính phí. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Xem xét 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 Cân nhắc những địa điểm có chỗ ngồi cho xe lăn. BOOLEAN TRUE, FALSE
snapshot_date

Chỉ định tháng có ảnh chụp nhanh trước đây để truy vấn.

Nếu bạn bỏ qua thuộc tính này, hệ thống sẽ mặc định sử dụng ảnh chụp nhanh gần đây nhất.

 STRING

Định dạng: YYYY-MM.

Ví dụ: "2026-07"
month1

Chỉ dành cho PLACES_COUNT_CHANGE

Chỉ định tháng chụp nhanh cơ sở để truy vấn.

 STRING

Định dạng: YYYY-MM.

Ví dụ: "2026-01"
month2

Chỉ dành cho PLACES_COUNT_CHANGE

Chỉ định tháng chụp nhanh so sánh để truy vấn.

 STRING

Định dạng: YYYY-MM.

Ví dụ: "2026-02"
regular_opening_hours

Lọc các địa điểm theo giờ mở cửa thông thường.

 JSON

Ví dụ: JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count

Chỉ định số lượng tối thiểu đầu nối sạc xe điện.

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

Chỉ định số lượng tối đa đầu nối sạc xe điện.

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

Chỉ định tốc độ sạc tối đa (tính bằng kW) cho trạm sạc xe điện.

 FLOAT64 Giá trị tối thiểu là 0.0.
ev_charge_connector_types

Chỉ định các loại giắc cắm xe điện cần xem xét.

 ARRAY<STRING>

Ví dụ: ["EV_CONNECTOR_TYPE_TESLA"]