MCP Tools Reference: mapstools.googleapis.com

الأداة: lookup_weather

تسترد هذه الأداة بيانات شاملة عن الطقس، بما في ذلك الأحوال الجوية الحالية والتوقعات لكل ساعة ويوم.

البيانات المحدّدة المتاحة: درجة الحرارة (الحالية، المحسوسة، القصوى/الدنيا، مؤشر الحرارة)، والرياح (السرعة، الهبّات، الاتجاه)، والأحداث الفلكية (الشروق/الغروب، طور القمر)، وهطول الأمطار (النوع، الاحتمالية، الكمية/التوقعات الكمية لهطول الأمطار)، والظروف الجوية (مؤشر الأشعة فوق البنفسجية، الرطوبة، الغطاء السحابي، احتمالية حدوث عاصفة رعدية)، وعنوان الموقع الجغرافي المرمّز جغرافيًا.

الموقع الجغرافي وقواعد الموقع الجغرافي (مهم):

يتم تحديد الموقع الجغرافي المطلوب الحصول على بيانات الطقس له باستخدام الحقل location. هذا الحقل هو بنية "oneof"، ما يعني أنّه يجب تقديم قيمة لحقل فرعي واحد فقط من الحقول الفرعية الثلاثة للموقع الجغرافي أدناه لضمان البحث عن بيانات الطقس بدقة.

  1. الإحداثيات الجغرافية (lat_lng)

    • استخدِم هذا الخيار عندما يتم تزويدك بإحداثيات دقيقة لخطوط العرض/الطول.
    • مثال: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // لوس أنجلوس

  2. رقم تعريف المكان (place_id)

    • معرّف سلسلة واضح (رقم تعريف المكان على "خرائط Google")
    • يمكن جلب place_id من أداة search_places.
    • مثال: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // برج إيفل

  3. سلسلة العنوان (address)

    • سلسلة ذات شكل حر تتطلب تحديدًا للترميز الجغرافي.
    • المدينة والمنطقة: يجب دائمًا تضمين المنطقة/البلد (مثلاً، "لندن، المملكة المتحدة"، وليس "لندن").
    • عنوان الشارع: أدخِل العنوان الكامل (مثلاً، "1600 Pennsylvania Ave NW, Washington, DC").
    • الرموز البريدية: يجب أن تكون مصحوبة باسم بلد (مثلاً، "90210، الولايات المتحدة"، وليس "90210").
    • مثال: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

أوضاع الاستخدام:

  • الطقس الحالي: قدِّم location فقط. لا تحدِّد السمتَين date وhour.

  • التوقعات لكل ساعة: يجب تقديم location وdate وhour (من 0 إلى 23). يمكنك استخدامها لأوقات محدّدة (مثل "في الساعة 5 مساءً") أو عبارات مثل "خلال الساعات القليلة القادمة" أو "في وقت لاحق اليوم". إذا حدّد المستخدم الدقيقة، يتم التقريب إلى أقرب ساعة. لا يمكن عرض توقعات الطقس كل ساعة لأكثر من 120 ساعة من الآن. تتوفّر بيانات الطقس السابقة لكل ساعة لمدة تصل إلى 24 ساعة في الماضي.

  • التوقعات اليومية: قدِّم location وdate. لا تحدِّد قيمة hour. يُستخدم هذا التنسيق للطلبات العامة المتعلقة باليوم (مثل "الطقس غدًا" أو "الطقس يوم الجمعة" أو "الطقس في 25 ديسمبر"). إذا لم يكن تاريخ اليوم مذكورًا في السياق، عليك توضيحه مع المستخدم. لا تتوفّر التوقعات اليومية لأكثر من 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)

الحقل مطلوب. الموقع الجغرافي المطلوب معرفة أحوال الطقس فيه

حقل الربط _date

يمكن أن يكون التعليق _date إحدى القيم التالية فقط:
date

object (Date)

اختيارية: تاريخ معلومات الطقس المطلوبة ملاحظة: يرتبط هذا التاريخ بالمنطقة الزمنية المحلية للموقع الجغرافي المحدّد في حقل الموقع الجغرافي. يجب أن يكون التاريخ بين آخر 24 ساعة والأيام الـ 10 القادمة.

حقل الربط _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.
}
الحقول
حقل الربط 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

تمثّل نظام الوحدات المستخدَم لقياس القيم.

