MCP Tools Reference: mapstools.googleapis.com

الأداة: lookup_weather

تسترد هذه الواجهة معلومات بيئية شاملة لموقع جغرافي معيّن، بما في ذلك الطقس وجودة الهواء (مؤشر جودة الهواء والملوثات) وحبوب اللقاح (مستويات مسببات الحساسية من الأشجار والأعشاب والنباتات): الظروف الحالية والتوقعات/السجلّات لكل ساعة والتوقعات اليومية للطقس وجودة الهواء. أما بالنسبة إلى حبوب اللقاح، فتتوفّر توقعات يومية فقط (من اليوم إلى 4 أيام قادمة، ولا تتوفّر بيانات لكل ساعة أو بيانات سابقة). النطاقات البيئية والإمكانات المتاحة (capabilities: WEATHER وAIR_QUALITY وPOLLEN — مهمة): * الاختيار الصريح الإلزامي: يجب تضمين واحد على الأقل من WEATHER أو AIR_QUALITY أو POLLEN في capabilities في كل طلب. لا يُسمح بحذف capabilities. * الطلبات العامة أو الغامضة حول الأنشطة الخارجية (مجموعة كاملة من المعلومات حول الأنشطة الخارجية): إذا طرح المستخدم سؤالاً عامًا حول الأنشطة الخارجية أو السفر أو الظروف المحيطة بدون تقييده بمجال معيّن (مثلاً، "كيف هي الظروف الخارجية الآن للجري؟")، يجب تضمين جميع الإمكانات الثلاث بشكل صريح (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) لعرض المجموعة الكاملة من المعلومات حول الأنشطة الخارجية (الطقس وجودة الهواء وحبوب اللقاح). بالنسبة إلى date أو hour في الماضي، يجب استبعاد POLLEN، لأنّه لا يتضمّن بيانات سابقة. * اختيار النطاق المستهدَف (طلبات بحث محدّدة): إذا طلب المستخدم تحديدًا نطاقًا واحدًا أو نطاقَين فقط (مثلاً، "ما هو مؤشر جودة الهواء في سياتل الآن؟")، يجب تضمين الإمكانات المطلوبة فقط (WEATHER و/أو AIR_QUALITY و/أو POLLEN). سيتم تنفيذ النطاقات المطلوبة فقط وعرضها. البيانات المحدّدة المتاحة حسب النطاق: * الطقس (weather): درجة الحرارة (الحالية، المحسوسة، القصوى/الدنيا، مؤشر الحرارة)، والرياح (السرعة، الهبّات، الاتجاه)، والأحداث الفلكية (الشروق/الغروب، طور القمر)، وهطول الأمطار (النوع، الاحتمالية، الكمية/التوقعات الكمية لهطول الأمطار)، والظروف الجوية (مؤشر الأشعة فوق البنفسجية، الرطوبة، الغطاء السحابي، احتمالية حدوث عاصفة رعدية، الضغط الجوي). * جودة الهواء (air_quality): مؤشرات جودة الهواء العالمية والمحلية (قيمة مؤشر جودة الهواء وفئته والملوّث السائد)، والنصائح الصحية لـ 7 مجموعات حساسية، وتركيزات الملوّثات (include_pollutant_concentration: true). لكل مؤشر ملوّث سائد خاص به، لذا يجب الإبلاغ عنه لكل مؤشر (على سبيل المثال، لا تقدِّم الملوّث الخاص بمؤشر جودة الهواء العالمي لمؤشر جودة الهواء في الولايات المتحدة). * حبوب اللقاح (pollen): مؤشر حبوب اللقاح العالمي (UPI، من 0 إلى 5) اليومي لكل فئة من الأشجار والأعشاب والحشائش ولكل نوع من النباتات (index.value مع index.category، على سبيل المثال 1 = "منخفض جدًا")، وحالة الموسم، والتفاعلات المتبادلة، والنصائح الصحية. * حقول حبوب اللقاح غير المتوفّرة: يشير عدم توفّر in_season إلى أنّ حبوب اللقاح ليست في موسمها. لا تذكر أنواع النباتات التي تظهر بدون index، إلا إذا سأل المستخدم عن ذلك النبات، وفي هذه الحالة، اذكر أنّه لم يتم الإبلاغ عن أي بيانات حول حبوب اللقاح الخاصة به اليوم (لا تستنتج مستوى). قواعد الموقع الجغرافي (مهمة): يجب تحديد الموقع الجغرافي المستهدف في location باستخدام حقل فرعي واحد فقط من الحقول الفرعية التالية في oneof: ‏1. الإحداثيات الجغرافية (lat_lng): * استخدِم هذه السمة عندما تكون إحداثيات خطوط العرض/الطول الدقيقة معروفة. * مثال: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. رقم تعريف المكان (place_id): * رقم تعريف مكان واضح على "خرائط Google" (مثلاً، تم الحصول عليه من search_places أو resolve_names). * مثال: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. سلسلة العنوان (address): * مدينة/منطقة أو حي أو معلم أو نقطة اهتمام أو عنوان شارع أو رمز بريدي، ويُفضّل أن يكون مع المدينة/البلد. * مثال: {"location": {"address": "Paris, France"}} أوضاع الوقت والاستخدام (date وhour — مهمة): * مرجع المنطقة الزمنية المحلية: يجب التعبير عن جميع مدخلات date ({year, month, day}) وhour (0-23) في المنطقة الزمنية المدنية المحلية المطلوبة location (على سبيل المثال، يستخدم طلب البحث عن "Paris tomorrow at 13:00" التاريخ والساعة المحليين Europe/Paris 13)، وليس التوقيت العالمي المنسق أو المنطقة الزمنية للمتصل. * 1. الحالات الحالية (تم حذف date وhour): * يُرجى تقديم location والهدف capabilities (WEATHER وAIR_QUALITY وPOLLEN). يُرجى عدم تحديد date أو hour. * تعرض هذه المَعلمة "الظروف الحالية" (CC) في الوقت الفعلي للنطاقات المطلوبة (الطقس الحالي و/أو جودة الهواء في الساعة الحالية و/أو توقّعات حبوب اللقاح لليوم). * بالنسبة إلى جودة الهواء، تكون "الظروف الحالية" لساعة واحدة: لا تستخدِمها بمفردها للإجابة عن أسئلة حول جودة الهواء أو أسئلة عامة حول الأنشطة الخارجية اليوم ككل (استخدِم "طلبات البحث اليومية" أدناه). * ‫2. التوقعات/السجلّ لكل ساعة (تم تحديد date وhour 0-23): * يجب تقديم location وdate ({year, month, day}) وhour (0-23) وcapabilities المستهدَف. إذا تم ذكر الدقائق، يجب تقريبها إلى أقرب ساعة. * قيد مهم (يجب توفير السمة date عند ضبط السمة hour): لا يُسمح بتوفير السمة hour بدون السمة date (تم حذف السمة date وتم ضبط السمة hour)، وسيؤدي ذلك إلى حدوث خطأ. حتى عندما يسأل المستخدم عن ساعة محدّدة اليوم (مثلاً، "at 13:00 today")، يجب ملء كل من date (تاريخ اليوم في location) وhour. * يتم البحث كل ساعة عن بيانات الطقس و/أو جودة الهواء المطلوبة في YYYY-MM-DD-HH، ويتم البحث يوميًا عن بيانات حبوب اللقاح المطلوبة في YYYY-MM-DD. * أسئلة عن الطقس تتضمّن كلمة "متى": بالنسبة إلى الأسئلة عن الطقس التي تتضمّن كلمات متى / في أي وقت / أفضل وقت (مثل "what time will it stop raining?")، استخدِم طلبات WEATHER (date + hour) للحصول على معلومات عن الطقس في الساعات ذات الصلة. لا تتضمّن توقعات الطقس اليومية قيمًا لكل ساعة. بالنسبة إلى الأسئلة العامة حول الأنشطة الخارجية التي تتضمّن عبارة "متى / أفضل وقت" (مثل "when is the best time to go walking today?")، يجب إجراء هذه الطلبات كل ساعة WEATHER بالإضافة إلى الطلب الذي يغطي يومًا كاملاً للحصول على معلومات حول جودة الهواء (وحبوب اللقاح) الموضّحة ضمن "الطلبات اليومية". * ‫3. طلبات البحث اليومية (تم تحديد date وحذف hour): * يجب تقديم location وdate ({year, month, day} في التوقيت المدني المحلي المطلوب في location) بدون hour، وcapabilities المستهدَف لطلبات البحث عن يوم كامل (مثل "weather and pollen in London tomorrow"). * الأسئلة العامة حول جودة الهواء والأنشطة الخارجية لليوم: بالنسبة إلى الأسئلة حول جودة الهواء والأسئلة العامة حول الأنشطة الخارجية (التي تشمل جودة الهواء) لليوم (مثل "how will the air quality change today" و"is today a good day for a picnic?")، يجب ضبط date على تاريخ اليوم في location (مع حذف الساعة) للحصول على سلسلة جودة الهواء لكل ساعة في اليوم. لا يكفي طلب "الظروف الحالية" وحده لأنّه يعرض فقط جودة الهواء في الساعة الحالية. يمكنك إضافة طلب آخر إذا سأل المستخدم أيضًا عن "الآن". * النوافذ الزمنية لجودة الهواء: بالنسبة إلى سؤال حول جودة الهواء في نافذة زمنية خلال يوم واحد (مثل "air quality between noon and 6 PM")، يُفضَّل إجراء طلب واحد لبيانات يومية لهذا التاريخ وقراءة ساعات النافذة الزمنية من سلسلة جودة الهواء، بدلاً من أخذ عيّنات من ساعات فردية. إذا كنت تستخدم المكالمات بالساعة، عليك تغطية كل ساعة من الفترة الزمنية. * تعرض التوقعات اليومية لبيانات الطقس و/أو حبوب اللقاح المطلوبة، وسلسلة بيانات جودة الهواء لكل ساعة من اليوم والتي تغطي اليوم المحلي بالكامل (من الساعة 00:00 إلى الساعة 23:00 بالتوقيت المحلي): 24 ساعة سابقة لتاريخ سابق، و24 ساعة متوقعة لتاريخ مستقبلي، وبالنسبة إلى اليوم، الساعات السابقة (السجلّ) والساعة الحالية والساعات المتبقية (التوقعات). النطاقات الزمنية المتاحة حسب المجال: * الطقس: كل ساعة من آخر 24 ساعة وحتى 240 ساعة (10 أيام) قادمة (تتطلّب الساعات الماضية كلاً من date وhour)، ويوميًا لمدة تصل إلى 10 أيام بما في ذلك اليوم (اليوم وحتى 9 أيام قادمة)، ولا يتوفّر سجلّ يومي. * جودة الهواء: كل ساعة من 720 ساعة (30 يومًا) مضت وحتى 96 ساعة (4 أيام) قادمة، ويجب أن يتناسب طلب اليوم الكامل مع هذه الفترة (عمليًا اليوم من -29 يومًا إلى +3 أيام). * حبوب اللقاح: يوميًا فقط، من اليوم وحتى 4 أيام (5 أيام بما في ذلك اليوم)، ولا يتم عرض تواريخ سابقة، ويتم تجاهل hour. * (ملاحظة: في حال طلب عدة إمكانات وكان date/hour خارج أحد نطاقاتها، سيتم تنفيذ الطلب بنجاح وعرض الإمكانات المتوافقة فقط.) * الطلبات خارج النطاق: إذا كان التاريخ أو الساعة المطلوبان خارج النطاق المسموح به للنطاق أعلاه (على سبيل المثال، حبوب اللقاح لتاريخ سابق)، يُرجى الاتصال بـ lookup_weather للحصول على التاريخ/الساعة المطلوبين. يوضّح الخطأ النطاق المسموح به. لا تستخدِم تاريخًا أو ساعة أو نطاقًا مختلفًا كبديل. خيارات النطاق ومصدر البيانات: * اللغة (language_code): رمز اللغة الاختياري وفقًا لمعيار BCP-47 (مثلاً، "fr"). القيمة التلقائية هي "en". * وحدات الطقس (weather_options.units_system أو units_system): القيمة التلقائية هي METRIC. يجب ضبط هذه السمة على IMPERIAL (فهرنهايت/ميل في الساعة) إذا كان المستخدم يشير ضمنيًا إلى المعايير الأمريكية أو يطلب صراحةً استخدام الوحدات الإمبراطورية. يمكن استخدام هذه السمة في كلّ من weather_options.units_system (الخيار المفضّل) وunits_system على المستوى الأعلى، وإذا تم تحديد كليهما، يجب ألا يتعارضا. ‫* خيارات جودة الهواء (air_quality_options): اضبط include_pollutant_concentration: true عندما تكون هناك حاجة إلى تركيزات ملوّثات معيّنة (PM2.5 وPM10 وO3 وNO2 وSO2 وCO). يمكنك اختياريًا ضبط index_region_code (رمز بلد مكوّن من حرفَين وفقًا لمعيار ISO، مثل "US") لطلب مقياس محدّد لمؤشر جودة الهواء في منطقة معيّنة. يتضمّن الردّ تلقائيًا مؤشر جودة الهواء العالمي ومؤشر جودة الهواء الإقليمي للموقع الجغرافي. * تحديد المصدر: يجب تحديد مصدر المخرجات المستندة إلى معلومات موثوقة باستخدام الحقل attribution داخل كل حاوية نطاق يتم عرضها (weather.attribution وair_quality.attribution وpollen.attribution). * الأوقات المعروضة: تكون قيم جودة الهواء date_time بالتوقيت المحلي للموقع الجغرافي (بما في ذلك utc_offset). يجب عرضها كما هي. تكون أوقات الطقس date_time (الحالية وكل ساعة) وأوقات شروق الشمس وغروبها بالتوقيت العالمي المنسق (UTC). يجب تحويلها إلى التوقيت المحلي للموقع الجغرافي باستخدام time_zone. صنِّف جميع الأوقات على أنّها محلية.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام 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)
  },
  "capabilities": [
    enum (Capability)
  ],

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

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
الحقول
unitsSystem

