MCP Tools Reference: mapstools.googleapis.com

Công cụ: lookup_weather

Truy xuất dữ liệu thời tiết toàn diện, bao gồm tình hình thời tiết hiện tại, dự báo theo giờ và dự báo hằng ngày. Dữ liệu cụ thể có sẵn: Nhiệt độ (Hiện tại, Cảm giác như, Tối đa/Tối thiểu, Chỉ số nhiệt), Gió (Tốc độ, Gió giật, Hướng), Sự kiện thiên văn (Mặt trời mọc/Mặt trời lặn, Pha mặt trăng), Lượng mưa (Loại, Xác suất, Số lượng/QPF), Điều kiện khí quyển (Chỉ số UV, Độ ẩm, Lượng mây che phủ, Xác suất có giông bão) và Địa chỉ vị trí được mã hoá địa lý. Vị trí và quy tắc về vị trí (QUAN TRỌNG): Vị trí mà bạn yêu cầu dữ liệu thời tiết được chỉ định bằng trường "location". Trường này là một cấu trúc "oneof", nghĩa là bạn PHẢI cung cấp giá trị cho CHỈ MỘT trong 3 trường phụ vị trí bên dưới để đảm bảo tìm kiếm dữ liệu thời tiết chính xác. 1. Toạ độ địa lý (lat_lng) * Sử dụng khi bạn được cung cấp toạ độ vĩ độ/kinh độ chính xác. * Ví dụ: "lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles 2. Mã địa điểm (place_id) * Giá trị nhận dạng chuỗi không mơ hồ (Mã địa điểm trên Google Maps). * Bạn có thể tìm nạp place_id bằng công cụ search_places. * Ví dụ: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Tháp Eiffel 3. Chuỗi địa chỉ (address) * Một chuỗi dạng tự do yêu cầu tính cụ thể để mã hoá địa lý. * Thành phố và khu vực: Luôn thêm khu vực/quốc gia (ví dụ: "London, UK" (Luân Đôn, Vương quốc Anh), không phải "London" (Luân Đôn). * Địa chỉ đường phố: Cung cấp địa chỉ đầy đủ (ví dụ: "1600 Pennsylvania Ave NW, Washington, DC"). * Mã bưu chính: PHẢI đi kèm với tên quốc gia (ví dụ: "90210, Hoa Kỳ", KHÔNG phải "90210"). Chế độ sử dụng: 1. Thời tiết hiện tại: Chỉ cung cấp address. Không chỉ định date và hour. 2. Dự báo hằng giờ: Cung cấp address, date và hour (0-23). Sử dụng cho các thời điểm cụ thể (ví dụ: "lúc 5 giờ chiều") hoặc những cụm từ như "trong vài giờ tới" hoặc "hôm nay muộn hơn". Nếu người dùng chỉ định phút, hãy làm tròn xuống giờ gần nhất. Chúng tôi không hỗ trợ dự báo hằng giờ cho khoảng thời gian dài hơn 48 giờ kể từ thời điểm hiện tại. 3. Dự báo hằng ngày: Cung cấp address và date. Không chỉ định hour. Sử dụng cho các yêu cầu chung về ngày (ví dụ: "thời tiết ngày mai", "thời tiết thứ Sáu", "thời tiết ngày 25/12"). Nếu ngày hôm nay không có trong ngữ cảnh, bạn nên làm rõ với người dùng. Chúng tôi không hỗ trợ dự báo hằng ngày cho thời gian dài hơn 7 ngày (kể cả hôm nay). Không hỗ trợ thông tin thời tiết trong quá khứ. Các ràng buộc về tham số: * Múi giờ: Tất cả các giá trị đầu vào date và hour phải tương ứng với múi giờ địa phương của vị trí, chứ không phải múi giờ của người dùng. * Định dạng ngày: Bạn phải tách các giá trị đầu vào thành {year, month, day} số nguyên. * Đơn vị: Mặc định là METRIC. Đặt units_system thành IMPERIAL cho độ Fahrenheit/dặm nếu người dùng ngụ ý sử dụng tiêu chuẩn của Hoa Kỳ hoặc yêu cầu rõ ràng.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ lookup_weather MCP.

Yêu cầu Curl 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Yêu cầu đối với phương thức LookupWeather – biểu thị tình hình thời tiết tại vị trí được yêu cầu.

LookupWeatherRequest

Biểu diễn dưới dạng JSON 
{
  "DEPRECATEDAddress": string,
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },

  // Union field _date can be only one of the following:
  "date": {
    object (google.type.Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.
}
Trường
DEPRECATEDAddress
(deprecated)

string

KHÔNG DÙNG NỮA: Thay vào đó, hãy sử dụng vị trí.
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).
location

object (Location)

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

Trường nhóm _date.

