ภาพรวมของ Weather API

Weather API ช่วยให้คุณขอข้อมูลสภาพอากาศแบบเจาะจงเฉพาะพื้นที่และเรียลไทม์สำหรับสถานที่ต่างๆ ทั่วโลกเพื่อขับเคลื่อนแดชบอร์ดสภาพอากาศแบบเรียลไทม์ แอปอัปเดตสภาพอากาศ การวางซ้อนสภาพอากาศบนเส้นทาง และเครื่องมือติดตามสุขภาพหรือกิจกรรมตามสภาพอากาศ ข้อมูลสภาพอากาศประกอบด้วยอุณหภูมิปัจจุบัน ปริมาณน้ำฝน ความชื้นสัมพัทธ์ ความเร็วลม ดัชนีรังสียูวี และอื่นๆ

สำหรับสถานที่ตั้งที่ละติจูดและลองจิจูดที่ระบุ API จะมีปลายทาง (https://weather.googleapis.com/v1/...) สำหรับข้อมูลในตารางต่อไปนี้

ปลายทาง REST โดยย่อ

ปลายทาง API URL คำอธิบาย พารามิเตอร์ที่บันทึกไว้
สภาพอากาศปัจจุบัน https://weather.googleapis.com/v1/currentConditions:lookup สภาพอากาศแบบเรียลไทม์ location.latitude, location.longitude
พยากรณ์รายชั่วโมง https://weather.googleapis.com/v1/forecast/hours:lookup สภาพอากาศที่คาดการณ์สูงสุด 240 ชั่วโมง location.latitude, location.longitude
พยากรณ์รายวัน https://weather.googleapis.com/v1/forecast/days:lookup สภาพอากาศที่คาดการณ์สูงสุด 10 วัน location.latitude, location.longitude
ประวัติรายชั่วโมง https://weather.googleapis.com/v1/history/hours:lookup แคชข้อมูลสภาพอากาศที่ผ่านมาได้สูงสุด 24 ชั่วโมง location.latitude, location.longitude
การแจ้งเตือนสภาพอากาศเลวร้าย https://weather.googleapis.com/v1/publicAlerts:lookup การแจ้งเตือนสภาพอากาศเลวร้าย key, location.latitude, location.longitude

กรณีการใช้งานทั่วไป

  • แดชบอร์ดสภาพอากาศแบบเรียลไทม์และอัปเดตสภาพอากาศ: ค้นหา currentConditions:lookup, forecast/hours:lookup และ forecast/days:lookup โดยใช้พิกัด GPS (location.latitude และ location.longitude) หรือพิกัดเมืองที่เข้ารหัสพิกัดภูมิศาสตร์เพื่อแสดงอุณหภูมิ ความชื้น และความเร็วลมที่อัปเดตอัตโนมัติ
  • การวางซ้อนสภาพอากาศในเส้นทาง: ตัวอย่างจุดอ้างอิงละติจูดและลองจิจูดตามเส้นประกอบของเส้นทางจาก Routes API และเรียกใช้ currentConditions:lookup หรือ forecast/hours:lookup ที่เวลาถึงโดยประมาณของจุดอ้างอิงแต่ละจุดเพื่อแจ้งเตือนผู้ขับขี่เกี่ยวกับสภาพอากาศที่เปลี่ยนแปลง
  • เครื่องมือติดตามสุขภาพ การดื่มน้ำ และกิจกรรมตามสภาพอากาศ: ดึงข้อมูลtemperature, feelsLikeTemperature, relativeHumidity, heatIndex และuvIndexในพื้นที่จาก currentConditions:lookup เพื่อปรับเป้าหมายการดื่มน้ำในแต่ละวันหรือคำแนะนำในการออกกำลังกายกลางแจ้ง

ฟีเจอร์ของ Weather API

ข้อมูล Weather API ประกอบด้วยข้อมูลต่อไปนี้

  • สภาพอากาศและไอคอน: คำอธิบายและไอคอนที่เกี่ยวข้องซึ่งระบุสภาพอากาศปัจจุบัน (เช่น "มีเมฆมาก" หรือ "มีหิมะตกกระจายเป็นแห่งๆ") ใน weatherCondition
  • อุณหภูมิ: อุณหภูมิปัจจุบัน (temperature) อุณหภูมิต่ำสุดและสูงสุด (minTemperature และ maxTemperature ในพยากรณ์อากาศรายวัน หรือภายใน currentConditionsHistory) และอุณหภูมิที่ปรากฏ ("รู้สึกเหมือน") (feelsLikeTemperature)
  • การเกิดฝน: ปริมาณน้ำฝนทั้งหมดและประเภทของฝน (หิมะ ฝน น้ำแข็ง ฝนปนหิมะ)
  • ลม: อุณหภูมิที่ผิวหนัง (windChill) ทิศทางลม (wind.direction) ความเร็วลม (wind.speed) และลมกระโชก (wind.gust)
  • ความหนาของน้ำแข็ง: ความหนาของน้ำแข็ง
  • ความชื้น: จุดน้ำค้าง (dewPoint) ดัชนีความร้อน (heatIndex) อุณหภูมิกระเปาะเปียก (wetBulbTemperature) และความชื้นสัมพัทธ์ (relativeHumidity)
  • ดัชนีรังสียูวี: ดัชนีรังสีอัลตราไวโอเลต (UV) (uvIndex)
  • ความน่าจะเป็นที่จะเกิดพายุฝนฟ้าคะนอง: โอกาสที่จะเกิดพายุฝนฟ้าคะนองเป็นเปอร์เซ็นต์
  • ทัศนวิสัย: ระยะทางที่มองเห็นวัตถุได้อย่างชัดเจน
  • ความกดอากาศ: ความกดอากาศเฉลี่ยที่ระดับน้ำทะเล
  • เหตุการณ์เกี่ยวกับดวงอาทิตย์และดวงจันทร์: เวลาพระอาทิตย์ขึ้น พระอาทิตย์ตก ดวงจันทร์ขึ้น และดวงจันทร์ตก
  • เมฆปกคลุม: เปอร์เซ็นต์ของท้องฟ้าที่ปกคลุมด้วยเมฆ

วิธีใช้ Weather API

1 เริ่มตั้งค่า เริ่มต้นด้วยการตั้งค่าโปรเจ็กต์ Google Cloud และทำตามวิธีการที่ตามมาให้เสร็จสมบูรณ์
2 ดูสภาพอากาศปัจจุบัน โปรดดูหัวข้อดูสภาพปัจจุบัน
3 ดูพยากรณ์อากาศรายชั่วโมง ดูรับพยากรณ์อากาศรายชั่วโมง
4 รับพยากรณ์อากาศประจำวัน ดูรับการคาดการณ์รายวัน
5 ดูประวัติรายชั่วโมง โปรดดูหัวข้อดูประวัติรายชั่วโมง
6 รับการแจ้งเตือนสภาพอากาศ ดูหัวข้อรับการแจ้งเตือนสภาพอากาศ

สำหรับดัชนีคุณภาพอากาศ (AQI) และมลพิษจากฝุ่นละออง (PM2.5, PM10) ให้ใช้ Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup) เนื่องจาก Weather API จะไม่แสดงค่าเหล่านี้

API ด้านสิ่งแวดล้อมอื่นๆ ที่เกี่ยวข้อง ได้แก่

  • ปริมาณละอองเกสร: Pollen API (https://pollen.googleapis.com/v1/forecast:lookup)
  • ปริมาณการแผ่รังสีของดวงอาทิตย์และศักยภาพในการใช้พลังงานแสงอาทิตย์จากหลังคา: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

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