enum (UnitsSystem)

اختياريّ. نظام الوحدات المطلوب استخدامه لأحوال الطقس التي يتم عرضها في حال عدم تقديمها، ستكون أحوال الطقس المعروضة بالنظام المتري (القيمة التلقائية = METRIC).
location

object (Location)

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

enum (Capability)

اختياريّ. الإمكانات البيئية التي يجب تضمينها في الردّ

حقل الربط _date

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

object (Date)

اختياريّ. يحدّد هذا الحقل تاريخ المعلومات البيئية المطلوبة، بالنسبة إلى المنطقة الزمنية المحلية للموقع الجغرافي المحدّد في الحقل location. تعتمد النطاقات الزمنية المتاحة على الميزات المطلوبة: - WEATHER: ما يصل إلى 24 ساعة في الماضي (عند ضبط hour أيضًا) وما يصل إلى 10 أيام (240 ساعة) في المستقبل (من اليوم إلى 9 أيام أخرى للتوقعات اليومية). - AIR_QUALITY: ما يصل إلى 30 يومًا (720 ساعة) في الماضي وما يصل إلى 4 أيام (96 ساعة) في المستقبل. ‫- POLLEN: من اليوم إلى 4 أيام قادمة (ما يصل إلى 5 أيام بما في ذلك اليوم، ولا يمكن استخدام تواريخ سابقة).