_date chỉ có thể là một trong những trạng thái sau:
date

object (google.type.Date)

Không bắt buộc. Ngày có thông tin thời tiết bắt buộc. Lưu ý: Ngày này tương ứng với múi giờ địa phương của vị trí được chỉ định trong trường vị trí. Ngày phải nằm trong vòng 7 ngày tới.

Trường nhóm _hour.

_hour chỉ có thể là một trong những trạng thái sau:
hour

integer

Không bắt buộc. Giờ của thông tin thời tiết được yêu cầu, ở định dạng 24 giờ (0-23). Giá trị này tương ứng với múi giờ địa phương của vị trí được chỉ định trong trường vị trí. Thông tin dự báo theo giờ chỉ được hỗ trợ trong 48 giờ tiếp theo kể từ thời điểm hiện tại.

Ngày

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 để chỉ định một năm hoặc một năm và tháng, trong đó ngày là không quan trọng.

Thông tin vị trí

Biểu diễn dưới dạng JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Trường
Trường nhóm location_type. Các cách thể hiện vị trí. location_type chỉ có thể là một trong những trạng thái sau:
latLng

object (google.type.LatLng)

Một điểm được chỉ định bằng toạ độ địa lý.
placeId

string

Mã địa điểm được liên kết với vị trí .
address

string

Địa chỉ mà con người đọc được hoặc plus code. Hãy truy cập https://plus.codes để biết thông tin chi tiết.

LatLng

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

Giản đồ đầu ra

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

Phản hồi này thể hiện cả thông tin theo giờ và theo ngày, do đó, phản hồi được chia thành 3 phần: Theo giờ, Theo ngày và Được chia sẻ. Các trường Chỉ theo giờ, Chỉ theo ngày được đánh dấu là không bắt buộc. Đối với các trường được chia sẻ giữa thông tin hằng giờ và hằng ngày, một số trường luôn xuất hiện nên không được đánh dấu là không bắt buộc, trong khi các trường còn lại được đánh dấu là không bắt buộc vì không phải lúc nào cũng có sẵn.

LookupWeatherResponse

