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 cả tình hình hiện tại, thông tin dự báo hằng giờ và hằng ngày.

Dữ liệu cụ thể được cung cấp: Nhiệt độ (Hiện tại, Nhiệt độ cảm nhận, Nhiệt độ 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 (Bình minh/Hoàng hôn, Pha Mặt Trăng), Lượng mưa (Loại, Xác suất, Lượng mưa/QPF), Điều kiện khí quyển (Chỉ số UV, Độ ẩm, Độ che phủ của mây, 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 CHỈ ĐƯỢC cung cấp giá trị cho MỘT TRONG ba trường phụ về 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)

    • Giá trị nhận dạng chuỗi rõ ràng (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 dạng tuỳ ý cần có thông tin cụ thể để mã hoá địa lý.
    • Thành phố và khu vực: Luôn bao gồm khu vực/quốc gia (ví dụ: "London, Vương quốc Anh", 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/Mã ZIP: 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"}}

Chế độ sử dụng:

  • Thời tiết hiện tại: Chỉ cung cấp location. Đừ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 "cuối ngày hôm nay". Nếu người dùng chỉ định phút, hãy làm tròn xuống giờ gần nhất. Không hỗ trợ dự báo theo giờ sau 120 giờ kể từ bây giờ. Dữ liệu thời tiết hằng giờ trong quá khứ được hỗ trợ trong tối đa 24 giờ trước.

  • Dự báo hằng ngày: Cung cấp location và date. Đừ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 thứ Sáu", "thời tiết 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õ ngày hôm nay với người dùng. Không hỗ trợ thông tin dự báo hằng ngày sau 10 ngày kể từ hôm nay. Không hỗ trợ dữ liệu thời tiết trong quá khứ.

Các quy tắc ràng buộc về tham số:

  • Múi giờ: Tất cả thông tin đầu vào date và hour phải liên quan đến 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: Các giá trị nhập phải được phân tách thành {year, month, day} số nguyên.
  • Đơn vị: Mặc định là METRIC. Đặt units_system thành IMPERIAL cho Fahrenheit/Miles nếu người dùng ngụ ý các tiêu chuẩn của Hoa Kỳ hoặc yêu cầu rõ ràng.

  • Kết quả có căn cứ phải được ghi nhận cho nguồn bằng cách sử dụng thông tin trong 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ụ MCP lookup_weather.

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 cho phương thức LookupWeather – thể hiện 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 
{
  "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ị 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).
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ủa thông tin thời tiết cần thiết. 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 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, theo đị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í. Không hỗ trợ dự báo theo giờ sau 120 giờ kể từ bây giờ. Dữ liệu thời tiết hằng giờ trong quá khứ được hỗ trợ trong tối đa 24 giờ trước.

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 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 0 để chỉ định một năm hoặc một năm và tháng mà ngày 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 (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 khác nhau để biểu thị một 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 liên kết với vị trí .
address

string

Địa chỉ mà con người có thể đọc được hoặc mã cộng. 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ệ đơn vị dùng để đo lường các giá trị.

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

Giản đồ đầu ra

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

Câu trả lời này đại diện cho cả thông tin hằng giờ và hằng ngày, do đó, câu trả lời được chia thành ba phần: Hằng giờ, Hằng 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)
  },
  "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 tụ
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 hệt với vị trí trong yêu cầu, nhưng có thể khác nếu vị trí được yêu cầu là một địa chỉ văn bản tự do tra cứu vị trí tương đối (ví dụ: "Mountain View, CA").
attribution

object (Attribution)

Thông tin ghi nhận tác giả bắt buộc phải 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)

Nhiệt độ cảm nhận được theo giờ.

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 độ theo chỉ số nóng bức hằng 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)

Điều kiện á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 nhất) trong 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 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 độ tối đa theo chỉ số nhiệt 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 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ó

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ó

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). define optional because it is not always available

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 hoàng hôn trong 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 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 thời lượng, chứ không phải là giá trị thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano không âm, được tính theo 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 rìa 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 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 hôm sau). Tuy nhiên, trong một số 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 trăng lặn. Trong các trường hợp khác, danh sách có thể trống (ví dụ: khi mặt trăng lặn sau nửa đêm ngày hôm sau). Tuy nhiên, trong một số 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)

Tuần trăng (hay 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à đuôi 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 tình trạng 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 đã 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 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 về QuantitativePrecipitationForecast để biết thêm thông tin chi tiết).
qpf

object (QuantitativePrecipitationForecast)

Lượng mưa, được đo bằng lượng nước 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 về 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 mưa.

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 tụ.

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, được đo bằng lượng nước tương đương, tích tụ trong một khoảng thời gian.

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 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 chính mà gió thổi.

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 khác nhau để biểu thị một 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 liên kết với vị trí .
address

string

Địa chỉ mà con người có thể đọc được hoặc mã cộng. 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 tác giả.
url

string