حقل الربط _hour

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

integer

اختياريّ. يحدّد هذا الحقل ساعة المعلومات البيئية المطلوبة، بتنسيق 24 ساعة (0-23)، بالنسبة إلى المنطقة الزمنية المحلية للموقع الجغرافي المحدّد في الحقل location. يتطلّب تحديد date. تعتمد النطاقات الزمنية المتاحة على الإمكانات المطلوبة: - WEATHER: ما يصل إلى 24 ساعة في الماضي وما يصل إلى 240 ساعة (10 أيام) في المستقبل. - AIR_QUALITY: ما يصل إلى 30 يومًا (720 ساعة) في الماضي وما يصل إلى 4 أيام (96 ساعة) في المستقبل. ‫- POLLEN: تعرض التوقعات اليومية فقط، ويتم تجاهل hour في ما يتعلق بحبوب اللقاح.

حقل الربط _language_code

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

string

اختياريّ. رمز اللغة المستخدَمة في النص المترجَم في الردّ وفق المعيار BCP-47 (مثل "en" أو "ja" أو "fr-CA"). ويتم ضبط القيمة على "en" تلقائيًا في حال عدم تحديدها.

حقل الربط _weather_options

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

object (WeatherOptions)

اختياريّ. خيارات خاصة بطلبات الطقس يتم استخدام weather_options.units_system مع units_system (العلامة 4) ذي المستوى الأعلى للحفاظ على التوافق مع الأنظمة القديمة للمتصلين الحاليين، ويتم عرض INVALID_ARGUMENT إذا كان كلاهما يحدّد أنظمة وحدات متعارضة. يتم تجاهل هذه السياسة في حال عدم طلب WEATHER في capabilities.

