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, thông tin dự báo hằng giờ và 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à dữ liệu thời tiết được yêu cầu sẽ đượ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 tra cứu 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ụ: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. Mã địa điểm (place_id)

    • Một giá trị nhận dạng duy nhất ở dạng chuỗi (Mã địa điểm trên Google Maps).
    • Bạn có thể tìm nạp place_id từ công cụ search_places.
    • Ví dụ: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Tháp Eiffel

  3. Chuỗi địa chỉ (address)

    • Một chuỗi tuỳ ý cần có 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, Vương quốc Anh" chứ không phải "London").
    • Đị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").
    • Ví dụ: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Các chế độ sử dụng:

  • Thời tiết hiện tại: Chỉ cung cấp location. Không chỉ định date và hour.

  • Dự báo hằng giờ: Cung cấp location, 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 các cụm từ như "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ợ thông tin dự báo hằng giờ sau 120 giờ kể từ thời điểm hiện tại. Dữ liệu thời tiết hằng giờ trong quá khứ được hỗ trợ tối đa 24 giờ.

  • Dự báo hằng ngày: Cung cấp location và date. Không chỉ định hour. 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 vào thứ Sáu", "thời tiết vào ngày 25/12"). Nếu ngày hôm nay không có trong bối cảnh, bạn nên làm rõ với người dùng. Chúng tôi không hỗ trợ thông tin dự báo hằng ngày cho hơn 10 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 các tiêu chuẩn của Hoa Kỳ hoặc yêu cầu rõ ràng.

  • Đầu ra có cơ sở phải được quy cho nguồn bằng cách sử dụng thông tin từ trường attribution (nếu có).

Mã mẫu sau đây cho biết 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 MCP tool 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 trạng thời tiết tại vị trí được yêu cầu.

