MCP Tools Reference: mapstools.googleapis.com

เครื่องมือ: lookup_weather

ดึงข้อมูลสภาพอากาศที่ครอบคลุม ซึ่งรวมถึงสภาพอากาศปัจจุบัน การพยากรณ์อากาศรายชั่วโมง และรายวัน

ข้อมูลที่เจาะจงซึ่งพร้อมใช้งาน: อุณหภูมิ (ปัจจุบัน, อุณหภูมิที่รู้สึก, สูงสุด/ต่ำสุด, ดัชนีความร้อน), ลม (ความเร็ว, ลมกระโชก, ทิศทาง), เหตุการณ์บนท้องฟ้า (พระอาทิตย์ขึ้น/พระอาทิตย์ตก, ข้างขึ้นข้างแรม), หยาดน้ำฟ้า (ประเภท, ความน่าจะเป็น, ปริมาณ/QPF), สภาพบรรยากาศ (ดัชนีรังสียูวี, ความชื้น, เมฆปกคลุม, ความน่าจะเป็นที่จะเกิดพายุฝนฟ้าคะนอง) และที่อยู่ตำแหน่งที่ตั้งที่เข้ารหัสพิกัดภูมิศาสตร์

Location & Location Rules (CRITICAL):

ระบบจะระบุตำแหน่งที่ขอข้อมูลสภาพอากาศโดยใช้ช่อง location ช่องนี้เป็นโครงสร้าง "oneof" ซึ่งหมายความว่าคุณต้องระบุค่าสำหรับช่องย่อยของสถานที่ตั้งเพียงช่องเดียวจาก 3 ช่องด้านล่างเพื่อให้การค้นหาข้อมูลสภาพอากาศถูกต้อง

  1. พิกัดทางภูมิศาสตร์ (lat_lng)

    • ใช้เมื่อคุณได้รับพิกัดละติจูด/ลองจิจูดที่แน่นอน
    • ตัวอย่าง: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // ลอสแอนเจลิส

  2. รหัสสถานที่ (place_id)

    • ตัวระบุสตริงที่ชัดเจน (รหัสสถานที่ของ Google Maps)
    • คุณสามารถดึงข้อมูล place_id ได้จากเครื่องมือ search_places
    • ตัวอย่าง: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // หอไอเฟล

  3. สตริงที่อยู่ (address)

    • สตริงรูปแบบอิสระที่ต้องระบุเฉพาะเจาะจงสำหรับการเข้ารหัสพิกัดภูมิศาสตร์
    • เมืองและภูมิภาค: ระบุภูมิภาค/ประเทศเสมอ (เช่น "London, UK" ไม่ใช่ "London")
    • ที่อยู่: ระบุที่อยู่แบบเต็ม (เช่น "1600 Pennsylvania Ave NW, Washington, DC")
    • รหัสไปรษณีย์: ต้องระบุชื่อประเทศด้วย (เช่น "90210, USA" ไม่ใช่ "90210")
    • ตัวอย่าง: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

โหมดการใช้งาน

  • สภาพอากาศปัจจุบัน: ระบุเฉพาะ location เท่านั้น อย่าระบุ date และ hour

  • พยากรณ์รายชั่วโมง: ระบุ location, date และ hour (0-23) ใช้สำหรับเวลาที่เจาะจง (เช่น "ตอน 17:00 น.") หรือคำต่างๆ เช่น "อีก 2-3 ชั่วโมงข้างหน้า" หรือ "วันนี้ในช่วงสาย" หากผู้ใช้ระบุนาที ให้ปัดเศษลงเป็นชั่วโมงที่ใกล้ที่สุด ระบบไม่รองรับการพยากรณ์รายชั่วโมงที่เกิน 120 ชั่วโมงนับจากนี้ ระบบรองรับสภาพอากาศรายชั่วโมงย้อนหลังสูงสุด 24 ชั่วโมงที่ผ่านมา

  • พยากรณ์อากาศประจำวัน: แสดงlocationและdate อย่าระบุ hour ใช้สำหรับคำขอเกี่ยวกับวันทั่วไป (เช่น "สภาพอากาศพรุ่งนี้" "สภาพอากาศวันศุกร์" "สภาพอากาศวันที่ 25/12") หากวันที่ของวันนี้ไม่อยู่ในบริบท คุณควรชี้แจงกับผู้ใช้ ระบบไม่รองรับการพยากรณ์รายวันเกิน 10 วันนับจากวันนี้ ไม่รองรับข้อมูลสภาพอากาศที่ผ่านมา

