Tổng quan

Places Aggregate API là một dịch vụ cung cấp thông tin chi tiết về các địa điểm trong một khu vực được chỉ định dựa trên các tiêu chí như vị trí, loại, trạng thái hoạt động, mức giá và điểm xếp hạng của người dùng. Dịch vụ này có thể giúp phân tích mật độ của các Loại địa điểm cụ thể xung quanh một vị trí nhất định và trả lời các câu hỏi như "Có bao nhiêu nhà hàng $$$ được xếp hạng 5 sao trong bán kính 5 km tính từ vị trí này?"

Kết quả được trả về dưới dạng số lượng tổng hợp hoặc mã địa điểm được xác định trong khu vực tìm kiếm mà người dùng quan tâm. Người dùng có thể sử dụng Place Details API để truy xuất thêm thông tin về các mã địa điểm đó.

Lý do nên sử dụng Places Aggregate API

Places Aggregate API giúp người dùng đưa ra quyết định dựa trên dữ liệu dựa trên thông tin toàn diện mà bạn cung cấp về nhiều địa điểm. API này tận dụng các mô hình địa điểm chính xác và cập nhật, hỗ trợ các trường hợp sử dụng chính sau:

  • Doanh nghiệp: Phân tích đối thủ cạnh tranh và các địa điểm tiềm năng cho các chi nhánh mới.
  • Nhà phát triển: Xây dựng các ứng dụng cung cấp đề xuất được cá nhân hoá.
  • Nhà nghiên cứu: Kiểm tra các xu hướng và mẫu trong các khu vực cụ thể.

Các thao tác mà bạn có thể thực hiện với Places Aggregate API

Với Places Aggregate API, bạn có thể nhận được thông tin sau:

  • Số lượng: Truy xuất số lượng địa điểm phù hợp với tiêu chí của bạn.
  • Mã địa điểm: Truy xuất mã địa điểm của các địa điểm cụ thể phù hợp với tiêu chí của bạn.

Bạn cũng có thể sử dụng tính năng lọc để tinh chỉnh kết quả tìm kiếm dựa trên nhiều thuộc tính như loại địa điểm, giờ hoạt động, mức giá và điểm xếp hạng của khách hàng.

count

Ví dụ

Phần này mô tả trường hợp sử dụng mẫu cho Places Aggregate API và bao gồm mã hoạt động cho từng ví dụ.

Khai trương quán cà phê mới

Một chủ nhà hàng muốn khai trương một quán cà phê mới. Để làm như vậy, trước tiên, họ muốn hình dung vị trí của các điểm nóng của quán cà phê để có thể xác định các khu vực có mật độ cao và thấp nhằm đưa ra quyết định kinh doanh. Places Aggregate API có thể giúp phân tích số lượng quán cà phê trong một bán kính cụ thể dựa trên các thuộc tính như trạng thái hoạt động, mức giá và điểm xếp hạng của khách hàng để đưa ra quyết định dựa trên dữ liệu về địa điểm khai trương tiếp theo.

Xem đoạn nhạc

Bản đồ San Francisco và điểm số giải trí theo mã bưu chính.

Công ty đầu tư bất động sản

Một công ty đầu tư bất động sản muốn nâng cao các mô hình tài chính và xác định chính xác ROI cho các khoản đầu tư bất động sản đã lên kế hoạch. Bằng cách sử dụng Places Aggregate API, họ có thể thu thập dữ liệu chi tiết về các tiện nghi gần các bất động sản đầu tư tiềm năng, chẳng hạn như máy ATM, bệnh viện, trạm trung chuyển và cửa hàng tạp hoá, để có thể hiểu rõ các tiện nghi gần các bất động sản đầu tư tiềm năng.

Dịch vụ giao hàng bán lẻ

Khi mở rộng sang một thành phố mới, dịch vụ giao hàng bán lẻ cần xác định số lượng tài xế giao hàng cần phân bổ cho một khu vực dựa trên mật độ của các điểm đến phổ biến của người tiêu dùng, chẳng hạn như nhà hàng, cửa hàng tiện lợi và cửa hàng rượu. Bằng cách sử dụng API, dịch vụ giao hàng sẽ đếm tổng số cơ sở này trên toàn thành phố để có thể lập kế hoạch và phân bổ tài nguyên một cách hiệu quả.

Xem đoạn nhạc

Bản đồ nhiệt về số lượng nhà hàng ở Mountain View.

Cách hoạt động của Places Aggregate API

Places Aggregate API cho phép bạn chỉ định bộ lọc để thu hẹp tiêu chí tìm kiếm. Sau khi chọn Loại thông tin chi tiết là INSIGHT_COUNT hoặc INSIGHT_PLACES, bạn có thể thêm tiêu chí lọc, bao gồm:

  • Vị trí: Xác định khu vực bạn quan tâm bằng cách sử dụng hình tròn, khu vực hoặc đa giác tuỳ chỉnh.
  • Loại: Chỉ định các loại địa điểm mà bạn quan tâm.
  • Trạng thái hoạt động: Lọc địa điểm dựa trên trạng thái hoạt động của địa điểm.
  • Mức giá: Lọc địa điểm dựa trên mức giá.
  • Điểm xếp hạng: Lọc địa điểm dựa trên điểm xếp hạng của người dùng.

Đối tượng phản hồi API ComputeInsightsResponse chứa kết quả của thông tin chi tiết về yêu cầu. Ví dụ: nếu bạn chọn INSIGHT_COUNT, phản hồi sẽ chứa tổng số địa điểm và nếu bạn chọn INSIGHT_PLACES, phản hồi sẽ chứa danh sách mã địa điểm.

Cách sử dụng Places Aggregate API

1 Thiết lập. Bắt đầu bằng cách Thiết lập dự án trên Google Cloud và hoàn tất các hướng dẫn sau.
2 Đưa ra yêu cầu để nhận số lượng địa điểm phù hợp. Xem phần Đưa ra yêu cầu đầu tiên.
3 Tìm hiểu về các tham số yêu cầu. Xem phần Tham số yêu cầu.

Bước tiếp theo