Method: currentConditions.lookup

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

طلب HTTP

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

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

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

المعلمات
location

object (LatLng)

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

enum (UnitsSystem)

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

string

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

نص الطلب

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

نص الاستجابة

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

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

تمثيل 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 (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 ساعة.

تمثيل JSON 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
الحقول
temperatureChange

object (Temperature)

درجة الحرارة الحالية مطروحًا منها درجة الحرارة قبل 24 ساعة
maxTemperature

object (Temperature)

الحد الأقصى لدرجة الحرارة (المرتفعة) في آخر 24 ساعة
minTemperature

object (Temperature)

الحد الأدنى لدرجة الحرارة (المنخفضة) في آخر 24 ساعة
snowQpf

object (QuantitativePrecipitationForecast)

كمية الثلوج المتوقّع تساقطها خلال فترة زمنية معيّنة، بافتراض عدم ذوبانها أو انضغاطها. ملاحظة: هذه هي كمية الثلوج الفعلية، وليس ما يعادلها من الماء السائل. ‫QPF هو اختصار لـ Quantitative Precipitation Forecast (يُرجى الاطّلاع على تعريف QuantitativePrecipitationForecast لمزيد من التفاصيل).
qpf

object (QuantitativePrecipitationForecast)

إجمالي مكافئ المياه السائلة لجميع أشكال هطول الأمطار (المطر والثلج والجليد وما إلى ذلك) المتوقّع هطولها خلال فترة زمنية معيّنة. ملاحظة: QPF هو اختصار لـ Quantitative Precipitation Forecast (يُرجى الاطّلاع على تعريف QuantitativePrecipitationForecast لمزيد من التفاصيل).