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/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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب الطريقة LookupWeather - يمثّل أحوال الطقس في الموقع الجغرافي المطلوب.

LookupWeatherRequest

تمثيل JSON 
{
  "DEPRECATEDAddress": string,
  "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.
}
الحقول
DEPRECATEDAddress
(deprecated)

string

تم إيقاف هذه السمة نهائيًا: استخدِم الموقع الجغرافي بدلاً منها.
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 Codes لمزيد من التفاصيل، يُرجى الانتقال إلى https://plus.codes.

LatLng

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضمن النطاق [-90.0, +90.0].
longitude

number

تمثّل هذه السمة خط الطول بالدرجات. يجب أن تكون القيمة ضمن النطاق [-180.0, +180.0].

مخطط النتائج

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

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

LookupWeatherResponse

تمثيل JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "DEPRECATEDGeocodedAddress": string,
  "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)

أحوال الرياح
DEPRECATEDGeocodedAddress
(deprecated)

string

تم إيقاف هذه السمة نهائيًا، لذا يُرجى استخدام returned_location بدلاً منها.
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 Codes لمزيد من التفاصيل، يُرجى الانتقال إلى 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 المطلوب الربط به لتحديد المصدر.

التعليقات التوضيحية للأدوات

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