ข้อจำกัดของพารามิเตอร์

  • เขตเวลา: ข้อมูล date และ hour ทั้งหมดที่ป้อนต้องสัมพันธ์กับเขตเวลาท้องถิ่นของสถานที่ตั้ง ไม่ใช่เขตเวลาของผู้ใช้
  • รูปแบบวันที่: ข้อมูลที่ป้อนต้องแยกเป็นจำนวนเต็ม {year, month, day} รายการ
  • หน่วย: ค่าเริ่มต้นคือ METRIC ตั้งค่า units_system เป็น IMPERIAL สำหรับฟาเรนไฮต์/ไมล์ หากผู้ใช้บอกเป็นนัยถึงมาตรฐานของสหรัฐอเมริกาหรือขออย่างชัดเจน

  • เอาต์พุตที่มีการระบุแหล่งที่มาต้องระบุแหล่งที่มาโดยใช้ข้อมูลจากช่อง attribution (หากมี)

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ MCP lookup_weather

คำขอ 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
}'

สคีมาอินพุต

คำขอสำหรับเมธอด LookupWeather ซึ่งแสดงถึงสภาพอากาศในตำแหน่งที่ขอ

LookupWeatherRequest

การแสดง 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.
}
ฟิลด์
unitsSystem

enum (UnitsSystem)

ไม่บังคับ ระบบหน่วยที่จะใช้สำหรับสภาพอากาศที่แสดงผล หากไม่ได้ระบุ สภาพอากาศที่แสดงผลจะอยู่ในระบบเมตริก (ค่าเริ่มต้น = METRIC)
location

object (Location)

ต้องระบุ สถานที่ตั้งที่ต้องการดูสภาพอากาศ

ฟิลด์ Union _date

_date ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
date

object (Date)

ไม่บังคับ วันที่ของข้อมูลสภาพอากาศที่ต้องการ หมายเหตุ: วันที่นี้สัมพันธ์กับเขตเวลาท้องถิ่นของสถานที่ที่ระบุในช่องสถานที่ตั้ง วันที่ต้องอยู่ระหว่าง 24 ชั่วโมงที่ผ่านมาและ 10 วันถัดไป

ฟิลด์ Union _hour

_hour ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
hour

integer

ไม่บังคับ ชั่วโมงของข้อมูลสภาพอากาศที่ขอ ในรูปแบบ 24 ชั่วโมง (0-23) ค่านี้จะสัมพันธ์กับเขตเวลาท้องถิ่นของสถานที่ตั้งที่ระบุในช่องสถานที่ตั้ง ระบบไม่รองรับการพยากรณ์รายชั่วโมงที่เกิน 120 ชั่วโมงนับจากนี้ ระบบรองรับสภาพอากาศรายชั่วโมงย้อนหลังสูงสุด 24 ชั่วโมงที่ผ่านมา

วันที่

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องเป็นค่าตั้งแต่ 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

เดือนของปี ต้องมีค่าตั้งแต่ 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และถูกต้องสำหรับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่มีความสำคัญ

ตำแหน่ง

การแสดง 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.
}
ช่อง
ฟิลด์ Union location_type วิธีต่างๆ ในการแสดงสถานที่ตั้ง location_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
latLng

object (LatLng)

จุดที่ระบุโดยใช้พิกัดทางภูมิศาสตร์
placeId

string

รหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้ง
address

string

ที่อยู่ที่มนุษย์อ่านได้หรือ Plus Code ดูรายละเอียดได้ที่ https://plus.codes

LatLng

การแสดง JSON 
{
  "latitude": number,
  "longitude": number
}
ช่อง
latitude

number

ละติจูดในหน่วยองศา โดยต้องอยู่ในช่วง [-90.0, +90.0]
longitude

number

ลองจิจูดเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

UnitsSystem

แสดงระบบหน่วยที่ใช้ในการวัดค่า

