Method: lookupWeather

Tìm thông tin về tình hình thời tiết tại một địa điểm.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Trường
unitsSystem

enum (UnitsSystem)

Không bắt buộc. Hệ thống đơn vị dùng cho điều kiện thời tiết được trả về. Nếu bạn không cung cấp, điều kiện thời tiết được trả về sẽ theo hệ mét (mặc định = METRIC).
location

object (Location)

Bắt buộc. Vị trí để lấy thông tin về điều kiện thời tiết.
capabilities[]

enum (Capability)

Không bắt buộc. Các chức năng môi trường cần đưa vào phản hồi.
date

object (Date)

Không bắt buộc. Chỉ định ngày của thông tin môi trường được yêu cầu, tương ứng với múi giờ địa phương của vị trí được chỉ định trong trường location. Phạm vi ngày được hỗ trợ phụ thuộc vào các chức năng được yêu cầu: – WEATHER: tối đa 24 giờ trong quá khứ (khi hour cũng được đặt) và tối đa 10 ngày (240 giờ) trong tương lai (hôm nay đến +9 ngày đối với thông tin dự báo hằng ngày). – AIR_QUALITY: tối đa 30 ngày (720 giờ) trong quá khứ và tối đa 4 ngày (96 giờ) trong tương lai. – POLLEN: từ hôm nay đến 4 ngày sau (tối đa 5 ngày, bao gồm cả hôm nay; không hỗ trợ ngày trong quá khứ).
hour

integer

Không bắt buộc. Chỉ định giờ của thông tin môi trường được yêu cầu, ở định dạng 24 giờ (0-23), tương ứng với múi giờ địa phương của vị trí được chỉ định trong trường location. Bạn phải chỉ định date. Phạm vi giờ được hỗ trợ phụ thuộc vào các chức năng được yêu cầu: – WEATHER: tối đa 24 giờ trong quá khứ và tối đa 240 giờ (10 ngày) trong tương lai. – AIR_QUALITY: tối đa 30 ngày (720 giờ) trong quá khứ và tối đa 4 ngày (96 giờ) trong tương lai. – POLLEN: chỉ trả về thông tin dự báo hằng ngày; hour bị bỏ qua đối với phấn hoa.
languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47 cho văn bản đã bản địa hoá trong phản hồi (ví dụ: "en", "ja", "fr-CA"). Giá trị mặc định là "en" nếu không được chỉ định.
weatherOptions

object (WeatherOptions)

Không bắt buộc. Các lựa chọn dành riêng cho yêu cầu về thời tiết. weatherOptions.units_system được hỗ trợ cùng với unitsSystem cấp cao nhất (thẻ 4) để duy trì khả năng tương thích ngược cho phương thức gọi hiện có; trả về INVALID_ARGUMENT nếu cả hai đều chỉ định hệ thống đơn vị xung đột. Bị bỏ qua nếu WEATHER không được yêu cầu trong capabilities.
airQualityOptions

object (AirQualityOptions)

Không bắt buộc. Các lựa chọn dành riêng cho yêu cầu về chất lượng không khí. Bị bỏ qua nếu AIR_QUALITY không được yêu cầu trong capabilities.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của LookupWeatherResponse.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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