MCP Tools Reference: mapstools.googleapis.com

الأداة: lookup_weather

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

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

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

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

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

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

  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/12"). إذا لم يكن تاريخ اليوم متوفّرًا في السياق، عليك توضيحه للمستخدم. لا تتوفّر التوقعات اليومية لما بعد 10 أيام، بما في ذلك اليوم. لا تتوفّر بيانات الطقس السابقة.

قيود المَعلمات:

  • المناطق الزمنية: يجب أن تكون جميع إدخالات date وhour مرتبطة بالمنطقة الزمنية المحلية للموقع الجغرافي، وليس بالمنطقة الزمنية للمستخدم.
  • تنسيق التاريخ: يجب فصل المدخلات إلى {year, month, day} أعداد صحيحة.
  • الوحدات: يتم ضبط القيمة التلقائية على METRIC. اضبط units_system على IMPERIAL لوحدة فهرنهايت/ميل إذا كان المستخدم يشير إلى المعايير الأمريكية أو يطلبها صراحةً.

  • يجب الإشارة إلى مصدر الناتج المستند إلى بيانات واقعية باستخدام المعلومات من الحقل attribution عند توفّرها.

يوضّح نموذج الرمز التالي كيفية استخدام curl لاستدعاء أداة lookup_weather MCP.

طلب 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 ساعة في الماضي والأيام العشرة التالية.

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

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

معرّف الموارد المنتظم الأساسي للرمز الذي لا يتضمّن امتداد نوع الملف لعرض الرمز، أضِف تصميمًا إذا أردت وامتداد نوع الملف (.png أو .svg) إلى معرّف الموارد الموحّد هذا. يكون المظهر التلقائي للأيقونة فاتحًا، ولكن يمكن إضافة _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 هو اختصار لعبارة "توقّعات هطول الأمطار الكمية" (يُرجى الاطّلاع على تعريف QuantitativePrecipitationForecast لمزيد من التفاصيل).
qpf

object (QuantitativePrecipitationForecast)

كمية الأمطار المتساقطة، ويتم قياسها على أنّها كمية المياه السائلة المتراكمة خلال فترة زمنية معيّنة. ملاحظة: QPF هو اختصار لعبارة "توقّعات هطول الأمطار الكمية" (يُرجى الاطّلاع على تعريف 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: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة false، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، ستكون أداة البحث على الويب عالمًا مفتوحًا، بينما لن تكون أداة الذاكرة عالمًا مفتوحًا.

تلميح تدميري: ❌ | تلميح متكرّر: ❌ | تلميح للقراءة فقط: ✅ | تلميح للعالم المفتوح: ❌