Enum
UNITS_SYSTEM_UNSPECIFIED ไม่ได้ระบุระบบหน่วย
IMPERIAL ระบบหน่วยวัดอิมพีเรียล (เช่น ฟาเรนไฮต์ ไมล์ ฯลฯ)
METRIC ระบบหน่วยเมตริก (เช่น เซลเซียส กิโลเมตร ฯลฯ)

สคีมาเอาต์พุต

การตอบกลับสำหรับ LookupWeather RPC - แสดงสภาพอากาศในตำแหน่งที่ขอ

คำตอบนี้แสดงทั้งข้อมูลรายชั่วโมงและรายวัน ดังนั้นคำตอบจึงแบ่งออกเป็น 3 ส่วน ได้แก่ รายชั่วโมง รายวัน และข้อมูลที่ใช้ร่วมกัน ระบบจะทำเครื่องหมายช่อง "รายชั่วโมงเท่านั้น" และ "รายวันเท่านั้น" ว่าไม่บังคับ สำหรับช่องที่ใช้ร่วมกันระหว่างข้อมูลรายชั่วโมงและรายวัน บางช่องจะแสดงอยู่เสมอจึงไม่ได้ทำเครื่องหมายว่าไม่บังคับ ส่วนช่องที่เหลือจะทำเครื่องหมายว่าไม่บังคับเนื่องจากอาจไม่พร้อมใช้งานเสมอไป

LookupWeatherResponse

การแสดง 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.
}
ช่อง
weatherCondition

object (WeatherCondition)

สภาพอากาศ
precipitation

object (Precipitation)

ความน่าจะเป็นของการเกิดหยาดน้ำฟ้าและปริมาณหยาดน้ำฟ้าที่สะสม
wind

object (Wind)

สภาพลม
returnedLocation

object (Location)

ต้องระบุ ตำแหน่งที่แสดงข้อมูลสภาพอากาศ ตำแหน่งนี้เหมือนกับตำแหน่งในคำขอ แต่อาจแตกต่างกันได้หากตำแหน่งที่ขอเป็นที่อยู่ข้อความอิสระที่ค้นหาตำแหน่งคร่าวๆ (เช่น "Mountain View, CA")
attribution

object (Attribution)

การระบุแหล่งที่มาที่จำเป็นต้องแสดงพร้อมกับสภาพอากาศ

ฟิลด์ Union _temperature

_temperature ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
temperature

object (Temperature)

อุณหภูมิรายชั่วโมง

ฟิลด์ Union _feels_like_temperature

_feels_like_temperature ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
feelsLikeTemperature

object (Temperature)

การวัดอุณหภูมิที่รู้สึกได้แบบรายชั่วโมง

ฟิลด์ Union _heat_index

_heat_index ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
heatIndex

object (Temperature)

อุณหภูมิดัชนีความร้อนรายชั่วโมง

ฟิลด์ Union _air_pressure

_air_pressure ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
airPressure

object (AirPressure)

สภาพความกดอากาศรายชั่วโมง

ฟิลด์ Union _max_temperature

_max_temperature ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
maxTemperature

object (Temperature)

อุณหภูมิสูงสุด (สูง) ตลอดทั้งวัน

ฟิลด์ Union _min_temperature

_min_temperature ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
minTemperature

object (Temperature)

อุณหภูมิต่ำสุด (ต่ำ) ตลอดทั้งวัน

ฟิลด์ Union _feels_like_max_temperature

_feels_like_max_temperature ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
feelsLikeMaxTemperature

object (Temperature)

อุณหภูมิสูงสุด (สูง) ที่รู้สึกได้ตลอดทั้งวัน

ฟิลด์ Union _feels_like_min_temperature

_feels_like_min_temperature ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
feelsLikeMinTemperature

object (Temperature)

อุณหภูมิต่ำสุดที่รู้สึกได้ตลอดทั้งวัน

ฟิลด์ Union _max_heat_index

_max_heat_index ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
maxHeatIndex

object (Temperature)

อุณหภูมิดัชนีความร้อนสูงสุดตลอดทั้งวัน

ฟิลด์ Union _sun_events

_sun_events ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
sunEvents

object (SunEvents)

เหตุการณ์ที่เกี่ยวข้องกับดวงอาทิตย์ (เช่น พระอาทิตย์ขึ้น พระอาทิตย์ตก)

ฟิลด์ Union _moon_events

_moon_events ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
moonEvents

object (MoonEvents)