حقل الربط _air_quality_options

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

object (AirQualityOptions)

اختياريّ. خيارات خاصة بطلبات جودة الهواء يتم تجاهل هذه السياسة في حال عدم طلب AIR_QUALITY في capabilities.

التاريخ

تمثيل 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

عنوان يمكن لشخص عادي قراءته (مثل عنوان الشارع أو المدينة أو الرمز البريدي)

LatLng

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

number

خط العرض بالدرجات يجب أن يكون في النطاق [-90.0, +90.0].
longitude

number

خط الطول بالدرجات ويجب أن يكون في النطاق [-180.0, +180.0].

WeatherOptions

تمثيل JSON 
{
  "unitsSystem": enum (UnitsSystem)
}
الحقول
unitsSystem

enum (UnitsSystem)

اختياريّ. نظام الوحدات المطلوب استخدامه لأحوال الطقس التي يتم عرضها في حال عدم تقديمها، ستكون أحوال الطقس المعروضة بالنظام المتري (القيمة التلقائية = METRIC).

AirQualityOptions

تمثيل JSON 
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
الحقول

حقل الربط _include_pollutant_concentration

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

boolean

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

حقل الربط _index_region_code

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

string

اختياريّ. رمز البلد أو المنطقة المكوّن من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2 (مثل "US" أو "FR" أو "CN") والمستخدَم لاختيار مقياس مؤشر جودة الهواء (AQI) المحلي المفضّل إلى جانب مؤشر جودة الهواء العالمي (UAQI). في حال عدم تحديدها، يتم ضبط القيمة التلقائية على منطقة الموقع الجغرافي المطلوب.

UnitsSystem

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

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

إمكانية

الإمكانات البيئية التي يمكن طلبها في LookupWeatherRequest

عمليات التعداد
CAPABILITY_UNSPECIFIED إمكانية غير محدّدة
WEATHER أحوال الطقس (درجة الحرارة، هطول الأمطار، الرياح، الأشعة فوق البنفسجية، وما إلى ذلك)
AIR_QUALITY معلومات حول جودة الهواء (مؤشر جودة الهواء والملوّثات والنصائح الصحية)
POLLEN معلومات عن حبوب اللقاح (مستويات مسببات الحساسية من الأشجار والأعشاب والأعشاب الضارة وأصناف النباتات)

مخطط النتائج

الردّ على طلب 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.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
الحقول
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).

حقل الربط _weather

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

object (WeatherResultData)

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

حقل الربط _air_quality

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

object (AirQualityResultData)

معلومات حول جودة الهواء في الموقع الجغرافي المطلوب

حقل الربط _pollen

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

object (PollenResultData)

معلومات حول حبوب اللقاح في الموقع الجغرافي المطلوب

حقل الربط _time_zone

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

string

سلسلة المنطقة الزمنية لهيئة أرقام الإنترنت المخصّصة (IANA) التي تم حلّها للموقع الجغرافي (مثل "America/New_York" و"Asia/Tokyo")

درجة الحرارة

تمثيل JSON 
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
الحقول
unit

enum (Unit)

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

حقل الربط _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 
{
  "moonPhase": enum (Phase),
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ]
}
الحقول
moonPhase

enum (Phase)

