Tham số bộ lọc

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

• PLACES_COUNT: cần có geography
• PLACES_COUNT_PER_TYPE_V2: yêu cầu geography và type
• PLACES_COUNT_V2: cần có geographies
• PLACES_COUNT_PER_H3: cần có geography và h3_resolution
• PLACES_COUNT_CHANGE: yêu cầu month1 và month2

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	Dành cho 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. Khu vực tìm kiếm tối thiểu là 40 m x 40 m (1.600 m^2). Nếu bạn chỉ định một vùng tìm kiếm dưới giới hạn này, thì hàm sẽ trả về lỗi đối số không hợp lệ.	GEOGRAPHY	Bất kỳ loại GEOGRAPHY nào.
geographies	Chỉ dành cho PLACES_COUNT_PER_GEO Chỉ định danh sách các khu vực cần 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ý đã chỉ định. Khu vực tìm kiếm tối thiểu là 40 m x 40 m (1.600 m^2). Nếu bạn chỉ định một khu vực 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>	Bất kỳ loại GEOGRAPHY nào.
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 một khu vực tìm kiếm tối thiểu là 40 m x 40 m (1.600 m^2). Ví dụ: đối với vị trí địa lý Point, 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 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>	Để xem danh sách đầy đủ các giá trị có thể có, hãy xem phần 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, thì tất cả loại địa điểm chính đều được xem xét trong kết quả.	ARRAY<STRING>	Để xem danh sách đầy đủ các giá trị có thể có, hãy xem phần 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ã 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, 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 gồm các 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 địa điểm tối thiểu 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à nằm trong khoảng từ 1 đến 5 Nếu bạn chỉ định một mức xếp hạng nằm ngoài phạm vi này, thì hàm sẽ trả về lỗi đối số không hợp lệ.	FLOAT	Từ 1 đến 5.
max_rating	Chỉ định điểm xếp hạng địa điểm tối đa 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à nằm trong khoảng từ 1 đến 5 Nếu bạn chỉ định một mức xếp hạng nằm ngoài phạm vi này, thì hàm sẽ trả về lỗi đối số không hợp lệ.	FLOAT	Từ 1 đến 5.
min_user_rating_count	Chỉ định số lượng điểm xếp hạng từ người dùng tối thiểu cần xem xét. Số lượng điểm xếp hạng từ người dùng là tổng số bài đánh giá về một địa điểm. Giá trị tối thiểu là 0. Nếu bạn chỉ định một giá trị nhỏ hơn 0, thì 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 điểm xếp hạng từ người dùng tối đa cần xem xét. Số lượng điểm xếp hạng từ người dùng là tổng số bài đánh giá về một địa điểm. Giá trị tối thiểu là 0. Nếu bạn chỉ định một giá trị nhỏ hơn 0, thì 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 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ó phục vụ đồ ăn 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 chỗ.	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 địa điểm cho phép mang theo chó.	BOOLEAN	TRUE, FALSE
restroom	Cân nhắc những địa điểm 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	Cân nhắc 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 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 địa điểm 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 địa điểm chấp nhận thanh toán qua NFC.	BOOLEAN	TRUE, FALSE
free_parking_lot	Xem xét những địa điểm 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 địa điểm có chỗ đỗ xe trên đường miễn phí.	BOOLEAN	TRUE, FALSE
paid_street_parking	Cân nhắc 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 địa điểm có dịch vụ đỗ xe.	BOOLEAN	TRUE, FALSE
free_garage_parking	Cân nhắc những địa điểm có gara đỗ xe miễn phí.	BOOLEAN	TRUE, FALSE
paid_garage_parking	Cân nhắc những địa điểm có gara đỗ xe có tính phí.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_parking	Cân nhắc những địa điểm có bãi đỗ xe dành cho xe lăn.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_entrance	Cân nhắc những địa điểm có lối vào dành cho xe lăn.	BOOLEAN	TRUE, FALSE
wheelchair_accessible_restroom	Cân nhắc 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ủa ảnh chụp nhanh trước đây cần truy vấn. Nếu bạn bỏ qua, thì 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 của ảnh 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 của ảnh chụp nhanh so sánh cần truy vấn.	STRING	Định dạng: YYYY-MM. Ví dụ: "2026-02"
regular_opening_hours	Lọ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 các đầ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 đầu nối sạc xe điện tối đa.	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 các 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 đầu nối xe điện cần xem xét.	ARRAY<STRING>	Ví dụ: ["EV_CONNECTOR_TYPE_TESLA"]