الحصول على مفتاح Maps Demo Key: يمكنك تجربة Weather API بدون أي تكلفة باستخدام مفتاح Maps Demo Key، ولا يلزم توفير معلومات الفوترة.

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

Method: currentConditions.lookup

طلب HTTP
معامِلات طلب البحث
نص الطلب
نص الاستجابة
- تمثيل JSON
نطاقات الأذونات
CurrentConditionsHistory
- تمثيل JSON
جرِّبه الآن

تعرض هذه الأداة أحوال الطقس الحالية في موقع جغرافي معيّن.

طلب HTTP

GET https://weather.googleapis.com/v1/currentConditions:lookup

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات

المعلمات
`location`	`object (LatLng)` الحقل مطلوب. الموقع الجغرافي الذي تريد معرفة أحوال الطقس الحالية فيه
`unitsSystem`	`enum (UnitsSystem)` اختياريّ. نظام الوحدات المطلوب استخدامه لأحوال الطقس التي يتم عرضها وفي حال عدم توفيرها، ستكون أحوال الطقس التي يتم عرضها بالنظام المتري (القيمة التلقائية = METRIC).
`languageCode`	`string` اختياريّ. تسمح هذه المَعلمة للعميل باختيار لغة الردّ. إذا تعذّر توفير البيانات لتلك اللغة، تستخدم واجهة برمجة التطبيقات أقرب لغة مطابقة. تعتمد القيم المسموح بها على معيار IETF BCP-47. والقيمة التلقائية لهذه المعلمة هي "en".

location

object (LatLng)

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

unitsSystem

enum (UnitsSystem)

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

languageCode

string

اختياريّ. تسمح هذه المَعلمة للعميل باختيار لغة الردّ. إذا تعذّر توفير البيانات لتلك اللغة، تستخدم واجهة برمجة التطبيقات أقرب لغة مطابقة. تعتمد القيم المسموح بها على معيار IETF BCP-47. والقيمة التلقائية لهذه المعلمة هي "en".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الاستجابة لطلب RPC الخاص بـ currentConditions.lookup، ويمثّل أحوال الطقس الحالية في الموقع الجغرافي المطلوب

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON

تمثيل JSON
{ "currentTime": string, "timeZone": { object (`TimeZone`) }, "weatherCondition": { object (`WeatherCondition`) }, "temperature": { object (`Temperature`) }, "feelsLikeTemperature": { object (`Temperature`) }, "dewPoint": { object (`Temperature`) }, "heatIndex": { object (`Temperature`) }, "windChill": { object (`Temperature`) }, "precipitation": { object (`Precipitation`) }, "airPressure": { object (`AirPressure`) }, "wind": { object (`Wind`) }, "visibility": { object (`Visibility`) }, "currentConditionsHistory": { object (`CurrentConditionsHistory`) }, "isDaytime": boolean, "relativeHumidity": integer, "uvIndex": integer, "thunderstormProbability": integer, "cloudCover": integer }

{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}

الحقول
`currentTime`	`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"`
`timeZone`	`object (TimeZone)` المنطقة الزمنية في الموقع الجغرافي المطلوب
`weatherCondition`	`object (WeatherCondition)` حالة الطقس الحالية
`temperature`	`object (Temperature)` درجة الحرارة الحالية
`feelsLikeTemperature`	`object (Temperature)` مقياس لدرجة الحرارة الظاهرية حاليًا في الموقع الجغرافي المطلوب
`dewPoint`	`object (Temperature)` درجة حرارة نقطة الندى الحالية
`heatIndex`	`object (Temperature)` درجة الحرارة الحالية لمؤشر الحرارة
`windChill`	`object (Temperature)` درجة برودة الرياح الحالية، وهي درجة حرارة الهواء التي يشعر بها الجلد ملاحظة: يعرض هذا الحقل عنصرًا فارغًا للمواقع الجغرافية في اليابان وكوريا الجنوبية.
`precipitation`	`object (Precipitation)` احتمال هطول الأمطار الحالي وكمية الأمطار المتراكمة خلال الساعة الأخيرة
`airPressure`	`object (AirPressure)` حالة الضغط الجوي الحالية
`wind`	`object (Wind)` أحوال الرياح الحالية
`visibility`	`object (Visibility)` مستوى الظهور الحالي ملاحظة: يعرض هذا الحقل عنصرًا فارغًا للمواقع الجغرافية في اليابان وكوريا الجنوبية.
`currentConditionsHistory`	`object (CurrentConditionsHistory)` التغييرات في الظروف الحالية خلال آخر 24 ساعة
`isDaytime`	`boolean` يتم عرض "صحيح" إذا كان الوقت الحالي في الموقع الجغرافي المطلوب يقع بين وقت شروق الشمس (شاملاً) ووقت غروب الشمس (غير شامل) في المنطقة الزمنية المحلية. وإلا، يكون الوقت ليلاً (بين غروب الشمس وشروقها في اليوم التالي).
`relativeHumidity`	`integer` النسبة المئوية الحالية للرطوبة النسبية (القيم من 0 إلى 100)
`uvIndex`	`integer` مؤشّر الأشعة فوق البنفسجية الحالي
`thunderstormProbability`	`integer` احتمال حدوث عاصفة رعدية حاليًا (القيم من 0 إلى 100) ملاحظة: يتم حذف هذا الحقل من الردّ للمواقع الجغرافية في اليابان وكوريا الجنوبية.
`cloudCover`	`integer` النسبة المئوية الحالية للسماء التي تغطيها السحب (القيم من 0 إلى 100). ملاحظة: يتم حذف هذا الحقل من الردّ للمواقع الجغرافية في اليابان وكوريا الجنوبية.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

https://www.googleapis.com/auth/cloud-platform

CurrentConditionsHistory

تمثّل مجموعة من التغييرات في الظروف الحالية خلال آخر 24 ساعة.