اختياريّ. طور القمر (المعروف أيضًا باسم المرحلة القمرية)
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"

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 (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
الحقول
type

enum (Type)

اختياريّ. رمز يشير إلى نوع هطول الأمطار

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

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
الحقول
cardinal

enum (Cardinal)

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

حقل الربط _degrees

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

integer

اتجاه الرياح بالدرجات (القيم من 0 إلى 360)

WindSpeed

تمثيل JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
الحقول
unit

enum (Unit)

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

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

عنوان يمكن لشخص عادي قراءته (مثل عنوان الشارع أو المدينة أو الرمز البريدي)

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 الذي سيتم ربطه بمصدر المحتوى

WeatherResultData

تمثيل JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // 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 _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

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

أحوال الرياح
attribution

object (Attribution)

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

حقل الربط _date_time

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

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"

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

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

حقل الربط _date

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

object (Date)

تاريخ التقويم المدني لتوقعات الطقس اليومية

حقل الربط _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 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

تمثّل السنة في التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو أن تكون 0 لتحديد تاريخ بدون سنة.
month

integer

شهر من السنة يجب أن تكون القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

يوم من الشهر يجب أن تكون القيمة بين 1 و31 وصالحة للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر عندما لا يكون اليوم مهمًا.

AirQualityResultData

تمثيل JSON 
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
الحقول
hourlyResults[]

object (AirQualityHourlyResult)

بيانات جودة الهواء لكل ساعة في الوقت المطلوب (تحتوي على إدخال واحد لطلبات البحث عن "الظروف الحالية" أو طلبات البحث عن ساعة واحدة، وما يصل إلى 24 إدخالاً لطلب بحث عن تاريخ سابق أو مستقبلي فقط، أو الساعات الحالية والمتبقية عندما يكون التاريخ هو اليوم).
attribution

object (Attribution)

يجب عرض مصدر بيانات جودة الهواء.

AirQualityHourlyResult

تمثيل JSON 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
الحقول
indexes[]

object (AirQualityIndex)

مؤشرات جودة الهواء (مثل مؤشر جودة الهواء العالمي ومؤشر جودة الهواء المحلي)
pollutants[]

object (Pollutant)

معلومات مفصّلة عن الملوّثات، يتم عرضها عندما تكون قيمة air_quality_options.include_pollutant_concentration صحيحة.
healthRecommendations

object (HealthRecommendations)

نصائح صحية لمجموعات سكانية مختلفة
dateTime

object (DateTime)

التاريخ والوقت المحليان في المنطقة الزمنية للموقع الجغرافي لإدخال جودة الهواء هذا كل ساعة (يتألف من year وmonth وday وhours وminutes وseconds وutc_offset).

AirQualityIndex

تمثيل JSON 
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
الحقول
displayName

string

الاسم المعروض للمؤشر (مثل "مؤشر جودة الهواء العالمي" أو "مؤشر جودة الهواء لوكالة حماية البيئة الأمريكية")
valueDisplay

string

تمثيل سلسلة منسّقة لقيمة مؤشر جودة الهواء
category

string

فئة جودة الهواء النصية (مثل "جودة هواء جيدة" و"جودة هواء متوسطة")
dominantPollutant

string

رمز الملوّث السائد (مثل "pm25" و"o3")

حقل الربط _value

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

integer

قيمة رقمية لمؤشر جودة الهواء

الملوِّث

تمثيل JSON 
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
الحقول
displayName

string

الاسم المعروض المختصر للملوّث (مثل "PM2.5" و"O3")
fullName

string

الاسم الكيميائي الكامل أو الاسم الشائع للملوّث (مثل "الجسيمات المعلّقة الدقيقة (أقل من 2.5 ميكرومتر)" أو "الأوزون")
concentration

object (Concentration)

التركيز الذي تم قياسه للملوِّث
additionalInfo

object (AdditionalInfo)

معلومات إضافية عن مصادر الملوّث وتأثيراته على الصحة

تركيز المادة

تمثيل JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
الحقول
unit

enum (Unit)

وحدة قياس التركيز

حقل الربط _value

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

number

القيمة الرقمية للتركيز

AdditionalInfo

تمثيل JSON 
{
  "sources": string,
  "effects": string
}
الحقول
sources

string

مصادر الانبعاثات الرئيسية للملوّث
effects

string

الآثار الصحية المحتملة للتعرّض للملوّث

HealthRecommendations

تمثيل JSON 
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
الحقول
generalPopulation

string

إرشادات لعامة السكان
elderly

string

إرشادات لكبار السن
lungDiseasePopulation

string

إرشادات للأشخاص الذين يعانون من أمراض الرئة أو مشاكل في الجهاز التنفسي
heartDiseasePopulation

string

إرشادات للأشخاص الذين يعانون من أمراض القلب والأوعية الدموية
athletes

string

إرشادات للرياضيين والأشخاص الذين يمارسون أنشطة في الهواء الطلق
pregnantWomen

string

إرشادات للنساء الحوامل
children

string

إرشادات للأطفال

DateTime

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
الحقول
year

integer

اختياريّ. سنة التاريخ يجب أن تتراوح القيمة بين 1 و9999، أو أن تكون 0 في حال تحديد تاريخ ووقت بدون سنة.
month

integer

اختياريّ. الشهر من السنة. يجب أن تكون القيمة من 1 إلى 12، أو 0 في حال تحديد تاريخ ووقت بدون شهر.
day

integer

اختياريّ. اليوم من الشهر يجب أن تكون القيمة بين 1 و31 وصالحة للسنة والشهر، أو 0 في حال تحديد تاريخ ووقت بدون يوم.
hours

integer

اختياريّ. ساعات اليوم بتنسيق 24 ساعة يجب أن تكون القيمة من 0 إلى 23، ويتم ضبطها تلقائيًا على 0 (منتصف الليل). قد تتيح واجهة برمجة التطبيقات استخدام القيمة "24:00:00" في سيناريوهات مثل وقت إغلاق النشاط التجاري.
minutes

integer

اختياريّ. دقائق الساعة من اليوم يجب أن تتراوح القيمة بين 0 و59، وتكون القيمة التلقائية 0.
seconds

integer

اختياريّ. ثواني دقائق الوقت يجب أن تتراوح القيمة عادةً بين 0 و59، ويتم ضبطها تلقائيًا على 0. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة.
nanos

integer

اختياريّ. أجزاء من الثواني بالنانو ثانية يجب أن تتراوح القيمة بين 0 و999,999,999، وتكون القيمة التلقائية 0.
حقل الربط time_offset اختياريّ. تحدّد هذه السمة إما معادلة التوقيت العالمي المنسّق أو المنطقة الزمنية لـ DateTime. يُرجى الاختيار بعناية بينهما، مع الأخذ في الاعتبار أنّ بيانات المنطقة الزمنية قد تتغيّر في المستقبل (على سبيل المثال، إذا عدّل بلد ما تواريخ بدء أو انتهاء التوقيت الصيفي، وتم تخزين قيم DateTime المستقبلية في النطاق المتأثر). في حال حذفها، يتم اعتبار DateTime بالتوقيت المحلي. يمكن أن يكون التعليق time_offset إحدى القيم التالية فقط:
utcOffset

string (Duration format)

فرق التوقيت العالمي المتفق عليه يجب أن تكون الثواني كاملة، بين -18 ساعة و+18 ساعة. على سبيل المثال، سيتم تمثيل فرق التوقيت عن توقيت غرينتش الذي يبلغ ‎-4:00 على النحو التالي: { seconds: -14400 }.

تمثّل هذه السمة مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s"، مثلاً: "3.5s".
timeZone

object (TimeZone)

المنطقة الزمنية

المدة

تمثيل JSON 
{
  "seconds": string,
  "nanos": integer
}
الحقول
seconds

string (int64 format)

الثواني الموقَّعة للفترة الزمنية يجب أن تتراوح القيمة بين ‎-315,576,000,000 و‎+315,576,000,000، بما في ذلك طرفي النطاق. ملاحظة: يتم احتساب هذه الحدود من: 60 ثانية/دقيقة * 60 دقيقة/ساعة * 24 ساعة/يوم * 365.25 يوم/سنة * 10000 سنة
nanos

integer

تشير هذه السمة إلى أجزاء الثانية الموقَّعة بدقة النانو ثانية للفترة الزمنية. يتم تمثيل المدد التي تقل عن ثانية واحدة بحقل seconds بقيمة 0 وحقل nanos موجب أو سالب. بالنسبة إلى المدد التي تبلغ ثانية واحدة أو أكثر، يجب أن تكون القيمة غير الصفرية لحقل nanos من العلامة نفسها لحقل seconds. يجب أن تتراوح القيمة بين ‎-999,999,999 و‎+999,999,999، بما في ذلك طرفي النطاق.

TimeZone

تمثيل JSON 
{
  "id": string,
  "version": string
}
الحقول
id

string

المنطقة الزمنية لقاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA). على سبيل المثال، "America/New_York".
version

