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)

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

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)