เหตุการณ์ที่เกี่ยวข้องกับดวงจันทร์ (เช่น ดวงจันทร์ขึ้น ดวงจันทร์ตก)

ฟิลด์ Union _relative_humidity

_relative_humidity ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
relativeHumidity

integer

เปอร์เซ็นต์ของความชื้นสัมพัทธ์ (ค่าตั้งแต่ 0 ถึง 100) กำหนดเป็นไม่บังคับเนื่องจากอาจไม่พร้อมใช้งานเสมอไป

ฟิลด์ Union _uv_index

_uv_index ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
uvIndex

integer

ดัชนีรังสีอัลตราไวโอเลต (UV) สูงสุด กำหนดเป็นไม่บังคับเนื่องจากอาจไม่พร้อมใช้งานเสมอไป

ฟิลด์ Union _thunderstorm_probability

_thunderstorm_probability ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
thunderstormProbability

integer

ความน่าจะเป็นที่จะเกิดพายุฝนฟ้าคะนอง (ค่าตั้งแต่ 0 ถึง 100) กำหนดเป็นไม่บังคับเนื่องจากอาจไม่พร้อมใช้งานเสมอไป

ฟิลด์ Union _cloud_cover

_cloud_cover ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
cloudCover

integer

เปอร์เซ็นต์ของท้องฟ้าที่ปกคลุมด้วยเมฆ (ค่าตั้งแต่ 0 ถึง 100) กำหนดเป็นไม่บังคับเนื่องจากอาจไม่พร้อมใช้งานเสมอไป

อุณหภูมิ

การแสดง 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.
}
ช่อง
unit

enum (TemperatureUnit)

รหัสสำหรับหน่วยที่ใช้วัดค่าอุณหภูมิ

ฟิลด์ Union _degrees

_degrees ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
degrees

number

ค่าอุณหภูมิ (เป็นองศา) ในหน่วยที่ระบุ

AirPressure

การแสดง 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.
}
ช่อง

ฟิลด์ Union _mean_sea_level_millibars

_mean_sea_level_millibars ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
meanSeaLevelMillibars

number

ความกดอากาศที่ระดับน้ำทะเลปานกลางในหน่วยมิลลิบาร์

SunEvents

การแสดง JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
ช่อง
sunriseTime

string (Timestamp format)

เวลาที่พระอาทิตย์ขึ้น

หมายเหตุ: ในบางกรณีที่เกิดขึ้นไม่บ่อยนัก (เช่น ทางเหนือของอาร์กติกเซอร์เคิล) อาจไม่มีเวลาพระอาทิตย์ขึ้นในวันนั้น ในกรณีเหล่านี้ ระบบจะไม่ตั้งค่าช่องนี้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
sunsetTime

string (Timestamp format)

เวลาที่พระอาทิตย์ตก

หมายเหตุ: ในบางกรณีที่เกิดขึ้นไม่บ่อยนัก (เช่น ทางเหนือของอาร์กติกเซอร์เคิล) อาจไม่มีเวลาพระอาทิตย์ตกในวันนั้น ในกรณีเหล่านี้ ระบบจะไม่ตั้งค่าช่องนี้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC นับตั้งแต่ Unix Epoch 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 (ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z)
nanos

integer

เศษส่วนของวินาทีที่ไม่เป็นค่าลบที่ความละเอียดระดับนาโนวินาที ช่องนี้เป็นส่วนนาโนวินาทีของระยะเวลา ไม่ใช่ทางเลือกแทนวินาที ค่าที่สองที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่ไม่เป็นลบซึ่งนับเวลาไปข้างหน้า ต้องอยู่ระหว่าง 0 ถึง 999,999,999

MoonEvents

การแสดง JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
ช่อง
moonriseTimes[]

string (Timestamp format)

