Method: lookupWeather

ค้นหาสภาพอากาศในสถานที่หนึ่งๆ

คำขอ HTTP

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

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

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

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

การแสดง JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
ฟิลด์
unitsSystem

enum (UnitsSystem)

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

object (Location)

ต้องระบุ สถานที่ตั้งที่ต้องการดูสภาพอากาศ
capabilities[]

enum (Capability)

ไม่บังคับ ความสามารถด้านสภาพแวดล้อมที่จะรวมไว้ในการตอบกลับ
date

object (Date)

ไม่บังคับ ระบุวันที่ของข้อมูลด้านสิ่งแวดล้อมที่ขอ โดยอิงตามเขตเวลาท้องถิ่นของสถานที่ที่ระบุในช่อง location ช่วงวันที่ที่รองรับจะขึ้นอยู่กับความสามารถที่ขอ: - WEATHER: สูงสุด 24 ชั่วโมงในอดีต (เมื่อตั้งค่า hour ไว้ด้วย) และสูงสุด 10 วัน (240 ชั่วโมง) ในอนาคต (วันนี้ถึง +9 วันสำหรับการคาดการณ์รายวัน) - AIR_QUALITY: สูงสุด 30 วัน (720 ชั่วโมง) ในอดีต และสูงสุด 4 วัน (96 ชั่วโมง) ในอนาคต - POLLEN: วันนี้ถึงอีก 4 วันข้างหน้า (สูงสุด 5 วันรวมวันนี้ ไม่รองรับวันที่ในอดีต)
hour

integer

ไม่บังคับ ระบุชั่วโมงของข้อมูลด้านสิ่งแวดล้อมที่ขอในรูปแบบ 24 ชั่วโมง (0-23) โดยสัมพันธ์กับเขตเวลาท้องถิ่นของสถานที่ที่ระบุในช่อง location ต้องระบุ date ช่วงเวลาที่รองรับจะขึ้นอยู่กับความสามารถที่ขอ: - WEATHER: สูงสุด 24 ชั่วโมงในอดีตและสูงสุด 240 ชั่วโมง (10 วัน) ในอนาคต - AIR_QUALITY: สูงสุด 30 วัน (720 ชั่วโมง) ในอดีต และสูงสุด 4 วัน (96 ชั่วโมง) ในอนาคต - POLLEN: แสดงเฉพาะการคาดการณ์รายวัน ระบบจะไม่สนใจ hour สำหรับละอองเกสร
languageCode

string

ไม่บังคับ รหัสภาษา BCP-47 สำหรับข้อความที่แปลแล้วในการตอบกลับ (เช่น "en", "ja", "fr-CA") ค่าเริ่มต้นจะเป็น "en" หากไม่ได้ระบุไว้
weatherOptions

object (WeatherOptions)

ไม่บังคับ ตัวเลือกที่เฉพาะเจาะจงสำหรับคำขอสภาพอากาศ ระบบรองรับ weatherOptions.units_system ควบคู่ไปกับ unitsSystem ระดับบนสุด (แท็ก 4) เพื่อรักษาความเข้ากันได้แบบย้อนหลังสำหรับผู้โทรที่มีอยู่ โดยจะแสดงผลเป็น INVALID_ARGUMENT หากทั้ง 2 ระบุระบบหน่วยที่ขัดแย้งกัน ระบบจะไม่สนใจหากไม่ได้ขอ WEATHER ใน capabilities
airQualityOptions

object (AirQualityOptions)

ไม่บังคับ ตัวเลือกเฉพาะสำหรับคำขอคุณภาพอากาศ ระบบจะไม่สนใจหากไม่ได้ขอ AIR_QUALITY ใน capabilities

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

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ LookupWeatherResponse

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

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

  • https://www.googleapis.com/auth/maps-platform.mapstools