URL để liên kết đến thông tin ghi nhận tác giả.

TemperatureUnit

Đại diện cho 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 tuần trăng (hay 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% ở phía bên phải ở Bắc bán cầu 🌒 và ở phía bên trái ở Nam bán cầu 🌘.
FIRST_QUARTER Mặt trăng được chiếu sáng 50,1% ở phía bên phải ở Bắc bán cầu 🌓 và ở phía bên trái ở Nam bán cầu 🌗.
WAXING_GIBBOUS Mặt trăng được chiếu sáng từ 50% đến 100% ở phía bên phải ở Bắc bán cầu 🌔 và ở phía bên trái ở Nam bán cầu 🌖.
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 ở Bắc bán cầu 🌖 và ở phía bên phải ở Nam bán cầu 🌔.
LAST_QUARTER Mặt trăng được chiếu sáng 50,1% ở phía bên trái ở Bắc bán cầu 🌗 và ở phía bên phải ở Nam bán cầu 🌓.
WANING_CRESCENT Mặt trăng được chiếu sáng từ 0% đến 50% ở phía bên trái ở Bắc bán cầu 🌘 và ở phía bên phải ở Nam bán cầu 🌒.

Loại

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

Enum
TYPE_UNSPECIFIED Điều kiện thời tiết không xác đị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 (một vài đám mây).
MOSTLY_CLOUDY Nhiều mây (mây nhiều hơn nắng).
CLOUDY Có mây (toàn mây, không có mặt trời).
WINDY Gió mạnh.
WIND_AND_RAIN Gió mạnh kèm mưa.
LIGHT_RAIN_SHOWERS Mưa nhỏ ngắt quãng.
CHANCE_OF_SHOWERS Có thể có mưa gián đoạn.
SCATTERED_SHOWERS Mưa gián đoạn.
RAIN_SHOWERS Mưa rào được coi là mưa có thời gian ngắn hơn mưa thường, có đặc điểm là thời gian bắt đầu và kết thúc đột ngột, đồng thời 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 nhỏ đến vừa).
MODERATE_TO_HEAVY_RAIN Mưa (lượng mưa 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 độ khác nhau 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.
LIGHT_SNOW Tuyết rơi nhẹ.
HEAVY_SNOW Tuyết rơi nhiều.
SNOWSTORM Có tuyết, có thể có sấm sét.
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, có thể có sấm sét.
BLOWING_SNOW Tuyết và gió mạnh.
RAIN_AND_SNOW Mưa lẫn tuyết.
HAIL Mưa đá.
HAIL_SHOWERS Mưa đá rơi với cường độ khác nhau trong khoảng 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 Giông 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 mạnh.

PrecipitationType

Biểu thị loại mưa tại một vị trí nhất định.

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

Đơn vị

Đại diện cho đơn vị dùng để đo lượng mưa tích tụ.

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

CardinalDirection

Đại diện cho một hướng chính (bao gồm cả hướng phụ).

Enum
CARDINAL_DIRECTION_UNSPECIFIED Chưa xác định hướng chính.
NORTH Hướng bắc.
NORTH_NORTHEAST Hướng phụ Bắc Đông Bắc.
NORTHEAST Hướng Đông Bắc.
EAST_NORTHEAST Hướng phụ Đông Đông Bắc.
EAST Hướng chính Đông.
EAST_SOUTHEAST Hướng phụ đông-đông nam.
SOUTHEAST Hướng Đông Nam.
SOUTH_SOUTHEAST Hướng phụ nam đông nam.
SOUTH Hướng chính nam.
SOUTH_SOUTHWEST Hướng phụ nam tây nam.
SOUTHWEST Hướng Tây Nam.
WEST_SOUTHWEST Hướng phụ Tây Tây Nam.
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ụ bắc tây bắc.

SpeedUnit

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

Enum
SPEED_UNIT_UNSPECIFIED Đơn vị tốc độ chưa được chỉ định.
KILOMETERS_PER_HOUR Tốc độ được đo bằng kilômét trên giờ.
MILES_PER_HOUR Tốc độ được đo bằng dặm/giờ.

Chú thích về công cụ

Chú thích về công cụ được gửi đến ứ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 ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng có thể dùng chú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 nó. Mặc định: false.
  • destructiveHint: Nếu đúng, thì công cụ có thể thực hiện các hành động có tính huỷ diệt. Nếu là false, thì công cụ chỉ có thể thực hiện các hành động 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 có thêm hiệu ứng nào đối với môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, thì công cụ 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ụ: công cụ tìm kiếm trên web sẽ là công cụ thế giới mở, còn công cụ ghi nhớ sẽ không phải là công cụ thế giới mở.

Gợi ý về hành động huỷ diệt: ❌ | Gợi ý về hành động luỹ đẳng: ❌ | Gợi ý về hành động chỉ đọc: ✅ | Gợi ý về hành động trong thế giới mở: ❌