Method: forecast.days.lookup

แสดงผลการพยากรณ์รายวันสูงสุด 10 วันในสถานที่ที่กำหนด โดยเริ่มตั้งแต่วันปัจจุบัน

คำขอ HTTP

GET https://weather.googleapis.com/v1/forecast/days:lookup

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

พารามิเตอร์การค้นหา

พารามิเตอร์
location

object (LatLng)

ต้องระบุ ตำแหน่งที่จะรับพยากรณ์อากาศรายวัน
unitsSystem

enum (UnitsSystem)

ไม่บังคับ ระบบหน่วยที่จะใช้สำหรับสภาพอากาศที่แสดง หากไม่ได้ระบุ ระบบจะแสดงสภาพอากาศที่ส่งคืนในระบบเมตริก (ค่าเริ่มต้น = METRIC)
pageSize

integer

ไม่บังคับ จำนวนสูงสุดของบันทึกการพยากรณ์รายวันที่แสดงต่อหน้า ซึ่งมีค่าตั้งแต่ 1 ถึง 10 (รวม) ค่าเริ่มต้นคือ 5
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากคำขอก่อนหน้า ใช้เพื่อดึงข้อมูลหน้าถัดไป
days

integer

ไม่บังคับ จำกัดจำนวนวันทั้งหมดที่จะดึงข้อมูลโดยเริ่มจากวันปัจจุบัน ซึ่งมีค่าตั้งแต่ 1 ถึง 10 (รวม) ค่าเริ่มต้นคือค่าสูงสุดที่อนุญาต ซึ่งเท่ากับ 10
languageCode

string

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

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

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

การตอบกลับสำหรับ RPC days.lookup

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

การแสดง JSON 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
ช่อง
forecastDays[]

object (ForecastDay)

บันทึกการคาดการณ์รายวันตามจำนวนวันและขนาดหน้าเว็บที่ระบุในคำขอ
timeZone

object (TimeZone)

เขตเวลาในตำแหน่งที่ขอ
nextPageToken

string

โทเค็นเพื่อดึงข้อมูลหน้าถัดไป

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

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

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

ForecastDay

แสดงระเบียนการพยากรณ์รายวันในสถานที่ที่ระบุ

การแสดง JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  }
}
ช่อง
interval

object (Interval)

ช่วงเวลา UTC เมื่อวันที่พยากรณ์นี้เริ่มต้น (รวม) และสิ้นสุด (ไม่รวม) หมายเหตุ: วันหนึ่งๆ จะเริ่มเวลา 07:00 น. และสิ้นสุดเวลา 07:00 น. ของวันถัดไปตามเวลาท้องถิ่น เช่น หากเขตเวลาท้องถิ่นคือ UTC-7 ช่วงเวลาจะเริ่มที่เวลา 14:00:00.000Z และสิ้นสุดในเวลาเดียวกันของวันถัดไป
displayDate

object (Date)

วันที่ท้องถิ่นในเขตเวลาของสถานที่ตั้ง (เวลาพลเรือน) ที่ใช้คำนวณการพยากรณ์รายวันนี้ ระบบอาจใช้ช่องนี้เพื่อการแสดงผลในไคลเอ็นต์
daytimeForecast

object (ForecastDayPart)

สภาพอากาศที่คาดการณ์ในช่วงกลางวัน (07:00 น. ถึง 19:00 น. ตามเวลาท้องถิ่น)
nighttimeForecast

object (ForecastDayPart)

สภาพอากาศที่พยากรณ์ไว้สำหรับช่วงกลางคืนของวัน (19:00 น. ถึง 07:00 น. ของวันถัดไป ตามเวลาท้องถิ่น)
maxTemperature

object (Temperature)

อุณหภูมิสูงสุดตลอดทั้งวัน
minTemperature

object (Temperature)

อุณหภูมิต่ำสุดตลอดทั้งวัน
feelsLikeMaxTemperature

object (Temperature)

อุณหภูมิสูงสุด (สูง) ที่รู้สึกได้ตลอดทั้งวัน
feelsLikeMinTemperature

