ส่งคําขอแรก

เอกสารนี้จะแนะนำขั้นตอนการส่งคำขอพื้นฐานไปยัง Places Aggregate API และทำความเข้าใจการตอบกลับ ซึ่งรวมถึงจำนวนสถานที่ที่ตรงกัน

ลองใช้งาน

หากต้องการใช้ Places Aggregate API ให้ส่งคำขอ HTTP POST ไปยังปลายทาง computeInsights ดังนี้

https://areainsights.googleapis.com/v1:computeInsights

ปรับแต่งคำขอโดยระบุพารามิเตอร์ภูมิภาคและประเภทในเนื้อหา JSON ตัวอย่างนี้แสดงคำขอให้แสดงจำนวนร้านอาหารในซานฟรานซิสโกที่เปิดให้บริการ มีราคาระดับปานกลาง และมีคะแนนระหว่าง 4 ถึง 5 ดาว

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
      }
   }
}'

การตอบกลับจาก Places Aggregate API

การตอบกลับต่อไปนี้จากคำขอตัวอย่างด้านบนแสดงจำนวนร้านอาหารที่ตรงกับเกณฑ์

{
  "count": "850"
}

ลองใช้งาน

API Explorer ช่วยให้คุณส่งคำขอตัวอย่างเพื่อให้คุ้นเคยกับ API และตัวเลือก API

  1. เลือกไอคอน API ขยายโปรแกรมสำรวจ API ทางด้านขวาของหน้า
  2. ขยายแสดงพารามิเตอร์มาตรฐาน เพื่อตั้งค่า พารามิเตอร์ (ไม่บังคับ)
  3. แก้ไขเนื้อหาคำขอ (ไม่บังคับ)
  4. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่ต้องการใช้ส่งคำขอ

  5. ในแผง API Explorer ให้เลือกไอคอนขยาย ขยายโปรแกรมสำรวจ API เพื่อขยายหน้าต่าง API Explorer

ขั้นตอนถัดไป

  • สำรวจตัวอย่างเพิ่มเติมเกี่ยวกับสิ่งที่คุณทำได้ด้วย Places Aggregate API
  • ดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์คำขอ
  • ดูเอกสารประกอบเกี่ยวกับ API ฉบับเต็ม