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)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
الحقول
temperatureChange

object (Temperature)

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

object (Temperature)

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

object (Temperature)

أدنى درجة حرارة (أدنى) في آخر 24 ساعة
qpf

object (QuantitativePrecipitationForecast)

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