ดูพยากรณ์อากาศแบบนาที (ทดลอง)

forecast:minutesปลายทางจะให้การพยากรณ์ปริมาณน้ำฝนแบบนาทีต่อนาทีที่มีความละเอียดสูง (หรือที่เรียกว่าการพยากรณ์อากาศปัจจุบัน) สำหรับตำแหน่งที่ระบุ

API จะแสดงข้อมูลต่อไปนี้ในช่วงเวลา 6 ชั่วโมง

  • เวลาเริ่มต้นและสิ้นสุดของกรอบเวลาการคาดการณ์
  • เขตเวลาของสถานที่ที่ขอ
  • เวลาเริ่มต้นและสิ้นสุดของแต่ละกลุ่มการคาดการณ์
  • ประเภท ความเป็นไปได้ ปริมาณ และความหนักของหยาดน้ำฟ้าที่คาดการณ์ไว้ในช่วงเวลาต่างๆ

ข้อกำหนด

ข้อกำหนดเหล่านี้ออกภายใต้ส่วนที่ 6 (ข้อกำหนดของข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ของข้อกำหนดเฉพาะของบริการ Google Maps Platform ตามที่ Google และคุณตกลงกัน

1.1 ข้อกำหนดในการระบุแหล่งที่มา ลูกค้าต้องระบุแหล่งที่มาให้ Google ตามเอกสารประกอบหากลูกค้าใช้เนื้อหา Google Maps จาก Weather API

1.2 ข้อจำกัด ลูกค้าไม่สามารถใช้เนื้อหา Google Maps ที่ดึงมาจาก Weather API เพื่อสร้างบริการหรือผลิตภัณฑ์ของ Google ขึ้นใหม่ (เช่น ใช้ข้อมูลที่ดึงมาจาก Weather API ในแอปหรือโมเดลสภาพอากาศที่มีวัตถุประสงค์หลักในการ ให้ข้อมูลสภาพอากาศ)

1.3 การแคช ลูกค้าสามารถแคชเนื้อหา Google Maps ที่เกี่ยวข้องจาก Weather API เป็นการชั่วคราวในช่วงเวลาแคชที่เกี่ยวข้องตามที่อธิบายไว้ใน ตาราง 1.3.1 (สิทธิ์ในการแคช)

ตารางที่ 1.3.1 (สิทธิ์การแคช)

สิทธิ์เหล่านี้เป็นสิทธิ์เพิ่มเติมจากที่อธิบายไว้ในตาราง 17.2.1 ของข้อกำหนดเฉพาะของบริการ Google Maps Platform

เนื้อหาของ Google Maps ระยะเวลาการแคช
ค่าการพยากรณ์อากาศรายนาที 1 ชั่วโมง หลังจากนั้นลูกค้าต้องลบเนื้อหา Google Maps ที่แคชไว้

เกี่ยวกับคำขอการคาดการณ์แบบนาที

หากต้องการขอพยากรณ์อากาศรายนาที ให้ส่งคำขอ HTTP GET ไปยัง

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

ระบุพิกัดละติจูดและลองจิจูดของสถานที่ในพารามิเตอร์คำขอ

พารามิเตอร์คำขอ

ปลายทาง forecast.minutes ยอมรับพารามิเตอร์คำขอต่อไปนี้

พารามิเตอร์ คำอธิบาย ต้องระบุหรือไม่บังคับ
location.latitude พิกัดละติจูดของสถานที่ที่ขอ ต้องระบุ
location.longitude พิกัดลองจิจูดของสถานที่ที่ขอ ต้องระบุ
unitsSystem ระบบหน่วยที่ขอ ค่าต่างๆ ได้แก่
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

หากไม่ได้ระบุระบบหน่วย การตอบกลับจะใช้ METRIC เป็นค่าเริ่มต้น

 ไม่บังคับ
pageSize ระบุจำนวนผลลัพธ์สูงสุดที่จะแสดง ไม่บังคับ
pageToken โทเค็นหน้าเว็บที่ได้รับจากคำขอก่อนหน้า หากต้องการดึงข้อมูลหน้าถัดไป ให้ส่ง pageToken เป็นพารามิเตอร์อินพุตในคำขอถัดไป ไม่บังคับ

เกี่ยวกับการตอบกลับการคาดการณ์รายนาที

Weather API จะแสดงผลช่องต่อไปนี้ในเนื้อหาการตอบกลับ

ช่อง คำอธิบาย
overallPredictionTimeframe กรอบเวลาโดยรวมสำหรับการคาดการณ์
overallPredictionTimeframe.startTime เวลาเริ่มต้นของกรอบเวลาการคาดการณ์ ซึ่งแสดงถึงจุดอ้างอิงเริ่มต้น
overallPredictionTimeframe.endTime เวลาสิ้นสุดของกรอบเวลาการคาดการณ์ โดยระบบจะตั้งค่านี้ 6 ชั่วโมงหลังจากเวลาเริ่มต้น
timeZone เขตเวลาของสถานที่ที่ขอ
segments กลุ่มการคาดการณ์ระดับนาที ซึ่งระบุด้วย timeFrame
segments.timeFrame กรอบเวลาที่เกี่ยวข้องกับกลุ่ม
segments.timeFrame.startTime เวลาเริ่มต้นของส่วน
segments.timeFrame.endTime เวลาสิ้นสุดของกลุ่ม
segments.type ประเภทของหยาดน้ำฟ้าที่คาดการณ์ไว้ในช่วงนั้น ค่าต่างๆ มีดังนี้
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability โอกาสที่คาดการณ์ไว้ว่าฝนจะตกในช่วงนั้น ค่าเป็นเปอร์เซ็นต์ตั้งแต่ 0 ถึง 100
segments.qpf การคาดการณ์ปริมาณน้ำฝนเชิงปริมาณ
segments.qpf.quantity ปริมาณน้ำฝนที่คาดการณ์ไว้ในช่วงนั้น
segments.qpf.unit หน่วยที่ใช้วัดปริมาณฝนที่สะสม (เช่น MILLIMETERS, INCHES)
segments.snowfallAmount ปริมาณหิมะที่คาดการณ์ในช่วงนั้น
segments.snowfallAmount.quantity ปริมาณหิมะที่คาดการณ์ (เทียบเท่ากับน้ำในสถานะของเหลว) ในช่วงเวลานั้น
segments.snowfallAmount.unit หน่วยที่ใช้วัดปริมาณหิมะที่สะสม (เช่น MILLIMETERS, INCHES)
segments.intensity ความเข้มของฝนในกลุ่ม ค่าต่างๆ มีดังนี้
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken โทเค็นที่ส่งเป็น pageToken เพื่อดึงข้อมูลหน้าถัดไปได้ หากละเว้นฟิลด์นี้ จะไม่มีหน้าถัดไป

ตัวอย่างการคาดการณ์รายนาที

ตัวอย่างต่อไปนี้จะขอข้อมูลพยากรณ์อากาศรายนาทีสำหรับสถานที่ใน เวสต์เวอร์จิเนีย

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

ในคำตอบ ออบเจ็กต์ segments จะระบุแต่ละกลุ่มของกรอบเวลาการคาดการณ์โดยรวม 

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}