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

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

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 ที่แคชไว้

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

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

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"
    },
    ...
  ]
}