เวลาที่ขอบบนของดวงจันทร์ปรากฏเหนือขอบฟ้า (ดู https://en.wikipedia.org/wiki/Moonrise_and_moonset)

หมายเหตุ: ในกรณีส่วนใหญ่ ดวงจันทร์จะขึ้นวันละครั้ง ในกรณีอื่นๆ รายการอาจว่างเปล่า (เช่น เมื่อดวงจันทร์ขึ้นหลังเที่ยงคืนของวันถัดไป) อย่างไรก็ตาม ในกรณีพิเศษ (เช่น ในบริเวณขั้วโลก) รายการอาจมีค่ามากกว่า 1 ค่า ในกรณีเหล่านี้ ระบบจะจัดเรียงค่าจากน้อยไปมาก

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
moonsetTimes[]

string (Timestamp format)

เวลาที่ขอบด้านบนของดวงจันทร์ลับหายไปใต้เส้นขอบฟ้า (ดู https://en.wikipedia.org/wiki/Moonrise_and_moonset)

หมายเหตุ: ในกรณีส่วนใหญ่ จะมีเวลาที่ดวงจันทร์ตกเพียงครั้งเดียวต่อวัน ในกรณีอื่นๆ รายการอาจว่างเปล่า (เช่น เมื่อดวงจันทร์ตกหลังเที่ยงคืนของวันถัดไป) อย่างไรก็ตาม ในกรณีพิเศษ (เช่น ในบริเวณขั้วโลก) รายการอาจมีค่ามากกว่า 1 ค่า ในกรณีเหล่านี้ ระบบจะจัดเรียงค่าจากน้อยไปมาก

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
moonPhase

enum (MoonPhase)

ข้างขึ้นข้างแรม (หรือที่เรียกว่าระยะของดวงจันทร์)

WeatherCondition

การแสดง JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
ช่อง
iconBaseUri

string

URI พื้นฐานสำหรับไอคอนที่ไม่รวมนามสกุลประเภทไฟล์ หากต้องการแสดงไอคอน ให้เพิ่มธีม (หากต้องการ) และนามสกุลประเภทไฟล์ (.png หรือ .svg) ต่อท้าย URI นี้ โดยค่าเริ่มต้น ไอคอนจะเป็นธีมสว่าง แต่สามารถเพิ่ม _dark สำหรับโหมดมืดได้ เช่น "https://maps.gstatic.com/weather/v1/dust.svg" หรือ "https://maps.gstatic.com/weather/v1/dust_dark.svg" โดยที่ icon_base_uri คือ "https://maps.gstatic.com/weather/v1/dust"
description

object (LocalizedText)

คำอธิบายแบบข้อความสำหรับสภาพอากาศนี้ (แปลแล้ว)
type

enum (Type)

ประเภทของสภาพอากาศ

LocalizedText

การแสดง JSON 
{
  "text": string,
  "languageCode": string
}
ช่อง
text

string

สตริงที่แปลแล้วในภาษาที่สอดคล้องกับ google.type.LocalizedText.language_code ด้านล่าง
languageCode

string

รหัสภาษา BCP-47 ของข้อความ เช่น "en-US" หรือ "sr-Latn"

ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier

หยาดน้ำฟ้า

การแสดง JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
ช่อง
probability

object (PrecipitationProbability)

ความน่าจะเป็นของการเกิดฝน (ค่าตั้งแต่ 0 ถึง 100)
snowQpf

object (QuantitativePrecipitationForecast)

ปริมาณหิมะที่วัดเป็นปริมาณน้ำที่เทียบเท่า ซึ่งสะสมในช่วงระยะเวลาหนึ่ง หมายเหตุ: QPF เป็นตัวย่อของ Quantitative Precipitation Forecast (โปรดดูรายละเอียดเพิ่มเติมในคำจำกัดความของ QuantitativePrecipitationForecast)
qpf

object (QuantitativePrecipitationForecast)

ปริมาณฝนที่ตกลงมา ซึ่งวัดเป็นปริมาณน้ำที่เทียบเท่ากับของเหลวที่สะสมในช่วงระยะเวลาหนึ่ง หมายเหตุ: QPF เป็นตัวย่อของ Quantitative Precipitation Forecast (โปรดดูรายละเอียดเพิ่มเติมในคำจำกัดความของ QuantitativePrecipitationForecast)

PrecipitationProbability

การแสดง 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.
}
ช่อง
type

enum (PrecipitationType)

รหัสที่ระบุประเภทของหยาดน้ำฟ้า

ฟิลด์ Union _percent

_percent ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
percent

integer

เปอร์เซ็นต์ตั้งแต่ 0 ถึง 100 ที่ระบุโอกาสเกิดฝน

QuantitativePrecipitationForecast

การแสดง 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.
}
ช่อง
unit

