MCP Tools Reference: mapstools.googleapis.com

الأداة: lookup_weather

يستردّ هذا الإجراء بيانات شاملة عن الطقس، بما في ذلك الأحوال الجوية الحالية والتوقعات كل ساعة ويوميًا. البيانات المحدّدة المتوفّرة: درجة الحرارة (الحالية، والمحسوسة، والحد الأقصى/الأدنى، ومؤشر الحرارة)، والرياح (السرعة، والهبات، والاتجاه)، والأحداث السماوية (شروق الشمس/غروبها، ومرحلة القمر)، وهطول الأمطار (النوع، والاحتمالية، والكمية/توقّعات هطول الأمطار)، والظروف الجوية (مؤشر الأشعة فوق البنفسجية، والرطوبة، والغطاء السحابي، واحتمالية حدوث عواصف رعدية)، وعنوان الموقع الجغرافي المرمّز جغرافيًا. الموقع الجغرافي وقواعد الموقع الجغرافي (مهم): يتم تحديد الموقع الجغرافي المطلوب الحصول على بيانات الطقس الخاصة به باستخدام الحقل "الموقع الجغرافي". هذا الحقل هو بنية "oneof"، ما يعني أنّه يجب تقديم قيمة لحقل فرعي واحد فقط من حقول الموقع الجغرافي الفرعية الثلاثة أدناه لضمان البحث عن بيانات الطقس بدقة. 1- الإحداثيات الجغرافية (lat_lng) * استخدِمها عندما يتم تزويدك بإحداثيات خطوط الطول والعرض الدقيقة. * مثال: "lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // Los Angeles 2. معرّف المكان (place_id) * معرّف سلسلة غير مبهم (معرّف المكان على "خرائط Google") * يمكن استرداد place_id من أداة search_places. * مثال: "place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // Eiffel Tower 3. سلسلة العنوان (address) * سلسلة ذات شكل حر تتطلب تحديدًا جغرافيًا. * المدينة والمنطقة: يجب دائمًا تضمين المنطقة/البلد (مثلاً، "لندن، المملكة المتحدة"، وليس "لندن"). * عنوان الشارع: أدخِل العنوان الكامل (مثلاً "1600 Pennsylvania Ave NW, Washington, DC"). * الرموز البريدية: يجب أن تكون مصحوبة باسم البلد (مثلاً "90210، الولايات المتحدة الأمريكية"، وليس "90210"). أوضاع الاستخدام: 1. الطقس الحالي: يجب تقديم address فقط. لا تحدِّد date وhour. 2. توقّعات الطقس على مدار الساعة: يجب توفير address وdate وhour (من 0 إلى 23). استخدِمها لأوقات محدّدة (مثل في الساعة 5 مساءً") أو عبارات مثل "خلال الساعات القليلة القادمة" أو "في وقت لاحق اليوم". إذا حدّد المستخدم الدقيقة، يتم التقريب إلى أقرب ساعة. لا تتوفّر توقعات الطقس كل ساعة لما بعد 48 ساعة من الآن. 3- توقّعات الطقس اليومية: قدِّم address وdate. لا تحدِّد hour. استخدِمها لطلبات الأيام العامة (مثل "الطقس غدًا"، "الطقس يوم الجمعة"، "الطقس في 25/12"). إذا لم يكن تاريخ اليوم متوفّرًا في السياق، عليك توضيحه للمستخدم. لا تتوفّر توقّعات الطقس اليومية لما بعد 7 أيام. لا تتوفّر بيانات الطقس السابقة. قيود المَعلمات: * المناطق الزمنية: يجب أن تكون جميع إدخالات date وhour مرتبطة بالمنطقة الزمنية المحلية للموقع الجغرافي، وليس بالمنطقة الزمنية للمستخدم. * تنسيق التاريخ: يجب فصل المدخلات إلى {year, month, day} أعداد صحيحة. * الوحدات: يتم ضبط القيمة التلقائية على METRIC. اضبط units_system على IMPERIAL لوحدة فهرنهايت/ميل إذا كان المستخدم يشير إلى المعايير الأمريكية أو يطلبها صراحةً.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة lookup_weather MCP.

Curl Request 
                  
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 (google.type.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 (google.type.Date)

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

حقل الدمج _hour

يمكن أن تكون _hour إحدى القيم التالية فقط:
hour

integer

اختيارية: ساعة معلومات الطقس المطلوبة، بتنسيق 24 ساعة (0-23) هذه القيمة مرتبطة بالمنطقة الزمنية المحلية للموقع الجغرافي المحدّد في حقل الموقع الجغرافي. لا تتوفّر التوقعات حسب الساعة إلا للـ 48 ساعة القادمة من الوقت الحالي.

التاريخ

تمثيل 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 (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
الحقول
حقل الدمج location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن تكون location_type إحدى القيم التالية فقط:
latLng

object (google.type.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].

مخطط الإخراج

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

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

LookupWeatherResponse

تمثيل JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "DEPRECATEDGeocodedAddress": string,
  "returnedLocation": {
    object (Location)
  },

  // 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)

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

حقل الدمج _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)

تمثّل هذه السمة ثواني التوقيت العالمي المنسَّق منذ بدء حساب الفترة في 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 (google.type.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 (google.type.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 (google.type.LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
الحقول
حقل الدمج location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن تكون location_type إحدى القيم التالية فقط:
latLng

object (google.type.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].

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

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