عمليات التعداد
UNITS_SYSTEM_UNSPECIFIED لم يتم تحديد نظام الوحدات.
IMPERIAL نظام الوحدات الإمبراطورية (مثل فهرنهايت وأميال وما إلى ذلك)
METRIC نظام الوحدات المترية (مثل الدرجة المئوية والكيلومتر وما إلى ذلك)

مخطط النتائج

الردّ على طلب LookupWeather RPC: يمثّل الأحوال الجوية في الموقع الجغرافي المطلوب.

يمثّل هذا الردّ كلاً من المعلومات بالساعة والمعلومات اليومية، وبالتالي يتم تقسيم الردّ إلى ثلاثة أقسام: "بالساعة" و"يوميًا" و"مشترَك". يتم وضع علامة "اختياري" على الحقلَين "كل ساعة فقط" و"يوميًا فقط". بالنسبة إلى الحقول التي تتم مشاركتها بين المعلومات "لكل ساعة" و"يوميًا"، يكون بعضها متاحًا دائمًا، لذا لا يتم تصنيفها على أنّها اختيارية، في حين يتم تصنيف الباقي على أنّها اختيارية لأنّها لا تتوفّر دائمًا.

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)

يجب عرض مصدر المعلومات مع حالة الطقس.

حقل الربط _temperature

يمكن أن يكون التعليق _temperature إحدى القيم التالية فقط:
temperature

object (Temperature)

درجة الحرارة كل ساعة

حقل الربط _feels_like_temperature

يمكن أن يكون التعليق _feels_like_temperature إحدى القيم التالية فقط:
feelsLikeTemperature

object (Temperature)

مقياس درجة الحرارة المحسوسة كل ساعة

حقل الربط _heat_index

يمكن أن يكون التعليق _heat_index إحدى القيم التالية فقط:
heatIndex

object (Temperature)

درجة الحرارة وفقًا لمؤشر الحرارة كل ساعة

حقل الربط _air_pressure

يمكن أن يكون التعليق _air_pressure إحدى القيم التالية فقط:
airPressure

object (AirPressure)

حالة الضغط الجوي لكل ساعة

حقل الربط _max_temperature

يمكن أن يكون التعليق _max_temperature إحدى القيم التالية فقط:
maxTemperature

object (Temperature)

الحد الأقصى لدرجة الحرارة (المرتفعة) على مدار اليوم

حقل الربط _min_temperature

يمكن أن يكون التعليق _min_temperature إحدى القيم التالية فقط:
minTemperature

object (Temperature)

الحد الأدنى لدرجة الحرارة (المنخفضة) على مدار اليوم

حقل الربط _feels_like_max_temperature

يمكن أن يكون التعليق _feels_like_max_temperature إحدى القيم التالية فقط:
feelsLikeMaxTemperature

object (Temperature)

الحد الأقصى (المرتفع) لدرجة الحرارة المحسوسة على مدار اليوم

حقل الربط _feels_like_min_temperature

يمكن أن يكون التعليق _feels_like_min_temperature إحدى القيم التالية فقط:
feelsLikeMinTemperature

object (Temperature)

الحدّ الأدنى (المنخفض) لدرجة الحرارة المحسوسة على مدار اليوم

حقل الربط _max_heat_index

يمكن أن يكون التعليق _max_heat_index إحدى القيم التالية فقط:
maxHeatIndex

object (Temperature)

الحد الأقصى لدرجة الحرارة المحسوسة على مدار اليوم

حقل الربط _sun_events

يمكن أن يكون التعليق _sun_events إحدى القيم التالية فقط:
sunEvents

object (SunEvents)

الأحداث المرتبطة بالشمس (مثل شروق الشمس وغروبها)

حقل الربط _moon_events

يمكن أن يكون التعليق _moon_events إحدى القيم التالية فقط:
moonEvents

object (MoonEvents)

الأحداث المرتبطة بالقمر (مثل شروق القمر وغروبه)

حقل الربط _relative_humidity

يمكن أن يكون التعليق _relative_humidity إحدى القيم التالية فقط:
relativeHumidity

integer

النسبة المئوية للرطوبة النسبية (القيم من 0 إلى 100). يتم تحديدها كقيمة اختيارية لأنّها ليست متاحة دائمًا

حقل الربط _uv_index