enum (Unit)

รหัสของหน่วยที่ใช้ในการวัดปริมาณฝนที่สะสม

ฟิลด์ Union _quantity

_quantity ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
quantity

number

ปริมาณหยาดน้ำฟ้าที่วัดเป็นปริมาณน้ำที่เทียบเท่า ซึ่งสะสมในช่วงระยะเวลาหนึ่ง

ลม

การแสดง JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
ช่อง
direction

object (WindDirection)

ทิศทางลม มุมที่ลมพัดมา
speed

object (WindSpeed)

ความเร็วลม
gust

object (WindSpeed)

ลมกระโชกแรง (ความเร็วลมเพิ่มขึ้นอย่างฉับพลัน)

WindDirection

การแสดง 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.
}
ช่อง
cardinal

enum (CardinalDirection)

รหัสที่แสดงทิศทางหลักที่ลมพัดมา

ฟิลด์ Union _degrees

_degrees ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
degrees

integer

ทิศทางลมเป็นองศา (ค่าตั้งแต่ 0 ถึง 360)

WindSpeed

การแสดง 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.
}
ช่อง
unit

enum (SpeedUnit)

รหัสที่แสดงหน่วยที่ใช้ในการวัดความเร็วลม

ฟิลด์ Union _value

_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
value

number

ค่าความเร็วลม

ตำแหน่ง

การแสดง 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.
}
ช่อง
ฟิลด์ Union location_type วิธีต่างๆ ในการแสดงสถานที่ตั้ง location_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
latLng

object (LatLng)

จุดที่ระบุโดยใช้พิกัดทางภูมิศาสตร์
placeId

string

รหัสสถานที่ที่เชื่อมโยงกับสถานที่ตั้ง
address

string

ที่อยู่ที่มนุษย์อ่านได้หรือ Plus Code ดูรายละเอียดได้ที่ https://plus.codes

LatLng

การแสดง JSON 
{
  "latitude": number,
  "longitude": number
}
ช่อง
latitude

number

ละติจูดในหน่วยองศา โดยต้องอยู่ในช่วง [-90.0, +90.0]
longitude

number

ลองจิจูดเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

การระบุแหล่งที่มา

การแสดง JSON 
{
  "title": string,
  "url": string
}
ช่อง
title

string

ชื่อที่จะแสดงสำหรับการระบุแหล่งที่มา
url

string

URL ที่จะลิงก์ไปเพื่อระบุแหล่งที่มา

TemperatureUnit

แสดงหน่วยที่ใช้วัดอุณหภูมิ

Enum
TEMPERATURE_UNIT_UNSPECIFIED ไม่ได้ระบุหน่วยอุณหภูมิ
CELSIUS อุณหภูมิวัดเป็นหน่วยเซลเซียส
FAHRENHEIT อุณหภูมิวัดเป็นหน่วยฟาเรนไฮต์

MoonPhase

ระบุข้างขึ้นข้างแรม (หรือที่เรียกว่าระยะของดวงจันทร์)

Enum
MOON_PHASE_UNSPECIFIED ข้างขึ้นข้างแรมที่ไม่ได้ระบุ
NEW_MOON ดวงจันทร์ไม่ได้รับแสงจากดวงอาทิตย์
WAXING_CRESCENT ดวงจันทร์สว่างขึ้น 0%-50% ทางด้านขวาในซีกโลกเหนือ 🌒 และทางด้านซ้ายในซีกโลกใต้ 🌘
FIRST_QUARTER ดวงจันทร์สว่าง 50.1% ทางด้านขวาในซีกโลกเหนือ 🌓 และทางด้านซ้ายในซีกโลกใต้ 🌗
WAXING_GIBBOUS ดวงจันทร์สว่างขึ้น 50%-100% ทางด้านขวาในซีกโลกเหนือ 🌔 และทางด้านซ้ายในซีกโลกใต้ 🌖
FULL_MOON ดวงจันทร์สว่างเต็มดวง
WANING_GIBBOUS ดวงจันทร์จะสว่าง 50%-100% ทางด้านซ้ายในซีกโลกเหนือ 🌖 และทางด้านขวาในซีกโลกใต้ 🌔
LAST_QUARTER ดวงจันทร์สว่าง 50.1% ทางด้านซ้ายในซีกโลกเหนือ 🌗 และทางด้านขวาในซีกโลกใต้ 🌓
WANING_CRESCENT ดวงจันทร์จะสว่าง 0%-50% ทางด้านซ้ายในซีกโลกเหนือ 🌘 และทางด้านขวาในซีกโลกใต้ 🌒

