Method: forecast.hours.lookup

แสดงผลการพยากรณ์รายชั่วโมงสูงสุด 240 ชั่วโมง ณ สถานที่ที่ระบุ โดยเริ่มจากชั่วโมงปัจจุบัน

คำขอ HTTP

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

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

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

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

object (LatLng)

ต้องระบุ สถานที่ที่จะรับพยากรณ์รายชั่วโมง
unitsSystem

enum (UnitsSystem)

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

integer

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

string

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

integer

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

string

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

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

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

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

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

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

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

object (ForecastHour)

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

object (TimeZone)

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

string

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

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

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

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

ForecastHour

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

การแสดง JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
ช่อง
interval

object (Interval)

ช่วงเวลา 1 ชั่วโมง (ในเวลา UTC) ที่ข้อมูลการพยากรณ์นี้ใช้ได้ (การประทับเวลาจะปัดเศษลงเป็นชั่วโมงที่ใกล้ที่สุด)
displayDateTime

object (DateTime)

วันที่และเวลาท้องถิ่นในเขตเวลาของสถานที่ตั้ง (เวลาพลเรือน) ที่ใช้คำนวณพยากรณ์รายชั่วโมงนี้ ระบบอาจใช้ช่องนี้เพื่อการแสดงผลในไคลเอ็นต์ หมายเหตุ: วันที่นี้จะประกอบด้วยปี เดือน วัน ชั่วโมง และออฟเซ็ตจาก UTC
weatherCondition

object (WeatherCondition)

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

object (Temperature)

อุณหภูมิที่คาดการณ์
feelsLikeTemperature

object (Temperature)

การวัดว่าอุณหภูมิที่ตำแหน่งที่ขอจะรู้สึกเป็นอย่างไร
dewPoint

object (Temperature)

อุณหภูมิจุดน้ำค้างที่คาดการณ์
heatIndex

object (Temperature)

อุณหภูมิดัชนีความร้อนที่คาดการณ์
windChill

object (Temperature)

อุณหภูมิที่คาดการณ์ซึ่งทำให้รู้สึกหนาวเย็น อุณหภูมิอากาศที่สัมผัสผิวหนัง
wetBulbTemperature

object (Temperature)

อุณหภูมิกระเปาะเปียกที่พยากรณ์ไว้ ซึ่งเป็นอุณหภูมิต่ำสุดที่ทำได้โดยการระเหยน้ำ
precipitation

object (Precipitation)

ความน่าจะเป็นที่ฝนจะตกและปริมาณน้ำฝนที่สะสมในช่วงชั่วโมงที่ผ่านมา
airPressure

object (AirPressure)

สภาวะความกดอากาศที่คาดการณ์
wind

object (Wind)

สภาพลมที่คาดการณ์
visibility

object (Visibility)

ระดับการมองเห็นที่คาดการณ์
iceThickness

object (IceThickness)

ความหนาของน้ำแข็งที่คาดการณ์
isDaytime

boolean

เป็นจริงหากชั่วโมงนี้อยู่ระหว่างเวลาพระอาทิตย์ขึ้น (รวม) และพระอาทิตย์ตก (ไม่รวม) ในพื้นที่ ไม่เช่นนั้นจะเป็นเวลากลางคืน (ระหว่างพระอาทิตย์ตกและพระอาทิตย์ขึ้นครั้งถัดไป) หมายเหตุ: ระบบจะพิจารณาว่าชั่วโมงนี้เป็นช่วงกลางวันหรือกลางคืนหากช่วงเวลาดังกล่าวทับซ้อนกับเวลาพระอาทิตย์ขึ้นและตกตามเวลาท้องถิ่นตามลำดับ (เช่น หากช่วงเวลาคือ 05:00 น.ถึง 06:00 น. และพระอาทิตย์ขึ้นเวลา 05:59 น. แสดงว่า isDaytime จะเป็นจริง)
relativeHumidity

integer

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

integer

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

integer

ความน่าจะเป็นที่จะเกิดพายุฝนฟ้าคะนองที่คาดการณ์ไว้ (ค่าตั้งแต่ 0 ถึง 100)
cloudCover

integer

เปอร์เซ็นต์ที่คาดการณ์ของท้องฟ้าที่ปกคลุมด้วยเมฆ (ค่าตั้งแต่ 0 ถึง 100)