Tài liệu này hướng dẫn bạn cách đưa ra yêu cầu cơ bản đối với Places Aggregate API và tìm hiểu phản hồi, trong đó có số lượng địa điểm trùng khớp.
Để sử dụng Places Aggregate API, hãy gửi một yêu cầu HTTP POST đến điểm cuối computeInsights
như sau:
https://areainsights.googleapis.com/v1:computeInsights
Tinh chỉnh yêu cầu bằng cách cung cấp các tham số khu vực và loại trong phần nội dung JSON. Ví dụ này cho thấy một yêu cầu trả về số lượng nhà hàng đang hoạt động, có giá vừa phải và được đánh giá từ 4 đến 5 sao ở San Francisco.
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \ --header 'X-Goog-Api-Key: API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "insights":[ "INSIGHT_COUNT" ], "filter":{ "locationFilter":{ "region":{ "place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo" } }, "typeFilter":{ "includedTypes":[ "restaurant" ] }, "operatingStatus":[ "OPERATING_STATUS_OPERATIONAL" ], "priceLevels":[ "PRICE_LEVEL_INEXPENSIVE" ], "ratingFilter":{ "minRating":4.0, "maxRating":5.0 } } }'
Phản hồi của Places Aggregate API
Phản hồi sau đây từ yêu cầu mẫu ở trên cho biết số lượng nhà hàng đáp ứng các tiêu chí.
{ "count": "850" }
Hãy dùng thử!
API Explorer cho phép bạn đưa ra các yêu cầu mẫu để có thể làm quen với API và các lựa chọn API.
- Chọn biểu tượng API,
, ở bên phải trang.
- Bạn có thể mở rộng phần Hiện các thông số chuẩn để đặt bất kỳ thông số nào.
- Bạn có thể chỉnh sửa Nội dung yêu cầu (không bắt buộc).
- Chọn nút Thực thi. Trong hộp thoại, hãy chọn tài khoản mà bạn muốn dùng để đưa ra yêu cầu.
Trong bảng điều khiển API Explorer, hãy chọn biểu tượng mở rộng
để mở rộng cửa sổ API Explorer.
Bước tiếp theo
- Khám phá thêm các ví dụ về những việc bạn có thể làm với Places Aggregate API.
- Xem xét các tham số yêu cầu một cách chi tiết hơn.
- Xem tài liệu đầy đủ về API.