ประเภท

ทำเครื่องหมายประเภทสภาพอากาศในบริบทขององค์ประกอบการพยากรณ์

Enum
TYPE_UNSPECIFIED ไม่ได้ระบุสภาพอากาศ
CLEAR ไม่มีเมฆ
MOSTLY_CLEAR มีเมฆเป็นระยะๆ
PARTLY_CLOUDY มีเมฆบางส่วน (มีเมฆเล็กน้อย)
MOSTLY_CLOUDY มีเมฆมากเป็นส่วนใหญ่ (มีเมฆมากกว่าแดด)
CLOUDY มีเมฆมาก (มีแต่เมฆ ไม่มีแดด)
WINDY ลมแรง
WIND_AND_RAIN ลมแรงและมีฝนตก
LIGHT_RAIN_SHOWERS มีฝนตกเป็นระยะๆ เบาบาง
CHANCE_OF_SHOWERS อาจมีฝนตกเป็นระยะๆ
SCATTERED_SHOWERS มีฝนตกเป็นระยะๆ
RAIN_SHOWERS ฝนที่ตกเป็นแห่งๆ ถือเป็นฝนที่มีระยะเวลาสั้นกว่าฝนทั่วไป และมีลักษณะเฉพาะคือเริ่มตกและหยุดตกอย่างกะทันหัน รวมถึงมีความหนักที่เปลี่ยนแปลงอย่างรวดเร็ว
HEAVY_RAIN_SHOWERS ฝนตกหนัก
LIGHT_TO_MODERATE_RAIN ฝน (ปริมาณเล็กน้อยถึงปานกลาง)
MODERATE_TO_HEAVY_RAIN ฝนตก (ปริมาณปานกลางถึงหนัก)
RAIN มีฝนตกปานกลาง
LIGHT_RAIN ฝนตกเล็กน้อย
HEAVY_RAIN ฝนตกหนัก
RAIN_PERIODICALLY_HEAVY มีฝนตกหนักเป็นระยะๆ
LIGHT_SNOW_SHOWERS หิมะตกเล็กน้อยโดยมีความหนักเบาแตกต่างกันเป็นระยะเวลาสั้นๆ
CHANCE_OF_SNOW_SHOWERS อาจมีหิมะตกปรอยๆ
SCATTERED_SNOW_SHOWERS หิมะตกโดยมีความหนักแตกต่างกันเป็นระยะเวลาสั้นๆ
SNOW_SHOWERS หิมะตกปรอยๆ
HEAVY_SNOW_SHOWERS มีหิมะตกหนักในช่วงสั้นๆ
LIGHT_TO_MODERATE_SNOW มีหิมะตกเล็กน้อยถึงปานกลาง
MODERATE_TO_HEAVY_SNOW มีหิมะตกปานกลางถึงหนัก
SNOW มีหิมะตกปานกลาง
LIGHT_SNOW หิมะตกเบาบาง
HEAVY_SNOW หิมะตกหนัก
SNOWSTORM มีหิมะตกและอาจมีฝนฟ้าคะนอง
SNOW_PERIODICALLY_HEAVY มีหิมะตกหนักเป็นช่วงๆ
HEAVY_SNOW_STORM มีหิมะตกหนักและอาจมีฝนฟ้าคะนอง
BLOWING_SNOW มีหิมะตกและลมแรงมาก
RAIN_AND_SNOW มีฝนและหิมะตก
HAIL ลูกเห็บ
HAIL_SHOWERS ลูกเห็บที่ตกลงมาด้วยความหนักที่แตกต่างกันเป็นระยะเวลาสั้นๆ
THUNDERSTORM มีพายุฝนฟ้าคะนอง
THUNDERSHOWER ฝนตกพร้อมมีฟ้าร้องและฟ้าแลบ
LIGHT_THUNDERSTORM_RAIN มีพายุฝนฟ้าคะนองเบาบาง
SCATTERED_THUNDERSTORMS พายุฝนฟ้าคะนองที่มีฝนตกหนักเบาต่างกันเป็นระยะเวลาสั้นๆ
HEAVY_THUNDERSTORM พายุฝนฟ้าคะนองรุนแรง