Biểu diễn dưới dạng JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "DEPRECATEDGeocodedAddress": string,
  "returnedLocation": {
    object (Location)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
Trường
weatherCondition

object (WeatherCondition)

Điều kiện thời tiết
precipitation

object (Precipitation)

Xác suất có mưa và lượng mưa tích luỹ
wind

object (Wind)

Tình hình gió
DEPRECATEDGeocodedAddress
(deprecated)

string

KHÔNG DÙNG NỮA: Thay vào đó, hãy sử dụng returned_location.
returnedLocation

object (Location)

Bắt buộc. Vị trí mà thông tin thời tiết được trả về. Vị trí này giống với vị trí trong yêu cầu, nhưng có thể khác với vị trí trong yêu cầu nếu vị trí được yêu cầu là một địa chỉ văn bản tự do tra cứu đến một vị trí thô (ví dụ: "Mountain View, California").

Trường nhóm _temperature.

_temperature chỉ có thể là một trong những trạng thái sau:
temperature

object (Temperature)

Nhiệt độ theo giờ

Trường nhóm _feels_like_temperature.

_feels_like_temperature chỉ có thể là một trong những trạng thái sau:
feelsLikeTemperature

object (Temperature)

Chỉ số đo theo giờ về nhiệt độ cảm nhận.

Trường nhóm _heat_index.

_heat_index chỉ có thể là một trong những trạng thái sau:
heatIndex

object (Temperature)

Nhiệt độ chỉ số nóng bức theo giờ.

Trường nhóm _air_pressure.

_air_pressure chỉ có thể là một trong những trạng thái sau:
airPressure

object (AirPressure)

Tình trạng áp suất khí quyển theo giờ.

Trường nhóm _max_temperature.

_max_temperature chỉ có thể là một trong những trạng thái sau:
maxTemperature

object (Temperature)

Nhiệt độ tối đa (cao) trong suốt cả ngày.

Trường nhóm _min_temperature.

_min_temperature chỉ có thể là một trong những trạng thái sau:
minTemperature

object (Temperature)

Nhiệt độ tối thiểu (thấp) trong suốt cả ngày.

Trường nhóm _feels_like_max_temperature.

_feels_like_max_temperature chỉ có thể là một trong những trạng thái sau:
feelsLikeMaxTemperature

object (Temperature)

Nhiệt độ cảm nhận tối đa (cao) trong suốt cả ngày.

Trường nhóm _feels_like_min_temperature.

_feels_like_min_temperature chỉ có thể là một trong những trạng thái sau:
feelsLikeMinTemperature

object (Temperature)

Nhiệt độ cảm nhận tối thiểu (thấp) trong suốt cả ngày.

Trường nhóm _max_heat_index.

_max_heat_index chỉ có thể là một trong những trạng thái sau:
maxHeatIndex

object (Temperature)

Nhiệt độ chỉ số nóng bức tối đa trong ngày.

Trường nhóm _sun_events.

_sun_events chỉ có thể là một trong những trạng thái sau:
sunEvents

object (SunEvents)

Các sự kiện liên quan đến mặt trời (ví dụ: bình minh, hoàng hôn).

Trường nhóm _moon_events.

_moon_events chỉ có thể là một trong những trạng thái sau:
moonEvents

object (MoonEvents)

Các sự kiện liên quan đến mặt trăng (ví dụ: trăng mọc, trăng lặn).

Trường nhóm _relative_humidity.

_relative_humidity chỉ có thể là một trong những trạng thái sau:
relativeHumidity

integer

Tỷ lệ phần trăm độ ẩm tương đối (giá trị từ 0 đến 100). xác định là không bắt buộc vì không phải lúc nào cũng có sẵn

Trường nhóm _uv_index.

_uv_index chỉ có thể là một trong những trạng thái sau:
uvIndex

integer

Chỉ số tia cực tím (UV) tối đa. xác định không bắt buộc vì không phải lúc nào cũng có sẵn

Trường nhóm _thunderstorm_probability.

_thunderstorm_probability chỉ có thể là một trong những trạng thái sau:
thunderstormProbability

integer

Xác suất có giông bão (giá trị từ 0 đến 100). xác định là không bắt buộc vì không phải lúc nào cũng có sẵn

Trường nhóm _cloud_cover.

_cloud_cover chỉ có thể là một trong những trạng thái sau:
cloudCover

integer

Tỷ lệ phần trăm bầu trời bị mây che phủ (giá trị từ 0 đến 100). xác định không bắt buộc vì không phải lúc nào cũng có sẵn

Nhiệt độ

Biểu diễn dưới dạng JSON 
{
  "unit": enum (TemperatureUnit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Trường
unit

enum (TemperatureUnit)

Mã của đơn vị dùng để đo giá trị nhiệt độ.

Trường nhóm _degrees.

_degrees chỉ có thể là một trong những trạng thái sau:
degrees

number

Giá trị nhiệt độ (theo độ) trong đơn vị được chỉ định.

AirPressure

Biểu diễn dưới dạng JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
Trường

Trường nhóm _mean_sea_level_millibars.

_mean_sea_level_millibars chỉ có thể là một trong những trạng thái sau:
meanSeaLevelMillibars

number

Áp suất không khí trung bình ở mực nước biển tính bằng milibar.

SunEvents

Biểu diễn dưới dạng JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Trường
sunriseTime

string (Timestamp format)

Thời điểm mặt trời mọc.

LƯU Ý: Trong một số trường hợp đặc biệt (ví dụ: ở phía bắc vòng Bắc Cực), có thể không có thời gian mặt trời mọc trong một ngày. Trong những trường hợp này, trường này sẽ không được đặt.

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".
sunsetTime

string (Timestamp format)

Thời điểm mặt trời lặn.

LƯU Ý: Trong một số trường hợp đặc biệt (ví dụ: phía bắc vòng Bắc Cực), có thể không có thời gian mặt trời lặn trong một ngày. Trong những trường hợp này, trường này sẽ không được đặt.

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".

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây của thời gian UTC kể từ thời gian bắt đầu của hệ thống Unix 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

MoonEvents

Biểu diễn dưới dạng JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Trường
moonriseTimes[]

string (Timestamp format)

Thời điểm phần trên của mặt trăng xuất hiện phía trên đường chân trời (xem https://en.wikipedia.org/wiki/Moonrise_and_moonset).

LƯU Ý: Trong hầu hết các trường hợp, mỗi ngày sẽ có một thời điểm mặt trăng mọc. Trong các trường hợp khác, danh sách có thể trống (ví dụ: khi mặt trăng mọc sau nửa đêm ngày tiếp theo). Tuy nhiên, trong những trường hợp đặc biệt (ví dụ: ở các vùng cực), danh sách này có thể chứa nhiều giá trị. Trong những trường hợp này, các giá trị được sắp xếp theo thứ tự tăng dần.

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".
moonsetTimes[]

string (Timestamp format)

Thời điểm phần trên của mặt trăng khuất dưới đường chân trời (xem https://en.wikipedia.org/wiki/Moonrise_and_moonset).

LƯU Ý: Trong hầu hết các trường hợp, mỗi ngày sẽ có một thời điểm mặt trăng lặn. Trong những trường hợp khác, danh sách này có thể trống (ví dụ: khi mặt trăng lặn sau nửa đêm ngày tiếp theo). Tuy nhiên, trong những trường hợp đặc biệt (ví dụ: ở các vùng cực), danh sách này có thể chứa nhiều giá trị. Trong những trường hợp này, các giá trị được sắp xếp theo thứ tự tăng dần.

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".
moonPhase

enum (MoonPhase)

Chu kỳ mặt trăng (còn gọi là pha mặt trăng).

WeatherCondition

Biểu diễn dưới dạng JSON 
{
  "iconBaseUri": string,
  "description": {
    object (google.type.LocalizedText)
  },
  "type": enum (Type)
}
Trường
iconBaseUri

string

URI cơ sở cho biểu tượng không bao gồm đuôi loại tệp. Để hiển thị biểu tượng, hãy thêm một giao diện (nếu muốn) và phần mở rộng loại tệp (.png hoặc .svg) vào URI này. Theo mặc định, biểu tượng có giao diện sáng, nhưng bạn có thể thêm _dark cho chế độ tối. Ví dụ: "https://maps.gstatic.com/weather/v1/dust.svg" hoặc "https://maps.gstatic.com/weather/v1/dust_dark.svg", trong đó icon_base_uri là "https://maps.gstatic.com/weather/v1/dust".
description

object (google.type.LocalizedText)

Nội dung mô tả bằng văn bản cho điều kiện thời tiết này (đã bản địa hoá).
type

enum (Type)

Loại điều kiện thời tiết.

LocalizedText

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "languageCode": string
}
Trường
text

string

Chuỗi được bản địa hoá bằng ngôn ngữ tương ứng với google.type.LocalizedText.language_code bên dưới.
languageCode

string

Mã ngôn ngữ BCP-47 của văn bản, chẳng hạn như "en-US" hoặc "sr-Latn".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Lượng mưa

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

object (PrecipitationProbability)

Xác suất có mưa (giá trị từ 0 đến 100).
snowQpf

object (QuantitativePrecipitationForecast)

Lượng tuyết tích tụ trong một khoảng thời gian, đượ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 tụ trong một khoảng thời gian, được đo bằng lượng nước tương đương. Lưu ý: QPF là từ viết tắt của Quantitative Precipitation Forecast (Dự báo lượng mưa) (vui lòng xem định nghĩa QuantitativePrecipitationForecast để biết thêm thông tin).

PrecipitationProbability

Biểu diễn dưới dạng JSON 
{
  "type": enum (PrecipitationType),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Trường
type

enum (PrecipitationType)

Mã cho biết loại hình thái thời tiết.

Trường nhóm _percent.

_percent chỉ có thể là một trong những trạng thái sau:
percent

integer

Tỷ lệ phần trăm từ 0 đến 100 cho biết khả năng có mưa.

QuantitativePrecipitationForecast

Biểu diễn dưới dạng JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
Trường
unit

enum (Unit)

Mã của đơn vị dùng để đo lượng mưa tích luỹ.

Trường nhóm _quantity.

_quantity chỉ có thể là một trong những trạng thái sau:
quantity

number

Lượng mưa tích luỹ trong một khoảng thời gian, được đo bằng lượng nước tương đương.

Gió

Biểu diễn dưới dạng JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Trường
direction

object (WindDirection)

Hướng gió, góc mà gió thổi đến.
speed

object (WindSpeed)

Tốc độ gió.
gust

object (WindSpeed)

Gió giật (tốc độ gió tăng đột ngột).

WindDirection

Biểu diễn dưới dạng JSON 
{
  "cardinal": enum (CardinalDirection),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Trường
cardinal

enum (CardinalDirection)

Mã đại diện cho hướng gió thổi theo hướng chính.

Trường nhóm _degrees.

_degrees chỉ có thể là một trong những trạng thái sau:
degrees

integer

Hướng gió theo độ (giá trị từ 0 đến 360).

WindSpeed

Biểu diễn dưới dạng JSON 
{
  "unit": enum (SpeedUnit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Trường
unit

enum (SpeedUnit)

Mã đại diện cho đơn vị dùng để đo tốc độ gió.

Trường nhóm _value.

_value chỉ có thể là một trong những trạng thái sau:
value

number

Giá trị của tốc độ gió.

Thông tin vị trí

Biểu diễn dưới dạng JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Trường
Trường nhóm location_type. Các cách thể hiện vị trí. location_type chỉ có thể là một trong những trạng thái sau:
latLng

object (google.type.LatLng)

Một điểm được chỉ định bằng toạ độ địa lý.
placeId

string

Mã địa điểm được liên kết với vị trí .
address

string

Địa chỉ mà con người đọc được hoặc plus code. Hãy truy cập https://plus.codes để biết thông tin chi tiết.

LatLng

Biểu diễn dưới dạng JSON 
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
longitude

number

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

Chú giải công cụ

Gợi ý phá huỷ: ❌ | Gợi ý không thay đổi giá trị: ❌ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