Method: currentConditions.lookup

ปลายทางสภาพอากาศปัจจุบันให้ข้อมูลคุณภาพอากาศรายชั่วโมงในกว่า 100 ประเทศ โดยมีความละเอียดสูงสุด 500 x 500 เมตร มีดัชนีในพื้นที่กว่า 70 รายการ รวมถึงดัชนีและหมวดหมู่คุณภาพอากาศทั่วโลก

คำขอ HTTP

POST https://airquality.googleapis.com/v1/currentConditions:lookup

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
ช่อง
location

object (LatLng)

ต้องระบุ ลองจิจูดและละติจูดที่ API ค้นหาข้อมูลสภาพอากาศปัจจุบัน
extraComputations[]

enum (ExtraComputation)

ไม่บังคับ ฟีเจอร์เพิ่มเติมที่เลือกเปิดใช้ได้ การระบุการคำนวณเพิ่มเติมจะส่งผลให้ระบบแสดงองค์ประกอบและช่องที่เกี่ยวข้องในคำตอบ
uaqiColorPalette

enum (ColorPalette)

ไม่บังคับ กำหนดชุดสีที่ใช้สำหรับข้อมูลที่ได้จาก "ดัชนีคุณภาพอากาศสากล" (UAQI) ชุดสีนี้เกี่ยวข้องกับ UAQI เท่านั้น ส่วน AQI อื่นๆ มีชุดสีที่กําหนดไว้ล่วงหน้าซึ่งควบคุมไม่ได้
customLocalAqis[]

object (CustomLocalAqi)

ไม่บังคับ แสดง "ประเทศ/ภูมิภาคต่อ AQI" ความสัมพันธ์ จับคู่ประเทศ/ภูมิภาคกับ AQI ที่ต้องการเพื่อให้ระบบแสดงข้อมูลคุณภาพอากาศที่จำเป็นสำหรับประเทศ/ภูมิภาคนั้นตาม AQI ที่เลือก พารามิเตอร์นี้ใช้เพื่อระบุ AQI ที่ไม่ใช่ค่าเริ่มต้นสำหรับประเทศหนึ่งๆ ได้ เช่น เพื่อรับดัชนี EPA สหรัฐอเมริกาสำหรับแคนาดาแทนดัชนีเริ่มต้นสำหรับแคนาดา
universalAqi

boolean

ไม่บังคับ หากตั้งค่าเป็น "จริง" AQI สากลจะรวมอยู่ใน "ดัชนี" ของคำตอบ ค่าเริ่มต้นคือ True
languageCode

string

ไม่บังคับ อนุญาตให้ไคลเอ็นต์เลือกภาษาสำหรับคำตอบ หากไม่สามารถระบุข้อมูลสำหรับภาษานั้นได้ API จะใช้การจับคู่ที่ใกล้เคียงที่สุด ค่าที่อนุญาตจะอิงตามมาตรฐาน IETF ค่าเริ่มต้นคือ en

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
ช่อง
dateTime

string (Timestamp format)

การประทับเวลาที่ปัดเศษใน "ซูลู" RFC3339 UTC โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก เช่น "2014-10-02T15:00:00Z"
regionCode

string

รหัส ISO_3166-1 alpha-2 ของประเทศ/ภูมิภาคที่ตรงกับสถานที่ตั้งที่ระบุไว้ในคําขอ ช่องนี้อาจไม่แสดงในคำตอบหากตำแหน่งที่ระบุไว้ในคำขออยู่ในเขตแดนที่มีการโต้แย้ง
indexes[]

object (AirQualityIndex)

รายการนี้ประกอบด้วยดัชนีคุณภาพอากาศ (สูงสุด) 2 รายการตามพารามิเตอร์คำขอ ได้แก่

  • AQI ระดับสากล ระบบจะแสดงผลหากตั้งค่าบูลีน UniversalAqi เป็น "จริง"
  • AQI ระดับท้องถิ่น จะส่งคืนหากมีการระบุการคำนวณเพิ่มเติม LOCAL_AQI
pollutants[]

object (Pollutant)

รายการสารมลพิษที่ส่งผลต่อตำแหน่งที่ระบุไว้ในคำขอ หมายเหตุ: ฟิลด์นี้จะส่งคืนเฉพาะคำขอที่ระบุการคำนวณเพิ่มเติมต่อไปนี้: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION
healthRecommendations

object (HealthRecommendations)

คำแนะนำด้านสุขภาพและการดำเนินการที่แนะนำที่เกี่ยวข้องกับสภาวะคุณภาพอากาศที่รายงาน คำแนะนำได้รับการปรับให้เหมาะกับประชากรที่มีความเสี่ยง กลุ่มที่มีความไวต่อสารมลพิษมากกว่า และกลุ่มประชากรทั่วไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0