string

اختياريّ. رقم إصدار قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA). على سبيل المثال "2019a".

PollenResultData

تمثيل JSON 
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
الحقول
dailyForecast

object (DailyPollenForecast)

التوقعات اليومية لانتشار حبوب اللقاح في التاريخ المطلوب
attribution

object (Attribution)

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

DailyPollenForecast

تمثيل JSON 
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
الحقول
date

object (Date)

تاريخ التقويم المدني للتوقّعات
categories[]

object (PollenCategoryInfo)

تفاصيل فئات حبوب اللقاح الرئيسية (الأشجار والأعشاب والأعشاب الضارة)
plantSpecies[]

object (PlantSpeciesInfo)

تقسيم دقيق لأنواع النباتات

PollenCategoryInfo

تمثيل JSON 
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
الحقول
displayName

string

اسم العرض الخاص بالفئة (مثل "شجرة" أو "عشب" أو "عشب ضار")
inSeason

boolean

ما إذا كانت فئة حبوب اللقاح هذه تتفتح بنشاط في المنطقة
index

object (PollenIndex)

قياس المؤشر العالمي لحبوب اللقاح (UPI) لهذه الفئة
healthRecommendations[]

string

نصائح صحية قابلة للتنفيذ للفئات الحساسة تجاه حبوب اللقاح

PollenIndex

تمثيل JSON 
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
الحقول
category

string

تصنيف الفئة المترجَمة (مثل "بلا" أو "منخفض جدًا" أو "منخفض" أو "معتدل" أو "مرتفع" أو "مرتفع جدًا")
description

string

وصف لمستوى خطر حبوب اللقاح

حقل الربط _value

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

integer

قيمة رقمية لمؤشر أداء المستخدم (مقياس من 0 إلى 5)

PlantSpeciesInfo

تمثيل JSON 
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
الحقول
code

string

رمز الفصيلة الذي يمكن معالجته آليًا (مثل "BIRCH" أو "JAPANESE_CEDAR" أو "RAGWEED")
displayName

string

الاسم المعروض المترجَم لنوع النبات (مثل "البتولا")
family

string

اسم العائلة النباتية (مثلاً، "القضبانية (عائلة البتولا)")
inSeason

boolean

تحدّد ما إذا كان هذا النوع من النباتات في موسمه حاليًا.
index

object (PollenIndex)

مقياس المؤشر العالمي لحبوب اللقاح (UPI) لهذا النوع
season

string

وصف لموسم الإزهار المعتاد (مثلاً، "أواخر الشتاء، الربيع")
crossReactions

string

مسبّبات الحساسية المعروفة ذات التفاعل التبادلي (مثل "حبوب لقاح جار الماء والبندق والزان والبلوط")

وحدة

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

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

المرحلة

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

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

النوع

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

ملاحظة: لا يتم حاليًا عرض الحالات التي تتضمّن القيم من 42 إلى 139 إلا للمواقع الجغرافية في اليابان وكوريا.

