ส่งคําขอแรก

เอกสารนี้จะแนะนำขั้นตอนการส่งคำขอพื้นฐานไปยัง 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 ช่วยให้คุณส่งคำขอตัวอย่างเพื่อทำความคุ้นเคยกับ API และตัวเลือก API

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

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

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

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