PrecipitationType

แสดงประเภทของหยาดน้ำฟ้า ณ สถานที่หนึ่งๆ

Enum
PRECIPITATION_TYPE_UNSPECIFIED ประเภทหยาดน้ำฟ้าที่ไม่ได้ระบุ
NONE ไม่มีฝน
SNOW หิมะตก
RAIN ฝนตก
LIGHT_RAIN มีฝนตกเล็กน้อย
HEAVY_RAIN มีฝนตกหนัก
RAIN_AND_SNOW มีทั้งฝนและหิมะตก
SLEET ฝนน้ำแข็ง
FREEZING_RAIN ฝนเยือกแข็ง

หน่วย

แสดงหน่วยที่ใช้ในการวัดปริมาณฝนที่สะสม

Enum
UNIT_UNSPECIFIED หน่วยวัดปริมาณหยาดน้ำฟ้าที่ไม่ได้ระบุ
MILLIMETERS ปริมาณฝนจะวัดเป็นมิลลิเมตร
INCHES ปริมาณฝนจะวัดเป็นนิ้ว

CardinalDirection

แสดงทิศหลัก (รวมถึงทิศรอง)

Enum
CARDINAL_DIRECTION_UNSPECIFIED ไม่ได้ระบุทิศหลัก
NORTH ทิศเหนือ
NORTH_NORTHEAST ทิศรองเหนือ-ตะวันออกเฉียงเหนือ
NORTHEAST ทิศตะวันออกเฉียงเหนือ
EAST_NORTHEAST ทิศตะวันออกเฉียงเหนือค่อนไปทางตะวันออกซึ่งเป็นทิศรอง
EAST ทิศตะวันออก
EAST_SOUTHEAST ทิศตะวันออกเฉียงใต้ค่อนไปทางตะวันออกซึ่งเป็นทิศรอง
SOUTHEAST ทิศตะวันออกเฉียงใต้
SOUTH_SOUTHEAST ทิศใต้ค่อนไปทางตะวันออกเฉียงใต้ซึ่งเป็นทิศรอง
SOUTH ทิศใต้
SOUTH_SOUTHWEST ทิศใต้ค่อนไปทางตะวันตกเฉียงใต้ซึ่งเป็นทิศรอง
SOUTHWEST ทิศตะวันตกเฉียงใต้
WEST_SOUTHWEST ทิศตะวันตก-ตะวันตกเฉียงใต้ซึ่งเป็นทิศรอง
WEST ทิศตะวันตก
WEST_NORTHWEST ทิศตะวันตก-ตะวันตกเฉียงเหนือซึ่งเป็นทิศรอง
NORTHWEST ทิศตะวันตกเฉียงเหนือ
NORTH_NORTHWEST ทิศเหนือค่อนไปทางตะวันตกเฉียงเหนือซึ่งเป็นทิศรอง

SpeedUnit

แสดงหน่วยที่ใช้ในการวัดความเร็ว

Enum
SPEED_UNIT_UNSPECIFIED ไม่ได้ระบุหน่วยความเร็ว
KILOMETERS_PER_HOUR ความเร็วมีหน่วยวัดเป็นกิโลเมตรต่อชั่วโมง
MILES_PER_HOUR ความเร็วมีหน่วยวัดเป็นไมล์ต่อชั่วโมง

คำอธิบายประกอบเครื่องมือ

ระบบจะส่งคำอธิบายประกอบเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือหนึ่งๆ ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งยืนยันไปยังผู้ใช้เมื่อใด

นอกจากสตริงชื่อแล้ว ยังมีการกำหนดคำแนะนำบูลีนต่อไปนี้ด้วย

  • readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อมของตนเอง ค่าเริ่มต้น: false
  • destructiveHint: หากเป็น "จริง" เครื่องมือจะดำเนินการที่ทำลายล้างได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการแบบเพิ่มเท่านั้น ค่าเริ่มต้น: true
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: false
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบได้เฉพาะกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นเว็บจะเป็นแบบโอเพนเวิลด์ ส่วนเครื่องมือความทรงจำจะไม่ใช่แบบโอเพนเวิลด์

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