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

ไม่บังคับ จำกัดจำนวนชั่วโมงทั้งหมดที่จะดึงข้อมูลโดยเริ่มจากชั่วโมงสุดท้าย ซึ่งมีค่าตั้งแต่ 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)

ความน่าจะเป็นของปริมาณน้ำฝนในอดีตและปริมาณน้ำฝนที่สะสมในช่วงชั่วโมงที่ผ่านมา
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)