LookupWeatherRequest

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

  // Union field _date can be only one of the following:
  "date": {
    object (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
unitsSystem

enum (UnitsSystem)

Không bắt buộc. Hệ thống đơn vị đo để sử 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, các điều kiện thời tiết được trả về sẽ ở hệ đ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 (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 khoảng thời gian từ 24 giờ trước đến 10 ngày tiếp theo.

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í. Chúng tôi không hỗ trợ thông tin dự báo hằng giờ sau 120 giờ kể từ thời điểm hiện tại. Dữ liệu thời tiết hằng giờ trong quá khứ được hỗ trợ tối đa 24 giờ.

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. Phải từ 1 đến 9999 hoặc 0 để chỉ định một ngày không có năm.
month

integer

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

integer

Ngày trong tháng. Phải từ 1 đến 31 và hợp lệ cho năm và tháng, hoặc từ 0 để chỉ định một năm riêng lẻ hoặc một năm và tháng mà ngày không có ý nghĩa.

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 (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 (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 mã địa chỉ. Hãy xem 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].

UnitsSystem

Biểu thị hệ thống đơn vị được dùng để đo lường các giá trị.

Enum
UNITS_SYSTEM_UNSPECIFIED Chưa xác định hệ thống đơn vị.
IMPERIAL Hệ thống đơn vị đo lường Anh (ví dụ: độ F, dặm, v.v.).
METRIC Hệ thống đơn vị đo lường theo hệ mét (ví dụ: độ C, kilômét, v.v.).

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.

Câu trả lời này thể hiện cả thông tin theo giờ và theo ngày, do đó, câu trả lời được chia thành 3 phần: Theo giờ, Theo ngày và Thông tin chung. 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)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // 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)

Điều kiện gió
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í đó 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í tương đối (ví dụ: "Mountain View, California").
attribution

object (Attribution)

Thông tin bắt buộc về nguồn trích dẫn để hiển thị cùng với thông tin thời tiết.

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ông khí hằng 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 giác 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 giác 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ố nhiệt tối đa trong suốt cả 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ố 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 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 theo giờ UTC kể từ thời gian bắt đầu của hệ thống Unix (00:00:00 ngày 1 tháng 1 năm 1970 theo giờ UTC). Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với khoảng thời gian từ 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. Các giá trị giây âm có phân số vẫn phải có cá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 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 các 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 (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 (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, được đo bằng lượng nước lỏng tương đương, tích tụ 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 QuantitativePrecipitationForecast để biết thêm thông tin chi tiết).
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 định lượng) (vui lòng xem định nghĩa QuantitativePrecipitationForecast để biết thêm thông tin chi tiết).

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 tụ 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ó tính bằng độ (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 (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 (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 mã địa chỉ. Hãy xem 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].

Phân bổ

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

string

Tiêu đề sẽ hiển thị cho thông tin ghi nhận quyền tác giả.
url

string

URL để liên kết cho việc phân bổ.

TemperatureUnit

Biểu thị một đơn vị dùng để đo nhiệt độ.

Enum
TEMPERATURE_UNIT_UNSPECIFIED Đơn vị nhiệt độ chưa được chỉ định.
CELSIUS Nhiệt độ được đo bằng độ C.
FAHRENHEIT Nhiệt độ được đo bằng độ F.

MoonPhase

Đánh dấu chu kỳ mặt trăng (còn gọi là pha mặt trăng).

Enum
MOON_PHASE_UNSPECIFIED Chu kỳ mặt trăng không xác định.
NEW_MOON Mặt trăng không được mặt trời chiếu sáng.
WAXING_CRESCENT Mặt trăng được chiếu sáng từ 0% đến 50% ở bên phải tại bán cầu bắc 🌒 và ở bên trái tại bán cầu nam 🌘.
FIRST_QUARTER Mặt trăng được chiếu sáng 50,1% ở bên phải tại bán cầu bắc 🌓 và ở bên trái tại bán cầu nam 🌗.
WAXING_GIBBOUS Mặt trăng được chiếu sáng từ 50% đến 100% ở phía bên phải tại bán cầu bắc 🌔 và ở phía bên trái tại bán cầu nam 🌖.
FULL_MOON Mặt trăng được chiếu sáng hoàn toàn.
WANING_GIBBOUS Mặt trăng được chiếu sáng từ 50% đến 100% ở phía bên trái tại bán cầu bắc 🌖 và ở phía bên phải tại bán cầu nam 🌔.
LAST_QUARTER Mặt trăng được chiếu sáng 50,1% ở bên trái tại bán cầu bắc 🌗 và ở bên phải tại bán cầu nam 🌓.
WANING_CRESCENT Mặt trăng được chiếu sáng từ 0% đến 50% ở bên trái tại bán cầu bắc 🌘 và ở bên phải tại bán cầu nam 🌒.

Loại

Đánh dấu loại điều kiện thời tiết trong bối cảnh của một phần tử dự báo.

Enum
TYPE_UNSPECIFIED Điều kiện thời tiết không được chỉ định.
CLEAR Không có mây.
MOSTLY_CLEAR Thỉnh thoảng có mây.
PARTLY_CLOUDY Có mây rải rác (có một số đám mây).
MOSTLY_CLOUDY Nhiều mây (nhiều mây hơn nắng).
CLOUDY Có mây (tất cả các loại mây, không có nắng).
WINDY Gió mạnh.
WIND_AND_RAIN Gió mạnh kèm theo mưa.
LIGHT_RAIN_SHOWERS Mưa nhẹ rải rác từng cơn.
CHANCE_OF_SHOWERS Có thể có mưa rải rác.
SCATTERED_SHOWERS Mưa gián đoạn.
RAIN_SHOWERS Mưa rào được coi là lượng mưa có thời gian ngắn hơn mưa, đặc trưng là thời gian bắt đầu và dừng đột ngột, cũng như cường độ thay đổi nhanh chóng.
HEAVY_RAIN_SHOWERS Mưa rào lớn.
LIGHT_TO_MODERATE_RAIN Mưa (lượng mưa từ nhỏ đến vừa).
MODERATE_TO_HEAVY_RAIN Mưa (lượng mưa từ vừa đến lớn).
RAIN Mưa vừa.
LIGHT_RAIN Mưa nhỏ.
HEAVY_RAIN Mưa to.
RAIN_PERIODICALLY_HEAVY Có mưa, thỉnh thoảng mưa to.
LIGHT_SNOW_SHOWERS Tuyết rơi nhẹ với cường độ thay đổi trong thời gian ngắn.
CHANCE_OF_SNOW_SHOWERS Có thể có mưa tuyết.
SCATTERED_SNOW_SHOWERS Tuyết rơi với cường độ khác nhau trong thời gian ngắn.
SNOW_SHOWERS Mưa tuyết.
HEAVY_SNOW_SHOWERS Mưa tuyết lớn.
LIGHT_TO_MODERATE_SNOW Tuyết rơi nhẹ đến vừa.
MODERATE_TO_HEAVY_SNOW Tuyết rơi vừa đến nhiều.
SNOW Tuyết rơi vừa phải.
LIGHT_SNOW Tuyết rơi nhẹ.
HEAVY_SNOW Tuyết rơi dày.
SNOWSTORM Tuyết rơi kèm sấm sét (có thể).
SNOW_PERIODICALLY_HEAVY Có tuyết, thỉnh thoảng tuyết rơi nhiều.
HEAVY_SNOW_STORM Tuyết rơi dày kèm theo sấm sét.
BLOWING_SNOW Tuyết rơi kèm gió mạnh.
RAIN_AND_SNOW Vừa có mưa vừa có tuyết.
HAIL Mưa đá.
HAIL_SHOWERS Mưa đá rơi với cường độ khác nhau trong thời gian ngắn.
THUNDERSTORM Mưa giông.
THUNDERSHOWER Mưa rào kèm sấm chớp.
LIGHT_THUNDERSTORM_RAIN Mưa bão nhỏ có sấm sét.
SCATTERED_THUNDERSTORMS Bão có mưa với nhiều cường độ khác nhau trong thời gian ngắn.
HEAVY_THUNDERSTORM Dông bão lớn.

PrecipitationType

Biểu thị loại hình lượng mưa tại một vị trí cụ thể.

Enum
PRECIPITATION_TYPE_UNSPECIFIED Loại lượng mưa chưa được chỉ định.
NONE Không có mưa.
SNOW Tuyết rơi.
RAIN Lượng mưa.
LIGHT_RAIN Mưa nhỏ.
HEAVY_RAIN Mưa lớn.
RAIN_AND_SNOW Cả mưa và tuyết.
SLEET Mưa tuyết.
FREEZING_RAIN Mưa băng giá.

Đơn vị

Biểu thị đơn vị dùng để đo lượng mưa tích luỹ.

Enum
UNIT_UNSPECIFIED Đơn vị đo lượng mưa không xác định.
MILLIMETERS Lượng mưa được đo bằng milimet.
INCHES Lượng mưa được đo bằng inch.

CardinalDirection

Biểu thị một hướng chính (bao gồm cả hướng thứ tự).

Enum
CARDINAL_DIRECTION_UNSPECIFIED Hướng la bàn chưa được chỉ định.
NORTH Hướng bắc.
NORTH_NORTHEAST Hướng Đông Bắc phụ.
NORTHEAST Hướng Đông Bắc.
EAST_NORTHEAST Hướng Đông Đông Bắc.
EAST Hướng đông.
EAST_SOUTHEAST Hướng đông đông nam.
SOUTHEAST Hướng Đông Nam.
SOUTH_SOUTHEAST Hướng phụ nam-đông nam.
SOUTH Hướng Nam.
SOUTH_SOUTHWEST Hướng phụ tây nam.
SOUTHWEST Hướng Tây Nam.
WEST_SOUTHWEST Hướng tây nam phụ.
WEST Hướng tây.
WEST_NORTHWEST Hướng phụ Tây Tây Bắc.
NORTHWEST Hướng Tây Bắc.
NORTH_NORTHWEST Hướng phụ tây bắc.

SpeedUnit

Biểu thị đơn vị dùng để đo tốc độ.

Enum
SPEED_UNIT_UNSPECIFIED Chưa xác định đơn vị tốc độ.
KILOMETERS_PER_HOUR Tốc độ được đo bằng ki-lô-mét mỗi giờ.
MILES_PER_HOUR Tốc độ được đo bằng dặm trên giờ.

Chú thích bằng công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng chúng có thể được dùng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không ảnh hưởng gì thêm đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

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