عمليات التعداد
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 عاصفة رعدية شديدة
CLEAR_AFTER_FOG_IN_THE_MORNING صافٍ بعد ظهور ضباب في الصباح
CLEAR_BUT_LATER_TURNING_CLOUDY الطقس صافٍ ولكن يتحول لاحقًا إلى غائم.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN صافٍ ولكن تتساقط أمطار وثلوج لاحقًا (أمطار بشكل أساسي)
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW صافٍ ولكن تتساقط ثلوج وأمطار لاحقًا (ثلوج بشكل أساسي)
CLEAR_BUT_THUNDERSTORMS_LATER الطقس صافٍ ولكن ستحدث عواصف رعدية لاحقًا.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING صافٍ في الصباح ولكنه يتحوّل إلى غائم في المساء
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING صافٍ في الصباح ولكن تتساقط أمطار لفترة وجيزة في المساء
CLEAR_MORNING_WITH_BRIEF_RAIN سيكون الطقس صافيًا في الصباح مع تساقط أمطار لفترة وجيزة.
CLEAR_WITH_BRIEF_RAIN طقس صافٍ مع تساقط القليل من الأمطار
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT صافٍ مع تساقط أمطار وثلوج لفترة وجيزة (أمطار بشكل أساسي)
CLEAR_WITH_BRIEF_RAIN_LATER الطقس صافٍ مع تساقط أمطار لفترة وجيزة لاحقًا.
CLEAR_WITH_BRIEF_SNOW طقس صافٍ مع تساقط القليل من الثلوج
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT صافٍ مع تساقط ثلوج وأمطار لفترة وجيزة (ثلوج بشكل أساسي)
CLEAR_WITH_BRIEF_SNOW_LATER طقس صافٍ مع تساقط القليل من الثلوج لاحقًا
CLEAR_WITH_PERIODIC_CLOUDS_LATER صافٍ مع تشكُّل غيوم من حين لآخر لاحقًا
CLEAR_WITH_PERIODIC_RAIN طقس صافٍ مع تساقط أمطار من حين لآخر
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER طقس صافٍ مع تساقط أمطار مصحوبة برعد من حين لآخر
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT صافٍ مع تساقط أمطار وثلوج من حين لآخر (أمطار بشكل أساسي)
CLEAR_WITH_PERIODIC_RAIN_LATER الطقس صافٍ مع تساقط أمطار من حين لآخر لاحقًا.
CLEAR_WITH_PERIODIC_SNOW طقس صافٍ مع تساقط الثلوج من فترة لأخرى
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT صافٍ مع تساقط ثلوج وأمطار من حين لآخر (ثلوج بشكل أساسي)
CLEAR_WITH_PERIODIC_SNOW_LATER طقس صافٍ مع تساقط الثلوج من فترة لأخرى لاحقًا
CLEAR_WITH_RAIN_AFTER_MIDNIGHT الطقس صافٍ مع تساقط أمطار بعد منتصف الليل.
CLEAR_WITH_RAIN_IN_THE_NIGHT طقس صافٍ مع تساقط الأمطار ليلاً
CLEAR_WITH_RAIN_LATER الطقس صافٍ مع تساقط الأمطار لاحقًا.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS طقس صافٍ مع تساقط ثلوج على طول الجبال
CLEAR_WITH_SNOW_LATER طقس صافٍ مع تساقط الثلوج لاحقًا
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS طقس صافٍ مع عواصف رعدية على طول الجبال
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON طقس صافٍ مع عواصف رعدية في فترة ما بعد الظهر
CLOUDY_BUT_CLEAR_LATER طقس غائم يتحول لاحقًا إلى صافٍ
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN غائم ولكن تتساقط أمطار وثلوج لاحقًا (أمطار بشكل أساسي)
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW غائم ولكن تتساقط ثلوج وأمطار لاحقًا (ثلوج بشكل أساسي)
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER طقس غائم وسيتحول لاحقًا إلى طقس صافٍ من حين لآخر
CLOUDY_BUT_THUNDERSTORMS_LATER طقس غائم يتحول إلى عواصف رعدية لاحقًا
CLOUDY_MORNING_WITH_BRIEF_RAIN طقس غائم في الصباح مصحوب بهطول أمطار لفترة وجيزة
CLOUDY_PERIODICALLY_CLEAR طقس غائم ويتحول إلى صافٍ من حين لآخر
CLOUDY_SNOWING_IN_THE_EVENING غائم مع تساقط ثلوج في المساء
CLOUDY_SNOWING_IN_THE_NIGHT غائم مع تساقط ثلوج ليلاً
CLOUDY_WITH_BRIEF_RAIN طقس غائم مع تساقط أمطار لفترة وجيزة
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT غائم مع تساقط أمطار وثلوج لفترة وجيزة (أمطار بشكل أساسي)
CLOUDY_WITH_BRIEF_RAIN_LATER طقس غائم مصحوب بهطول أمطار لفترة وجيزة لاحقًا
CLOUDY_WITH_BRIEF_SNOW طقس غائم مع تساقط ثلوج لفترة وجيزة
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT غائم مع تساقط ثلوج وأمطار لفترة وجيزة (ثلوج بشكل أساسي)
CLOUDY_WITH_BRIEF_SNOW_LATER طقس غائم مع تساقط ثلوج لفترة وجيزة لاحقًا
CLOUDY_WITH_BRIEF_THUNDERSTORM طقس غائم مصحوب بعاصفة رعدية لفترة وجيزة
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE غائم مع تشكُّل ضباب فوق المحيط وبالقرب من شاطئ البحر
CLOUDY_WITH_PERIODIC_RAIN طقس غائم مع تساقط أمطار من فترة لأخرى
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER طقس غائم مع تساقط أمطار مصحوبة بالرعد من حين لآخر
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT غائم مع تساقط أمطار وثلوج من حين لآخر (أمطار بشكل أساسي)
CLOUDY_WITH_PERIODIC_RAIN_LATER طقس غائم مع تساقط أمطار من حين لآخر لاحقًا
CLOUDY_WITH_PERIODIC_SNOW طقس غائم مع تساقط ثلوج من حين لآخر
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER طقس غائم مع تساقط ثلوج من حين لآخر مصحوبة برعد
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT غائم مع تساقط ثلوج وأمطار من حين لآخر (ثلوج بشكل أساسي)
CLOUDY_WITH_PERIODIC_SNOW_LATER طقس غائم مصحوب بتساقط ثلوج لاحقًا من حين لآخر
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT طقس غائم مع تساقط أمطار بعد منتصف الليل
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON طقس غائم مصحوب بتساقط أمطار بدايةً من فترة الظهيرة
CLOUDY_WITH_RAIN_FROM_EVENING طقس غائم مع تساقط أمطار ابتداءً من المساء
CLOUDY_WITH_RAIN_LATER طقس غائم مصحوب بهطول أمطار لاحقًا
CLOUDY_WITH_SNOW_FROM_AROUND_NOON غائم مع تساقط ثلوج ابتداءً من فترة الظهر تقريبًا
CLOUDY_WITH_SNOW_LATER طقس غائم مصحوب بتساقط ثلوج لاحقًا
FOG ضباب
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN تساقط أمطار وثلوج، ويتحوّل الطقس لاحقًا إلى صافٍ (أمطار بشكل أساسي)
RAINSNOW_MIX_RAIN_AS_MAIN تساقط أمطار وثلوج (أمطار بشكل أساسي)
RAINY_BUT_PERIODICALLY_CLEAR الطقس ممطر ولكن تصفو الأجواء من حين لآخر.
RAIN_ACCOMPANIED_BY_LIGHTNING أمطار مصحوبة ببرق
RAIN_ACCOMPANIED_BY_WINDSTORM أمطار مصحوبة بهبوب رياح
RAIN_CLEAR_AT_NIGHT طقس ممطر وتصفو الأجواء في الليل.
RAIN_CLEAR_FROM_AROUND_EVENING طقس ممطر وتصفو الأجواء ابتداءً من فترة المساء تقريبًا.
RAIN_CLEAR_FROM_AROUND_NOON طقس ممطر وتصفو الأجواء ابتداءً من فترة الظهر تقريبًا.
RAIN_LATER_BECOMING_CLEAR ممطر يتحوّل إلى صافٍ لاحقًا
RAIN_LATER_BECOMING_CLOUDY طقس ممطر يتحوّل إلى غائم لاحقًا
RAIN_LATER_BECOMING_SNOW أمطار تتحوّل إلى ثلوج لاحقًا
RAIN_LATER_WITH_PERIODIC_SNOW ممطر وتتساقط ثلوج من حين لآخر لاحقًا
RAIN_SNOW_AT_NIGHT ممطر مع تساقط ثلوج في الليل
RAIN_SNOW_IN_THE_EVENING ممطر مع تساقط ثلوج في المساء
RAIN_TEMPORARILY_BECOMING_SLEET أمطار تتحول إلى أمطار ثلجية مؤقتًا
RAIN_THAT_PERIODICALLY_STOPS تساقط أمطار من حين لآخر
RAIN_WITH_BRIEF_SNOW طقس ممطر مع تساقط القليل من الثلوج
RAIN_WITH_PERIODIC_SNOW طقس ممطر مع تساقط ثلوج من فترة لأخرى
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN تساقط ثلوج وأمطار (تساقط ثلوج بشكل أساسي) وتصفو الأجواء لاحقًا
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN تساقط ثلوج مع أمطار (ثلوج بشكل أساسي) ويتحوّل الطقس إلى غائم لاحقًا
SNOWRAIN_MIX_SNOW_AS_MAIN تساقط ثلوج مع أمطار (ثلوج بشكل أساسي)
SNOW_ACCOMPANIED_BY_LIGHTNING تساقط ثلوج مصحوبة ببرق
SNOW_BECOMING_SLEET تساقط ثلوج تتحول إلى أمطار ثلجية
SNOW_LATER_CLEAR تساقط ثلوج وتصفو الأجواء لاحقًا
SNOW_LATER_CLOUDY تساقط ثلوج ويصبح الطقس غائمًا لاحقًا
SNOW_LATER_RAIN تساقط ثلوج ولاحقًا أمطار
SNOW_PERIODICALLY_CLEAR تساقط ثلوج وتصفو الأجواء من حين لآخر
SNOW_THAT_PERIODICALLY_STOPS تساقط ثلوج من حين لآخر
SNOW_TURNING_TO_RAIN_AROUND_NOON تساقط ثلوج تتحول إلى أمطار في فترة الظهر تقريبًا
SNOW_TURNING_TO_RAIN_IN_THE_EVENING تساقط ثلوج تتحول إلى أمطار في المساء
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT تساقط ثلوج تتحوّل إلى أمطار في الليل
SNOW_WITH_BRIEF_RAIN تساقط ثلوج مصحوبة بأمطار لفترة وجيزة
SNOW_WITH_BRIEF_SLEET تساقط ثلوج مصحوبة بأمطار ثلجية لفترة وجيزة
SNOW_WITH_PERIODIC_RAIN تساقط ثلوج مصحوبة بأمطار من حين لآخر
VERY_HOT درجة حرارة السطح مرتفعة جدًا.
SLEET مطر ثلجي
HEAVY_RAIN_TO_RAINSTORM أمطار غزيرة قد تصل إلى عاصفة ممطرة

