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)

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

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

object (QuantitativePrecipitationForecast)

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