object (Temperature)

อุณหภูมิที่รู้สึกต่ำสุด (ต่ำ) ตลอดทั้งวัน
maxHeatIndex

object (Temperature)

อุณหภูมิดัชนีความร้อนสูงสุดตลอดทั้งวัน
sunEvents

object (SunEvents)

เหตุการณ์ที่เกี่ยวข้องกับดวงอาทิตย์ (เช่น พระอาทิตย์ขึ้น พระอาทิตย์ตก)
moonEvents

object (MoonEvents)

เหตุการณ์ที่เกี่ยวข้องกับดวงจันทร์ (เช่น ขึ้นและตก)

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลาจะระบุไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่สัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจแสดงถึงสิ่งใดสิ่งหนึ่งต่อไปนี้

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ที่ไม่ใช่ 0
  • เดือนและวัน โดยมีปีเป็น 0 (เช่น วันครบรอบ)
  • ปีอย่างเดียว โดยมีเดือนและวันที่เป็น 0
  • ปีและเดือน โดยมีวันที่เป็น 0 (เช่น วันหมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

เดือนของปี ต้องมีค่าระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่ไม่มีวัน

ForecastDayPart

แสดงระเบียนการคาดการณ์สำหรับช่วงเวลาหนึ่งของวัน

การแสดง JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
ช่อง
interval

object (Interval)

วันที่และเวลา UTC เมื่อช่วงเวลานี้ของวันเริ่มต้น (รวม) และสิ้นสุด (ไม่รวม) หมายเหตุ: ช่วงเวลาหนึ่งของวันจะเริ่มเวลา 07:00 น. และสิ้นสุดเวลา 19:00 น. ของวันเดียวกันตามเวลาท้องถิ่น ตัวอย่างเช่น หากเขตเวลาท้องถิ่นคือ UTC-7 ช่วงเวลากลางวันจะเริ่มเวลา 14:00:00.000Z และสิ้นสุดเวลา 02:00:00.000Z ในวันถัดไป ส่วนช่วงเวลากลางคืนจะเริ่มเวลา 02:00:00.000Z ในวันถัดไปและสิ้นสุดเวลา 14:00:00.000Z ในวันเดียวกัน
weatherCondition

object (WeatherCondition)

สภาพอากาศที่คาดการณ์
precipitation

object (Precipitation)

ปริมาณน้ำฝนที่คาดการณ์
wind

object (Wind)

ทิศทางลมโดยเฉลี่ย ความเร็วสูงสุด และลมกระโชก
iceThickness

object (IceThickness)

ปริมาณน้ำแข็งสะสมในช่วงเวลาหนึ่งของวัน
relativeHumidity

integer

เปอร์เซ็นต์ความชื้นสัมพัทธ์ที่คาดการณ์ (ค่าตั้งแต่ 0 ถึง 100)
uvIndex

integer

ดัชนีรังสีอัลตราไวโอเลต (UV) ที่พยากรณ์สูงสุด
thunderstormProbability

integer

ความน่าจะเป็นของพายุฝนฟ้าคะนองโดยเฉลี่ย
cloudCover

integer

เปอร์เซ็นต์เมฆปกคลุมโดยเฉลี่ย

SunEvents

แสดงเหตุการณ์ที่เกี่ยวข้องกับดวงอาทิตย์ (เช่น พระอาทิตย์ขึ้น พระอาทิตย์ตก)

การแสดง JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
ช่อง
sunriseTime

string (Timestamp format)

เวลาที่พระอาทิตย์ขึ้น

หมายเหตุ: ในบางกรณีที่พิเศษ (เช่น ทางเหนือของอาร์กติกเซอร์เคิล) อาจไม่มีเวลาพระอาทิตย์ขึ้นในวันนั้น ในกรณีเหล่านี้ ระบบจะไม่ตั้งค่าช่องนี้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
sunsetTime

string (Timestamp format)

เวลาที่พระอาทิตย์ตก

หมายเหตุ: ในบางกรณีที่พิเศษ (เช่น ทางเหนือของอาร์กติกเซอร์เคิล) อาจไม่มีเวลาตกของดวงอาทิตย์ในวันนั้น ในกรณีเหล่านี้ ระบบจะไม่ตั้งค่าช่องนี้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

MoonEvents

แสดงเหตุการณ์ที่เกี่ยวข้องกับดวงจันทร์ (เช่น ขึ้นและตก)

การแสดง JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
ช่อง
moonriseTimes[]

string (Timestamp format)

เวลาที่แขนบนของดวงจันทร์ปรากฏเหนือขอบฟ้า (ดู https://en.wikipedia.org/wiki/Moonrise_and_moonset)

หมายเหตุ: ในกรณีส่วนใหญ่ จะมีเวลาขึ้นของดวงจันทร์เพียงครั้งเดียวต่อวัน ในกรณีอื่นๆ รายการอาจว่างเปล่า (เช่น เมื่อดวงจันทร์ขึ้นหลังเที่ยงคืนของวันถัดไป) อย่างไรก็ตาม ในกรณีพิเศษ (เช่น ในเขตขั้วโลก) รายการอาจมีค่ามากกว่า 1 ค่า ในกรณีเหล่านี้ ระบบจะจัดเรียงค่าจากน้อยไปมาก

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
moonsetTimes[]

string (Timestamp format)

เวลาที่แขนบนของดวงจันทร์ลับหายไปใต้เส้นขอบฟ้า (ดู https://en.wikipedia.org/wiki/Moonrise_and_moonset)

หมายเหตุ: ในกรณีส่วนใหญ่ จะมีเวลาดวงจันทร์ตกเพียงครั้งเดียวต่อวัน ในกรณีอื่นๆ รายการอาจว่างเปล่า (เช่น เมื่อดวงจันทร์ตกหลังเที่ยงคืนของวันถัดไป) อย่างไรก็ตาม ในกรณีพิเศษ (เช่น ในเขตขั้วโลก) รายการอาจมีค่ามากกว่า 1 ค่า ในกรณีเหล่านี้ ระบบจะจัดเรียงค่าจากน้อยไปมาก

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
moonPhase

enum (MoonPhase)

ข้างขึ้นข้างแรมของดวงจันทร์

MoonPhase

ระบุข้างขึ้นข้างแรมของดวงจันทร์ (หรือที่เรียกว่าข้างขึ้นข้างแรม)

Enum
MOON_PHASE_UNSPECIFIED ข้างขึ้นข้างแรมที่ไม่ได้ระบุ
NEW_MOON ดวงจันทร์ไม่ได้ส่องสว่างด้วยแสงอาทิตย์
WAXING_CRESCENT ดวงจันทร์สว่าง 0%-50% ทางด้านขวาในซีกโลกเหนือ 🌒 และทางด้านซ้ายในซีกโลกใต้ 🌘
FIRST_QUARTER ดวงจันทร์สว่าง 50.1% ทางด้านขวาในซีกโลกเหนือ 🌓 และทางด้านซ้ายในซีกโลกใต้ 🌗
WAXING_GIBBOUS ดวงจันทร์สว่าง 50%-100% ทางด้านขวาในซีกโลกเหนือ 🌔 และทางด้านซ้ายในซีกโลกใต้ 🌖
FULL_MOON ดวงจันทร์สว่างเต็มดวง
WANING_GIBBOUS ดวงจันทร์สว่าง 50%-100% ทางด้านซ้ายในซีกโลกเหนือ 🌖 และทางด้านขวาในซีกโลกใต้ 🌔
LAST_QUARTER ดวงจันทร์สว่าง 50.1% ทางด้านซ้ายในซีกโลกเหนือ 🌗 และทางด้านขวาในซีกโลกใต้ 🌓
WANING_CRESCENT ดวงจันทร์สว่าง 0%-50% ทางด้านซ้ายในซีกโลกเหนือ 🌘 และทางด้านขวาในซีกโลกใต้ 🌒