النوع

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

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

وحدة

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

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

أحمر داكن

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

عمليات التعداد
CARDINAL_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 الاتجاه الفرعي الثانوي بين الشمال والشمال الغربي

وحدة

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

عمليات التعداد
UNIT_UNSPECIFIED لم يتم تحديد وحدة السرعة.
KILOMETERS_PER_HOUR يتم قياس السرعة بالكيلومتر في الساعة.
MILES_PER_HOUR يتم قياس السرعة بالميل في الساعة.

وحدة

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

عمليات التعداد
UNIT_UNSPECIFIED وحدة التركيز غير محدّدة.
PARTS_PER_BILLION جزء في المليار (ppb)
MICROGRAMS_PER_CUBIC_METER ميكروغرام لكل متر مكعب (ميكروغرام/متر مكعب)

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

يتم إرسال تعليقات توضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الحالات التي قد يتم فيها إرسال طلب تأكيد إلى المستخدم.

إلى جانب سلسلة العنوان، يتم تحديد التلميحات المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة "صحيح"، لا تعدّل الأداة بيئتها. القيمة التلقائية: false
  • ‫destructiveHint: إذا كانت القيمة "صحيح"، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • ‫idempotentHint: إذا كانت القيمة "صحيح"، لن يؤدي استدعاء الأداة بشكل متكرّر باستخدام الوسيطات نفسها إلى أي تأثير إضافي على بيئتها. القيمة التلقائية: false
  • ‫openWorldHint: إذا كانت القيمة "صحيح"، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة "خطأ"، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، أداة بحث الويب هي أداة عالم مفتوح، بينما أداة الذاكرة ليست كذلك.

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