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)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
ช่อง
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)

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

object (IceThickness)

ปริมาณน้ำแข็งสะสมตลอดทั้งวัน

วันที่

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

  • วันที่แบบเต็มซึ่งมีค่าปี เดือน และวันที่ที่ไม่ใช่ 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)
  },
  "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)

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

integer

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

integer

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

integer

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

integer

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

SunEvents

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

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

string (Timestamp format)

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

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

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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-normalized เสมอ และใช้ตัวเลขทศนิยม 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% ทางด้านซ้ายในซีกโลกเหนือ 🌘 และทางด้านขวาในซีกโลกใต้ 🌒