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

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 ปลายทางยอมรับพารามิเตอร์คำขอต่อไปนี้

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

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

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

เกี่ยวกับคำตอบการพยากรณ์อากาศรายนาที

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

ช่อง Description
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"
    },
    ...
  ]
}