API tổng hợp địa điểm 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ụ thể 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 một số 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ó những nhà hàng nào hoặc có bao nhiêu nhà hàng $$$ được xếp hạng 5 sao trong bán kính 5 km 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 được quan tâm. Người dùng có thể sử dụng API Chi tiết địa điểm để truy xuất thêm thông tin về các mã địa điểm đó.
Lý do sử dụng API Places Aggregate
API Tổng hợp địa điểm 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à mới 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à vị trí 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 lĩnh vực cụ thể.
Những việc bạn có thể làm với API Tổng hợp địa điểm
Với API Places Aggregate, bạn có thể nhận được cá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 những địa điểm cụ thể khớ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, chẳng hạn 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.
Ví dụ
Phần này mô tả ví dụ về trường hợp sử dụng API Places Aggregate và bao gồm mã hoạt động cho từng ví dụ.
Mở một quán cà phê mới
Một chủ nhà hàng muốn mở 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 phát sóng của quán cà phê để có thể xác định các khu vực tập trung nhiều và ít người để đưa ra quyết định kinh doanh. API Tổng hợp địa điểm 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ề vị trí mở địa điểm tiếp theo.
Công ty đầu tư bất động sản
Một công ty đầu tư bất động sản muốn cải thiện mô hình tài chính và xác định chính xác lợi tức đầu tư (ROI) trên các khoản đầu tư bất động sản theo kế hoạch. Bằng cách sử dụng API Tổng hợp địa điểm, họ có thể thu thập dữ liệu chi tiết về các tiện nghi gần các cơ sở lưu trú tiềm năng để đầu tư, chẳng hạn như máy ATM, bệnh viện, trạm phương tiện công cộng và cửa hàng tạp hoá, để có thể hiểu rõ các tiện nghi gần các cơ sở lưu trú tiềm năng để đầu tư.
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 để phân bổ cho một khu vực dựa trên mật độ 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 bán đồ uống có cồn. Bằng cách sử dụng API, dịch vụ giao hàng sẽ tính tổng số các 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ả.
Cách hoạt động của API Places Aggregate
API Tổng hợp địa điểm 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í bộ lọc, bao gồm:
- Vị trí: Xác định khu vực 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 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 ComputeInsightsResponse phản hồi API 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 API tổng hợp địa điểm
| 1 | Thiết lập. | Bắt đầu bằng cách Thiết lập dự án Google Cloud rồi 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 trùng khớ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 Thông số yêu cầu. |
Bước tiếp theo
- Xem lại mức giá và giới hạn sử dụng
- Xem tài liệu tham khảo API
- Xem phần Câu hỏi thường gặp
- Xem các lựa chọn hỗ trợ