Method: currentConditions.lookup

Trả về tình trạng thời tiết hiện tại tại một vị trí nhất định.

Yêu cầu HTTP

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

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

Tham số truy vấn

Thông số
location

object (LatLng)

Bắt buộc. Vị trí để lấy thông tin về tình hình thời tiết hiện tại.
unitsSystem

enum (UnitsSystem)

Không bắt buộc. Hệ thống đơn vị đo dùng cho các đ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ẽ ở hệ thống đo lường (mặc định = METRIC).
languageCode

string

Không bắt buộc. Cho phép ứng dụng chọn ngôn ngữ cho câu trả lời. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó, API sẽ sử dụng ngôn ngữ phù hợp nhất. Các giá trị được phép dựa trên tiêu chuẩn IETF BCP-47. Giá trị mặc định là "en".

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho RPC currentConditions.lookup – biểu thị tình hình thời tiết hiện tại tại vị trí được yêu cầu.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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
}
Trường
currentTime

string (Timestamp format)

Giờ hiện tại (theo giờ UTC) liên kết với dữ liệu được trả về.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
timeZone

object (TimeZone)

Múi giờ tại vị trí được yêu cầu.
weatherCondition

object (WeatherCondition)

Tình hình thời tiết hiện tại.
temperature

object (Temperature)

Nhiệt độ hiện tại.
feelsLikeTemperature

object (Temperature)

Đo lường nhiệt độ hiện tại theo cảm nhận tại vị trí được yêu cầu.
dewPoint

object (Temperature)

Nhiệt độ điểm sương hiện tại.
heatIndex

object (Temperature)

Nhiệt độ chỉ số nóng bức hiện tại.
windChill

object (Temperature)

Độ lạnh do gió hiện tại, nhiệt độ không khí tiếp xúc với da.
precipitation

object (Precipitation)

Xác suất mưa hiện tại và lượng mưa tích luỹ trong 1 giờ qua.
airPressure

object (AirPressure)

Tình trạng áp suất khí quyển hiện tại.
wind

object (Wind)

Tình hình gió hiện tại.
visibility

object (Visibility)

Chế độ hiển thị hiện tại.
currentConditionsHistory

object (CurrentConditionsHistory)

Những thay đổi về điều kiện hiện tại trong 24 giờ qua.
isDaytime

boolean

True nếu thời gian hiện tại tại vị trí được yêu cầu nằm trong khoảng thời gian từ lúc bình minh (bao gồm) đến lúc hoàng hôn (không bao gồm) tại địa phương. Nếu không, đó là ban đêm (giữa thời điểm mặt trời lặn và thời điểm mặt trời mọc tiếp theo).
relativeHumidity

integer

Tỷ lệ phần trăm độ ẩm tương đối hiện tại (giá trị từ 0 đến 100).
uvIndex

integer

Chỉ số tia cực tím (UV) hiện tại.
thunderstormProbability

integer

Xác suất xảy ra giông bão hiện tại (giá trị từ 0 đến 100).
cloudCover

integer

Tỷ lệ phần trăm hiện tại của bầu trời bị mây che phủ (giá trị từ 0 đến 100).

Phạm vi uỷ quyền

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

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

CurrentConditionsHistory

Biểu thị một loạt thay đổi về điều kiện hiện tại trong 24 giờ qua.

Biểu diễn dưới dạng JSON 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Trường
temperatureChange

object (Temperature)

Nhiệt độ hiện tại trừ đi nhiệt độ cách đây 24 giờ.
maxTemperature

object (Temperature)

Nhiệt độ tối đa (cao) trong 24 giờ qua.
minTemperature

object (Temperature)

Nhiệt độ tối thiểu (thấp) trong 24 giờ qua.
snowQpf

object (QuantitativePrecipitationForecast)

Lượng tuyết tích tụ trong 24 giờ qua, được đo bằng lượng nước tương đương. Lưu ý: QPF là từ viết tắt của Dự báo lượng mưa (vui lòng xem định nghĩa QuantitativePrecipitationForecast để biết thêm thông tin).
qpf

object (QuantitativePrecipitationForecast)

Lượng mưa tích luỹ trong 24 giờ qua, được đo bằng lượng nước tương đương. Lưu ý: QPF là từ viết tắt của Dự báo lượng mưa (vui lòng xem định nghĩa QuantitativePrecipitationForecast để biết thêm thông tin).