Method: currentConditions.lookup

แสดงสภาพอากาศปัจจุบันในตำแหน่งที่ระบุ

คำขอ HTTP

GET https://weather.googleapis.com/v1/currentConditions:lookup

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

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

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

object (LatLng)

ต้องระบุ ตำแหน่งที่จะดูสภาพอากาศปัจจุบัน
unitsSystem

enum (UnitsSystem)

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

string

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

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

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

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

การตอบกลับสำหรับ RPC ของ currentConditions.lookup - แสดงสภาพอากาศปัจจุบัน ณ สถานที่ตั้งที่ขอ

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

การแสดง JSON 
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
ช่อง
currentTime

string (Timestamp format)

เวลาปัจจุบัน (UTC) ที่เชื่อมโยงกับข้อมูลที่แสดงผล

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
timeZone

object (TimeZone)

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

object (WeatherCondition)

สภาพอากาศปัจจุบัน
temperature

object (Temperature)

อุณหภูมิปัจจุบัน
feelsLikeTemperature

object (Temperature)

การวัดอุณหภูมิที่รู้สึกได้ในปัจจุบัน ณ สถานที่ที่ขอ
dewPoint

object (Temperature)

อุณหภูมิจุดน้ำค้างปัจจุบัน
heatIndex

object (Temperature)

อุณหภูมิดัชนีความร้อนปัจจุบัน
windChill

object (Temperature)

ความหนาวเย็นของลมในปัจจุบัน อุณหภูมิอากาศที่สัมผัสกับผิวหนัง

หมายเหตุ: ช่องนี้จะแสดงออบเจ็กต์ว่างสำหรับสถานที่ตั้งในญี่ปุ่นและเกาหลีใต้
precipitation

object (Precipitation)

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

object (AirPressure)

สภาพความกดอากาศปัจจุบัน
wind

object (Wind)

สภาพลมปัจจุบัน
visibility

object (Visibility)

ระดับการเข้าถึงปัจจุบัน

หมายเหตุ: ช่องนี้จะแสดงออบเจ็กต์ว่างสำหรับสถานที่ตั้งในญี่ปุ่นและเกาหลีใต้
currentConditionsHistory

object (CurrentConditionsHistory)

การเปลี่ยนแปลงของสภาพอากาศปัจจุบันในช่วง 24 ชั่วโมงที่ผ่านมา
isDaytime

boolean

เป็นจริงหากเวลาปัจจุบันในสถานที่ที่ขออยู่ระหว่างเวลาพระอาทิตย์ขึ้น (รวม) และพระอาทิตย์ตก (ไม่รวม) ในท้องถิ่น ไม่เช่นนั้นจะเป็นเวลากลางคืน (ระหว่างพระอาทิตย์ตกถึงพระอาทิตย์ขึ้นครั้งถัดไป)
relativeHumidity

integer

เปอร์เซ็นต์ปัจจุบันของความชื้นสัมพัทธ์ (ค่าตั้งแต่ 0 ถึง 100)
uvIndex

integer

ดัชนีรังสีอัลตราไวโอเลต (UV) ปัจจุบัน
thunderstormProbability

integer

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

หมายเหตุ: ระบบจะละเว้นช่องนี้จากการตอบกลับสำหรับสถานที่ตั้งในญี่ปุ่นและเกาหลีใต้
cloudCover

integer

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

หมายเหตุ: ระบบจะละเว้นช่องนี้จากการตอบกลับสำหรับสถานที่ตั้งในญี่ปุ่นและเกาหลีใต้

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

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

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

CurrentConditionsHistory

แสดงชุดการเปลี่ยนแปลงในสภาวะปัจจุบันในช่วง 24 ชั่วโมงที่ผ่านมา

การแสดง JSON 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
ช่อง
temperatureChange

object (Temperature)

อุณหภูมิปัจจุบันลบด้วยอุณหภูมิเมื่อ 24 ชั่วโมงที่ผ่านมา
maxTemperature

object (Temperature)

อุณหภูมิสูงสุดในช่วง 24 ชั่วโมงที่ผ่านมา
minTemperature

object (Temperature)

อุณหภูมิต่ำสุด (ต่ำ) ในช่วง 24 ชั่วโมงที่ผ่านมา
snowQpf

object (QuantitativePrecipitationForecast)

ปริมาณหิมะที่คาดว่าจะตกในช่วงระยะเวลาหนึ่ง โดยสมมติว่าไม่มีการละลายหรือการอัดตัว หมายเหตุ: ปริมาณนี้คือปริมาณหิมะจริง ไม่ใช่ปริมาณน้ำที่เทียบเท่า QPF เป็นตัวย่อของ Quantitative Precipitation Forecast (ดูรายละเอียดเพิ่มเติมได้ที่คำจำกัดความของ QuantitativePrecipitationForecast)
qpf

object (QuantitativePrecipitationForecast)

ปริมาณน้ำเทียบเท่าของเหลวทั้งหมดของน้ำฟ้า (ฝน หิมะ น้ำแข็ง ฯลฯ) ที่คาดการณ์ว่าจะตกลงมาในช่วงระยะเวลาหนึ่ง หมายเหตุ: QPF เป็นตัวย่อของ Quantitative Precipitation Forecast (โปรดดูรายละเอียดเพิ่มเติมในคำจำกัดความของ QuantitativePrecipitationForecast)