כלי: lookup_weather
שליפת נתוני מזג אוויר מקיפים, כולל התנאים הנוכחיים, תחזיות לפי שעה ותחזיות יומיות. נתונים ספציפיים שזמינים: טמפרטורה (נוכחית, מה הטמפרטורה בפועל, מקסימלית/מינימלית, מדד החום), רוח (מהירות, משבי רוח, כיוון), אירועים אסטרונומיים (זריחה/שקיעה, מופע הירח), משקעים (סוג, הסתברות, כמות), תנאים אטמוספריים (מדד קרינת UV, לחות, כיסוי עננים, הסתברות לסופת רעמים) וכתובת מיקום עם קידוד גיאוגרפי. מיקום וכללי מיקום (קריטי): המיקום שעבורו מתבקשים נתוני מזג האוויר מצוין בשדה 'מיקום'. השדה הזה הוא מבנה מסוג 'oneof', כלומר אתם חייבים לספק ערך רק לאחד משלושת שדות המשנה של המיקום שבהמשך כדי להבטיח חיפוש מדויק של נתוני מזג האוויר. 1. קואורדינטות גיאוגרפיות (lat_lng) * משתמשים בהן כשמספקים לכם קואורדינטות מדויקות של קו רוחב/אורך. * דוגמה: "lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles 2. מזהה מקום (place_id) * מזהה מחרוזת חד-משמעי (מזהה מקום במפות Google). * אפשר לאחזר את מזהה המקום באמצעות הכלי search_places. * דוגמה: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower 3. מחרוזת כתובת (address) * מחרוזת חופשית שצריך לציין בה פרטים ספציפיים כדי להמיר את הכתובת לקואורדינטות. * עיר ואזור: תמיד צריך לכלול אזור או מדינה (למשל, "London, UK" ולא "London"). * כתובת: יש לציין את הכתובת המלאה (לדוגמה, 1600 Pennsylvania Ave NW, Washington, DC). * מיקודים: חובה לציין את שם המדינה (לדוגמה, "90210, USA", ולא "90210"). מצבי שימוש: 1. מזג אוויר נוכחי: צריך לספק רק את address. אל תציינו את date ואת hour. 2. תחזית שעתית: תן לי את address, date ו-hour (0-23). אפשר להשתמש בהן לזמנים ספציפיים (למשל, "at 5 PM" (בשעה 17:00) או מונחים כמו 'next few hours' (במהלך השעות הקרובות) או 'later today' (בהמשך היום). אם המשתמש מציין דקה, מעגלים כלפי מטה לשעה הקרובה ביותר. אין תמיכה בתחזית לפי שעה מעבר ל-48 שעות מהרגע הזה. 3. תחזית יומית: מספקים את address וdate. אל תציינו את הערך hour. שימוש לבקשות כלליות ליום מסוים (למשל, "weather for tomorrow" (מזג האוויר מחר), "weather on Friday" (מזג האוויר ביום שישי), "weather on 12/25" (מזג האוויר ב-25 בדצמבר). אם התאריך של היום לא מופיע בהקשר, צריך לברר אותו עם המשתמש. אין תמיכה בתחזית יומית מעבר ל-7 ימים, כולל היום. אין תמיכה בנתוני מזג אוויר היסטוריים. אילוצים של פרמטרים: * אזורי זמן: כל הערכים של date ו-hour צריכים להיות יחסיים לאזור הזמן המקומי של המיקום, ולא לאזור הזמן של המשתמש. * פורמט התאריך: צריך להזין {year, month, day} מספרים שלמים מופרדים. * יחידות: ברירת המחדל היא METRIC. מגדירים את units_system לערך IMPERIAL עבור פרנהייט/מיילים אם המשתמש מרמז על תקנים אמריקאיים או מבקש זאת במפורש.
בדוגמה הבאה מוצג איך להשתמש ב-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 tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
סכימת קלט
בקשה לשיטה LookupWeather – מייצגת את תנאי מזג האוויר במיקום המבוקש.
LookupWeatherRequest
| ייצוג ב-JSON |
|---|
{ "DEPRECATEDAddress": string, "unitsSystem": enum ( |
| שדות | |
|---|---|
DEPRECATEDAddress |
הוצא משימוש: במקומו צריך להשתמש במיקום. |
unitsSystem |
אופציונלי. מערכת היחידות שבה יש להשתמש לתנאי מזג האוויר שמוחזרים. אם לא תציינו יחידות, תנאי מזג האוויר שיוחזרו יהיו במערכת המטרית (ברירת מחדל = METRIC). |
location |
חובה. המיקום שרוצים לקבל לגביו את תנאי מזג האוויר. |
שדה איחוד הערך |
|
date |
אופציונלי. התאריך של נתוני מזג האוויר הנדרשים. הערה: התאריך הזה יחסי לאזור הזמן המקומי של המיקום שצוין בשדה המיקום. התאריך חייב להיות בטווח של 7 הימים הבאים. |
שדה איחוד הערך |
|
hour |
אופציונלי. השעה שבה נדרש מידע על מזג האוויר, בפורמט של 24 שעות (0-23). הערך הזה הוא יחסי לאזור הזמן המקומי של המיקום שצוין בשדה המיקום. התחזית השעתית נתמכת רק ל-48 השעות הבאות מהשעה הנוכחית. |
תאריך
| ייצוג ב-JSON |
|---|
{ "year": integer, "month": integer, "day": integer } |
| שדות | |
|---|---|
year |
השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה. |
month |
החודש בשנה. הערך צריך להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום. |
day |
יום בחודש. הערך חייב להיות בין 1 ל-31, והוא צריך להיות תקף לשנה ולחודש, או 0 כדי לציין רק שנה או שנה וחודש שבהם היום לא משמעותי. |
מיקום
| ייצוג ב-JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד location_type. דרכים שונות לייצוג מיקום. הערך location_type יכול להיות רק אחד מהבאים: |
|
latLng |
נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות. |
placeId |
מזהה המקום שמשויך למיקום . |
address |
כתובת קריאה או קוד פלוס. פרטים נוספים זמינים בכתובת https://plus.codes. |
LatLng
| ייצוג ב-JSON |
|---|
{ "latitude": number, "longitude": number } |
| שדות | |
|---|---|
latitude |
קו הרוחב במעלות. הערך צריך להיות בטווח [-90.0, +90.0]. |
longitude |
קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0]. |
סכימת פלט
תשובה לקריאה לשירות מרוחק (RPC) של LookupWeather – מייצגת את תנאי מזג האוויר במיקום המבוקש.
התשובה הזו מייצגת מידע יומי וגם מידע לפי שעה, ולכן היא מחולקת לשלושה חלקים: לפי שעה, יומי ומשותף. השדות Only-Hourly ו-Only-Daily מסומנים כאופציונליים. חלק מהשדות שמשותפים לנתונים השעתיים והיומיים תמיד מוצגים, ולכן הם לא מסומנים כאופציונליים. שאר השדות מסומנים כאופציונליים כי הם לא תמיד זמינים.
LookupWeatherResponse
| ייצוג ב-JSON |
|---|
{ "weatherCondition": { object ( |
| שדות | |
|---|---|
weatherCondition |
תנאי מזג האוויר |
precipitation |
הסיכוי למשקעים וכמות המשקעים המצטברת |
wind |
תנאי הרוח |
DEPRECATEDGeocodedAddress |
המאפיין הזה יצא משימוש. במקומו צריך להשתמש במאפיין returned_location. |
returnedLocation |
חובה. המיקום שבו מוצג מידע על מזג האוויר. המיקום הזה זהה למיקום שבבקשה, אבל יכול להיות שונה ממנו אם המיקום המבוקש הוא כתובת טקסט חופשי שמחפשת מיקום גס (למשל, 'מאונטיין ויו, קליפורניה'). |
שדה איחוד הערך |
|
temperature |
הטמפרטורה לפי שעה |
שדה איחוד הערך |
|
feelsLikeTemperature |
מדידה שעתית של הטמפרטורה המורגשת. |
שדה איחוד הערך |
|
heatIndex |
טמפרטורת מדד החום לפי שעה. |
שדה איחוד הערך |
|
airPressure |
תנאי לחץ האוויר לפי שעה. |
שדה איחוד הערך |
|
maxTemperature |
הטמפרטורה המקסימלית (הגבוהה) במהלך היום. |
שדה איחוד הערך |
|
minTemperature |
הטמפרטורה המינימלית (הנמוכה) במהלך היום. |
שדה איחוד הערך |
|
feelsLikeMaxTemperature |
הטמפרטורה המורגשת המקסימלית (הגבוהה) במהלך היום. |
שדה איחוד הערך |
|
feelsLikeMinTemperature |
הטמפרטורה המורגשת המינימלית (הנמוכה) במהלך היום. |
שדה איחוד הערך |
|
maxHeatIndex |
הטמפרטורה המקסימלית של מדד החום במהלך היום. |
שדה איחוד הערך |
|
sunEvents |
האירועים שקשורים לשמש (למשל, זריחה, שקיעה). |
שדה איחוד הערך |
|
moonEvents |
האירועים שקשורים לירח (למשל, זריחת הירח, שקיעת הירח). |
שדה איחוד הערך |
|
relativeHumidity |
אחוז הלחות היחסית (ערכים מ-0 עד 100). הגדרה אופציונלית כי הנתון לא תמיד זמין |
שדה איחוד הערך |
|
uvIndex |
מדד קרינת ה-UV המקסימלי. הגדרה אופציונלית כי לא תמיד זמין |
שדה איחוד הערך |
|
thunderstormProbability |
ההסתברות לסופת רעמים (ערכים מ-0 עד 100). הגדרה אופציונלית כי הנתון לא תמיד זמין |
שדה איחוד הערך |
|
cloudCover |
אחוז השמיים שמכוסה בעננים (ערכים מ-0 עד 100). הגדרה אופציונלית כי הנתון לא תמיד זמין |
טמפרטורה
| ייצוג ב-JSON |
|---|
{ "unit": enum ( |
| שדות | |
|---|---|
unit |
הקוד של היחידה שמשמשת למדידת ערך הטמפרטורה. |
שדה איחוד הערך |
|
degrees |
ערך הטמפרטורה (במעלות) ביחידה שצוינה. |
AirPressure
| ייצוג ב-JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד הערך |
|
meanSeaLevelMillibars |
לחץ האוויר הממוצע בגובה פני הים במיליבר. |
SunEvents
| ייצוג ב-JSON |
|---|
{ "sunriseTime": string, "sunsetTime": string } |
| שדות | |
|---|---|
sunriseTime |
השעה שבה השמש זורחת. הערה: במקרים ייחודיים מסוימים (למשל, צפונית לחוג הארקטי) יכול להיות שלא תהיה שעת זריחה ביום מסוים. במקרים כאלה, השדה הזה לא יוגדר. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
sunsetTime |
השעה שבה השמש שוקעת. הערה: במקרים ייחודיים מסוימים (למשל, צפונית לחוג הארקטי) יכול להיות שלא תהיה שעת שקיעה ביום מסוים. במקרים כאלה, השדה הזה לא יוגדר. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
חותמת זמן
| ייצוג ב-JSON |
|---|
{ "seconds": string, "nanos": integer } |
| שדות | |
|---|---|
seconds |
מייצג שניות של זמן UTC מאז ראשית זמן יוניקס (Unix epoch) ב-1970-01-01T00:00:00Z. הערך חייב להיות בין -62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z). |
nanos |
שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של הננו-שניות במשך הזמן, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל. |
MoonEvents
| ייצוג ב-JSON |
|---|
{
"moonriseTimes": [
string
],
"moonsetTimes": [
string
],
"moonPhase": enum ( |
| שדות | |
|---|---|
moonriseTimes[] |
השעה שבה הגפה העליונה של הירח מופיעה מעל האופק (ראו https://en.wikipedia.org/wiki/Moonrise_and_moonset). הערה: ברוב המקרים, תהיה שעת זריחה אחת של הירח בכל יום. במקרים אחרים, הרשימה עשויה להיות ריקה (למשל, כשהירח זורח אחרי חצות של היום הבא). עם זאת, במקרים ייחודיים (למשל באזורים קוטביים), הרשימה עשויה להכיל יותר מערך אחד. במקרים כאלה, הערכים ממוינים בסדר עולה. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
moonsetTimes[] |
השעה שבה הגפה העליונה של הירח נעלמת מתחת לאופק (ראו https://en.wikipedia.org/wiki/Moonrise_and_moonset). הערה: ברוב המקרים, תהיה שעת שקיעה אחת של הירח בכל יום. במקרים אחרים, הרשימה עשויה להיות ריקה (למשל, כשהירח שוקע אחרי חצות של היום הבא). עם זאת, במקרים ייחודיים (למשל באזורים קוטביים), הרשימה עשויה להכיל יותר מערך אחד. במקרים כאלה, הערכים ממוינים בסדר עולה. הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: |
moonPhase |
מופע הירח (נקרא גם שלב הירח). |
WeatherCondition
| ייצוג ב-JSON |
|---|
{ "iconBaseUri": string, "description": { object ( |
| שדות | |
|---|---|
iconBaseUri |
ה-URI הבסיסי של הסמל, לא כולל את סיומת סוג הקובץ. כדי להציג את הסמל, מוסיפים ל-URI הזה עיצוב אם רוצים, ואת סיומת סוג הקובץ ( |
description |
תיאור טקסטואלי של תנאי מזג האוויר הזה (מקומי). |
type |
סוג תנאי מזג האוויר. |
LocalizedText
| ייצוג ב-JSON |
|---|
{ "text": string, "languageCode": string } |
| שדות | |
|---|---|
text |
מחרוזת מותאמת לשפה המקומית שמתאימה ל- |
languageCode |
קוד השפה של הטקסט בפורמט BCP-47, למשל en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. |
משקעים
| ייצוג ב-JSON |
|---|
{ "probability": { object ( |
| שדות | |
|---|---|
probability |
הסיכוי למשקעים (ערכים מ-0 עד 100). |
snowQpf |
כמות השלג שהצטברה במשך תקופה מסוימת, שנמדדת כשוות ערך למים נוזליים. הערה: QPF הוא קיצור של Quantitative Precipitation Forecast (תחזית משקעים כמותית). פרטים נוספים זמינים בהגדרה של QuantitativePrecipitationForecast. |
qpf |
כמות המשקעים של גשם, שנמדדת כשוות ערך למים נוזליים, שהצטברה במשך תקופת זמן מסוימת. הערה: QPF הוא קיצור של Quantitative Precipitation Forecast (תחזית משקעים כמותית). פרטים נוספים זמינים בהגדרה של QuantitativePrecipitationForecast. |
PrecipitationProbability
| ייצוג ב-JSON |
|---|
{ "type": enum ( |
| שדות | |
|---|---|
type |
קוד שמציין את סוג המשקעים. |
שדה איחוד הערך |
|
percent |
אחוז בין 0 ל-100 שמציין את הסיכוי למשקעים. |
QuantitativePrecipitationForecast
| ייצוג ב-JSON |
|---|
{ "unit": enum ( |
| שדות | |
|---|---|
unit |
הקוד של היחידה שמשמשת למדידת כמות המשקעים המצטברת. |
שדה איחוד הערך |
|
quantity |
כמות המשקעים, שנמדדת כשוות ערך למים נוזליים, שהצטברה במשך תקופה מסוימת. |
רוח
| ייצוג ב-JSON |
|---|
{ "direction": { object ( |
| שדות | |
|---|---|
direction |
כיוון הרוח, הזווית שממנה היא מגיעה. |
speed |
מהירות הרוח. |
gust |
משב רוח (עלייה פתאומית במהירות הרוח). |
WindDirection
| ייצוג ב-JSON |
|---|
{ "cardinal": enum ( |
| שדות | |
|---|---|
cardinal |
הקוד שמייצג את הכיוון הראשי שממנו נושבת הרוח. |
שדה איחוד הערך |
|
degrees |
כיוון הרוח במעלות (ערכים מ-0 עד 360). |
WindSpeed
| ייצוג ב-JSON |
|---|
{ "unit": enum ( |
| שדות | |
|---|---|
unit |
הקוד שמייצג את היחידה שמשמשת למדידת מהירות הרוח. |
שדה איחוד הערך |
|
value |
הערך של מהירות הרוח. |
מיקום
| ייצוג ב-JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד location_type. דרכים שונות לייצוג מיקום. הערך location_type יכול להיות רק אחד מהבאים: |
|
latLng |
נקודה שצוינה באמצעות קואורדינטות גיאוגרפיות. |
placeId |
מזהה המקום שמשויך למיקום . |
address |
כתובת קריאה או קוד פלוס. פרטים נוספים זמינים בכתובת https://plus.codes. |
LatLng
| ייצוג ב-JSON |
|---|
{ "latitude": number, "longitude": number } |
| שדות | |
|---|---|
latitude |
קו הרוחב במעלות. הערך צריך להיות בטווח [-90.0, +90.0]. |
longitude |
קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0]. |
הערות על כלים
רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