Method: history.hours.lookup

แสดงข้อมูลสภาพอากาศรายชั่วโมงที่ผ่านมาสูงสุด 24 ชั่วโมง ณ ตำแหน่งหนึ่งๆ โดยเริ่มจากชั่วโมงล่าสุด

คำขอ HTTP

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

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

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

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

object (LatLng)

ต้องระบุ สถานที่ที่จะรับข้อมูลย้อนหลังรายชั่วโมง

unitsSystem

enum (UnitsSystem)

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

pageSize

integer

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

pageToken

string

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

hours

integer

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

languageCode

string

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

เนื้อหาของคำขอ

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

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

การตอบสนองสําหรับ RPC hours.lookup

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

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

object (HistoryHour)

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

timeZone

object (TimeZone)

เขตเวลาของสถานที่ที่ขอ

nextPageToken

string

โทเค็นสําหรับดึงข้อมูลหน้าถัดไป

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

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

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

HistoryHour

แสดงบันทึกประวัติรายชั่วโมง ณ สถานที่หนึ่งๆ

การแสดง 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)