Thông tin khác về bộ lọc loại

Trong Places Aggregate API, type filter (bộ lọc loại) giúp bạn tập trung vào nội dung tìm kiếm bằng cách cho phép bạn chọn những loại địa điểm mà bạn muốn đưa vào hoặc loại trừ khỏi phản hồi. Bạn có thể tạo danh sách các loại bạn muốn và các loại bạn không muốn, cả cho danh mục chính của một địa điểm và cho các thông tin khác của địa điểm đó. Bằng cách này, bạn có thể tạo nội dung tìm kiếm cụ thể để tìm chính xác những địa điểm mà bạn đang tìm.

Có hơn 200 Loại địa điểm. Để xem danh sách đầy đủ mà Places Aggregate API hỗ trợ, hãy xem Bảng A trong phần Các loại địa điểm cho Places API (mới).

Cách hoạt động của các loại địa điểm

Một địa điểm có thể có nhiều loại địa điểm:

• Một địa điểm có thể có một loại chính phản ánh chức năng chính của địa điểm đó. Tuy nhiên, trong một số trường hợp, loại chính có thể không được chỉ định cho một địa điểm.

• Một địa điểm có thể có một hoặc nhiều loại phụ. Loại phụ là những danh mục bổ sung áp dụng cho một địa điểm để cung cấp thông tin bổ sung về đặc điểm và dịch vụ của địa điểm đó.

Ví dụ: một địa điểm có thể chỉ định loại chính là restaurant, nhưng vì cũng đóng vai trò là quán bar và cung cấp dịch vụ ăn uống, nên địa điểm đó cũng có thể chỉ định các loại địa điểm phụ là bar, food và establishment.

Lọc theo loại

Để lọc địa điểm theo loại chính, hãy sử dụng includedPrimaryTypes và excludedPrimaryTypes trong yêu cầu. Bộ lọc này chỉ áp dụng cho loại chính của một địa điểm. Ví dụ: bộ lọc includedPrimaryTypes cho restaurant chỉ trả về những địa điểm chủ yếu hoạt động như nhà hàng.

Để lọc các địa điểm theo cả loại chính và phụ, hãy sử dụng includedTypes và excludedTypes trong yêu cầu. Bộ lọc này áp dụng cho cả hai loại. Ví dụ: includedTypes của bar sẽ trả về những địa điểm có bar là một trong hai loại chính hoặc loại phụ.

Lưu ý quan trọng: Khi sử dụng nhiều bộ lọc, bạn cần hiểu rõ cách các bộ lọc tương tác với nhau. Cụ thể, các địa điểm được đánh giá bằng logic OR trong cùng một bộ lọc và logic AND trên các bộ lọc khác nhau.

• Trong một bộ lọc (logic OR): Ví dụ: includedTypes: restaurant, bar có nghĩa là địa điểm có thể là restaurant hoặc bar.
• Trên các bộ lọc (logic AND): Tất cả tiêu chí lọc được chỉ định phải được đáp ứng đồng thời. Điều này có nghĩa là mỗi bộ lọc sẽ thêm một lớp hạn chế vào truy vấn và chỉ những địa điểm đáp ứng tất cả các điều kiện mới được đưa vào kết quả.

Ví dụ: nếu bạn đặt includedTypes: restaurant, bar và excludedTypes: hotel; trước tiên, bộ lọc includedTypes sẽ chọn tất cả những địa điểm được phân loại là restaurant hoặc bar. Thứ hai, bộ lọc excludedTypes sẽ xoá mọi địa điểm khỏi lựa chọn này nếu địa điểm đó cũng được phân loại là hotel. Do đó, truy vấn sẽ trả về những địa điểm thuộc loại restaurant hoặc bar, nhưng chỉ khi những địa điểm đó không được phân loại là hotel trong bất kỳ loại nào (chính hoặc phụ).