Thực hiện yêu cầu đầu tiên của bạn

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, bao gồm cả số lượng địa điểm phù hợp.

Hãy làm thử!

Để sử dụng Places Aggregate API, hãy gửi 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ố về khu vực và loại trong 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ó mức giá vừa phải và được xếp hạng 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 phù hợp với tiêu chí.

{
  "count": "850"
}

Hãy làm thử!

API Explorer cho phép bạn đưa ra các yêu cầu mẫu để làm quen với API và các lựa chọn API.

1. Chọn biểu tượng API, , ở bên phải trang.
2. Bạn có thể mở rộng phần Hiện các tham số tiêu chuẩn để đặt mọi tham số.
3. Bạn có thể chỉnh sửa Nội dung yêu cầu.
4. 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.

5. 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 các tham số yêu cầu chi tiết hơn.
• Xem tài liệu đầy đủ về API.