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)

كمية الثلوج التي تراكمت خلال آخر 24 ساعة، ويتم قياسها على أنّها كمية المياه السائلة المكافئة. ملاحظة: QPF هو اختصار لعبارة "توقعات كمية هطول الأمطار" (يُرجى الاطّلاع على تعريف QuantitativePrecipitationForecast لمزيد من التفاصيل).
qpf

object (QuantitativePrecipitationForecast)

كمية هطول الأمطار، التي يتم قياسها كمكافئ للمياه السائلة، والتي تراكمت على مدار آخر 24 ساعة ملاحظة: QPF هو اختصار لعبارة "توقعات كمية هطول الأمطار" (يُرجى الاطّلاع على تعريف QuantitativePrecipitationForecast لمزيد من التفاصيل).