- คำขอ HTTP
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- CurrentConditionsHistory
แสดงสภาพอากาศปัจจุบัน ณ ตำแหน่งที่ระบุ
คำขอ HTTP
GET https://weather.googleapis.com/v1/currentConditions:lookup
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์การค้นหา
| พารามิเตอร์ | |
|---|---|
| location | 
 ต้องระบุ ตำแหน่งที่จะดูสภาพอากาศปัจจุบัน | 
| units | 
 ไม่บังคับ ระบบหน่วยที่จะใช้สำหรับสภาพอากาศที่แสดง หากไม่ได้ระบุ ระบบจะแสดงสภาพอากาศที่แสดงผลเป็นระบบเมตริก (ค่าเริ่มต้น = METRIC) | 
| language | 
 ไม่บังคับ อนุญาตให้ลูกค้าเลือกภาษาของคำตอบ หากไม่สามารถระบุข้อมูลสําหรับภาษานั้นได้ API จะใช้ข้อมูลที่ใกล้เคียงที่สุด ค่าที่อนุญาตจะอิงตามมาตรฐาน IETF BCP-47 ค่าเริ่มต้นคือ "en" | 
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
การตอบสนองสําหรับ currentConditions.lookup RPC - แสดงสภาพอากาศปัจจุบัน ณ ตําแหน่งที่ตั้งขอ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON | 
|---|
| { "currentTime": string, "timeZone": { object ( | 
| ช่อง | |
|---|---|
| current | 
 เวลาปัจจุบัน (UTC) ที่เชื่อมโยงกับข้อมูลที่แสดง ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น  | 
| time | 
 เขตเวลาของสถานที่ที่ขอ | 
| weather | 
 สภาพอากาศปัจจุบัน | 
| temperature | 
 อุณหภูมิปัจจุบัน | 
| feels | 
 การวัดว่าอุณหภูมิที่สถานที่ที่ขอนั้นรู้สึกอย่างไร | 
| dew | 
 อุณหภูมิจุดน้ำค้างปัจจุบัน | 
| heat | 
 อุณหภูมิดัชนีความร้อนปัจจุบัน | 
| wind | 
 ความเย็นจากลมปัจจุบัน ซึ่งเป็นอุณหภูมิของอากาศที่สัมผัสกับผิวหนัง | 
| precipitation | 
 ความน่าจะเป็นที่จะมีฝนตกในปัจจุบันและปริมาณน้ำฝนที่สะสมในช่วง 1 ชั่วโมงที่ผ่านมา | 
| air | 
 สภาพความกดอากาศปัจจุบัน | 
| wind | 
 สภาพลมปัจจุบัน | 
| visibility | 
 ระดับการเข้าถึงปัจจุบัน | 
| current | 
 การเปลี่ยนแปลงของสภาพอากาศปัจจุบันในช่วง 24 ชั่วโมงที่ผ่านมา | 
| is | 
 จริงหากเวลาปัจจุบัน ณ สถานที่ที่ขออยู่ในช่วงระหว่างเวลาพระอาทิตย์ขึ้น (รวม) กับพระอาทิตย์ตก (ไม่รวม) ในพื้นที่ ไม่เช่นนั้น แสดงว่าเป็นเวลากลางคืน (ระหว่างพระอาทิตย์ตกและพระอาทิตย์ขึ้นครั้งถัดไป) | 
| relative | 
 เปอร์เซ็นต์ความชื้นสัมพัทธ์ปัจจุบัน (ค่าตั้งแต่ 0 ถึง 100) | 
| uv | 
 ดัชนีรังสีอัลตราไวโอเลต (UV) ปัจจุบัน | 
| thunderstorm | 
 ความน่าจะเป็นที่จะมีพายุฟ้าคะนองในปัจจุบัน (ค่าตั้งแต่ 0 ถึง 100) | 
| cloud | 
 เปอร์เซ็นต์ปัจจุบันของท้องฟ้าที่มีเมฆปกคลุม (ค่าตั้งแต่ 0 ถึง 100) | 
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
- https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
แสดงชุดการเปลี่ยนแปลงของสภาพอากาศปัจจุบันในช่วง 24 ชั่วโมงที่ผ่านมา
| การแสดง JSON | 
|---|
| { "temperatureChange": { object ( | 
| ช่อง | |
|---|---|
| temperature | 
 อุณหภูมิปัจจุบันลบด้วยอุณหภูมิเมื่อ 24 ชั่วโมงที่ผ่านมา | 
| max | 
 อุณหภูมิสูงสุด (สูง) ในช่วง 24 ชั่วโมงที่ผ่านมา | 
| min | 
 อุณหภูมิต่ำสุด (ต่ำ) ในช่วง 24 ชั่วโมงที่ผ่านมา | 
| qpf | 
 ปริมาณน้ำฝน (ฝนหรือหิมะ) ที่วัดเป็นปริมาณน้ำเทียบเท่าของเหลวซึ่งสะสมในช่วง 24 ชั่วโมงที่ผ่านมา หมายเหตุ: QPF เป็นตัวย่อของ Quantitative Precipitation Forecast (โปรดดูรายละเอียดเพิ่มเติมที่คำจำกัดความของ QuantitativePrecipitationForecast) |