Method: currentConditions.lookup

Trả về tình hình thời tiết hiện 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

Tham 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ị dùng cho điều kiện thời tiết được trả về. Nếu bạn không cung cấp, thì điều kiện thời tiết được trả về sẽ theo hệ mét (mặc định = METRIC).
languageCode

string

Không bắt buộc. Cho phép ứng dụng chọn ngôn ngữ cho phản hồ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 cho 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 – thể hiện điều kiện 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)

Thời gian hiện tại (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 trạng thời tiết hiện tại.
temperature

object (Temperature)

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

object (Temperature)

Chỉ số đo lường nhiệt độ hiệ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 độ hiện tại theo chỉ số nóng bức.
windChill

object (Temperature)

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

Lưu ý: Trường này trả về một đối tượng trống cho các vị trí ở Nhật Bản và Hàn Quốc.
precipitation

object (Precipitation)

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

object (AirPressure)

Tình trạng áp suất không khí 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.

Lưu ý: Trường này trả về một đối tượng trống cho các vị trí ở Nhật Bản và Hàn Quốc.
currentConditionsHistory

object (CurrentConditionsHistory)

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

boolean

Đúng 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 mặt trời mọc (bao gồm) đến lúc mặt trời lặn (không bao gồm) tại địa phương. Nếu không, thì đó là ban đêm (giữa lúc hoàng hôn và bình minh 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 có giông bão hiện tại (giá trị từ 0 đến 100).

Lưu ý: Trường này bị bỏ qua trong phản hồi cho các vị trí ở Nhật Bản và Hàn Quốc.
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).

Lưu ý: Trường này bị bỏ qua trong phản hồi cho các vị trí ở Nhật Bản và Hàn Quốc.

Phạm vi uỷ quyền

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

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

CurrentConditionsHistory

Đại diện cho một tập hợp các thay đổi trong đ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ủa 24 giờ trước.
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 dự kiến sẽ rơi trong một khoảng thời gian, giả sử không có tuyết tan hoặc tuyết nén. Lưu ý: Đây là lượng tuyết thực tế, không phải lượng nước tương đương. QPF là từ viết tắt của Quantitative Precipitation Forecast (Dự báo lượng mưa định lượng) (vui lòng xem định nghĩa về QuantitativePrecipitationForecast để biết thêm thông tin chi tiết).
qpf

object (QuantitativePrecipitationForecast)

Tổng lượng nước tương đương của tất cả các loại mưa (mưa, tuyết, băng, v.v.) được dự báo sẽ rơi trong một khoảng thời gian. Lưu ý: QPF là từ viết tắt của Quantitative Precipitation Forecast (Dự báo lượng mưa định lượng) (vui lòng xem định nghĩa về QuantitativePrecipitationForecast để biết thêm thông tin chi tiết).