يمكن أن يكون التعليق _uv_index إحدى القيم التالية فقط:
uvIndex

integer

الحد الأقصى لمؤشّر الأشعة فوق البنفسجية (UV) - يُرجى تحديد هذا الحقل كاختياري لأنّه ليس متاحًا دائمًا

حقل الربط _thunderstorm_probability

يمكن أن يكون التعليق _thunderstorm_probability إحدى القيم التالية فقط:
thunderstormProbability

integer

احتمالية حدوث عاصفة رعدية (القيم من 0 إلى 100). يُرجى تحديدها كقيمة اختيارية لأنّها ليست متاحة دائمًا

حقل الربط _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)

رمز الوحدة المستخدَمة لقياس قيمة درجة الحرارة

حقل الربط _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.
}
الحقول

حقل الربط _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) المنقضية منذ بداية حقبة يونكس 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).

ملاحظة: في معظم الحالات، سيكون هناك وقت واحد لشروق القمر في اليوم. وفي حالات أخرى، قد تكون القائمة فارغة (على سبيل المثال، عندما يشرق القمر بعد منتصف ليل اليوم التالي). ومع ذلك، في حالات فريدة (مثل المناطق القطبية)، قد تحتوي القائمة على أكثر من قيمة واحدة. وفي هذه الحالات، يتم ترتيب القيم تصاعديًا.

يستخدم المعيار 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).

ملاحظة: في معظم الحالات، سيكون هناك وقت واحد لغروب القمر في اليوم. وفي حالات أخرى، قد تكون القائمة فارغة (مثلاً، عندما يغرب القمر بعد منتصف ليل اليوم التالي). ومع ذلك، في حالات فريدة (مثل المناطق القطبية)، قد تحتوي القائمة على أكثر من قيمة واحدة. وفي هذه الحالات، يتم ترتيب القيم تصاعديًا.

يستخدم المعيار 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)

رمز يشير إلى نوع هطول الأمطار

حقل الربط _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)

رمز الوحدة المستخدَمة لقياس كمية الهطول المتراكمة

حقل الربط _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)

الرمز الذي يمثّل الاتجاه الأساسي الذي تهبّ منه الرياح

حقل الربط _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)

الرمز الذي يمثّل الوحدة المستخدَمة لقياس سرعة الرياح

حقل الربط _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.
}
الحقول
حقل الربط 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

تمثّل وحدة مستخدَمة لقياس درجات الحرارة.

عمليات التعداد
TEMPERATURE_UNIT_UNSPECIFIED لم يتم تحديد وحدة درجة الحرارة.
CELSIUS يتم قياس درجة الحرارة بالدرجة المئوية.
FAHRENHEIT يتم قياس درجة الحرارة بالفهرنهايت.

MoonPhase

يشير إلى طور القمر (المعروف أيضًا باسم المرحلة القمرية).

عمليات التعداد
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 على جانبه الأيسر في نصف الكرة الشمالي 🌘 وعلى جانبه الأيمن في نصف الكرة الجنوبي 🌒.

النوع

يحدّد نوع حالة الطقس في سياق عنصر التوقعات.

عمليات التعداد
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

تمثّل نوع هطول الأمطار في موقع جغرافي معيّن.

عمليات التعداد
PRECIPITATION_TYPE_UNSPECIFIED نوع هطول غير محدّد
NONE لا هطول للأمطار.
SNOW تساقط الثلوج
RAIN هطول الأمطار
LIGHT_RAIN هطول أمطار خفيفة
HEAVY_RAIN هطول أمطار غزيرة
RAIN_AND_SNOW هطول أمطار وثلوج
SLEET هطول مطر ثلجي
FREEZING_RAIN هطول أمطار متجمّدة

وحدة

تمثّل الوحدة المستخدَمة لقياس كمية الهطول المتراكمة.

عمليات التعداد
UNIT_UNSPECIFIED وحدة قياس هطول الأمطار غير محدّدة.
MILLIMETERS يتم قياس كمية هطول الأمطار بالمليمتر.
INCHES يتم قياس كمية هطول الأمطار بالبوصة.

CardinalDirection

تمثّل اتجاهًا أساسيًا (بما في ذلك الاتجاهات الترتيبية).

عمليات التعداد
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

تمثّل الوحدة المستخدَمة لقياس السرعة.

عمليات التعداد
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: ❌