Method: currentConditions.lookup

شرایط آب و هوایی فعلی را در یک مکان معین برمی گرداند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

پارامترها
location

object ( LatLng )

مورد نیاز. مکانی برای دریافت شرایط آب و هوایی فعلی.

units System

enum ( UnitsSystem )

اختیاری. سیستم واحد برای استفاده در شرایط آب و هوایی برگشتی. در صورت عدم ارائه، شرایط آب و هوایی برگشتی در سیستم متریک (پیش فرض = METRIC) خواهد بود.

language Code

string

اختیاری. به مشتری امکان می دهد زبان پاسخ را انتخاب کند. اگر داده‌ای برای آن زبان ارائه نشود، API از نزدیک‌ترین تطابق استفاده می‌کند. مقادیر مجاز بر اساس استاندارد IETF BCP-47 است. مقدار پیش فرض "en" است.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ برای currentConditions.lookup RPC - شرایط آب و هوایی فعلی را در مکان درخواستی نشان می دهد.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی 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
}
فیلدها
current Time

string ( Timestamp format)

زمان فعلی (UTC) مرتبط با داده های برگشتی.

از 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" .

time Zone

object ( TimeZone )

منطقه زمانی در مکان درخواستی

weather Condition

object ( WeatherCondition )

وضعیت آب و هوای فعلی.

temperature

object ( Temperature )

دمای فعلی.

feels Like Temperature

object ( Temperature )

اندازه گیری دمای فعلی در مکان درخواستی.

dew Point

object ( Temperature )

دمای نقطه شبنم فعلی

heat Index

object ( Temperature )

دمای شاخص حرارت فعلی

wind Chill

object ( Temperature )

سرمای فعلی باد، دمای هوا بر روی پوست قرار دارد.

precipitation

object ( Precipitation )

احتمال بارش فعلی و میزان بارندگی انباشته شده در یک ساعت گذشته.

air Pressure

object ( AirPressure )

شرایط فعلی فشار هوا

wind

object ( Wind )

شرایط فعلی باد

visibility

object ( Visibility )

دید فعلی

current Conditions History

object ( CurrentConditionsHistory )

تغییرات شرایط فعلی در 24 ساعت گذشته

is Daytime

boolean

درست است اگر زمان فعلی در مکان درخواستی بین زمان طلوع محلی (شامل) و غروب خورشید (انحصاری) باشد. در غیر این صورت شب است (بین غروب آفتاب تا طلوع بعدی).

relative Humidity

integer

درصد فعلی رطوبت نسبی (مقادیر از 0 تا 100).

uv Index

integer

شاخص فعلی فرابنفش (UV).

thunderstorm Probability

integer

احتمال رعد و برق فعلی (مقادیر از 0 تا 100).

cloud Cover

integer

درصد فعلی آسمان پوشیده از ابر (مقادیر از 0 تا 100).

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

تاریخچه شرایط فعلی

مجموعه ای از تغییرات در شرایط فعلی در 24 ساعت گذشته را نشان می دهد.

نمایندگی JSON 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
فیلدها
temperature Change

object ( Temperature )

دمای فعلی منهای دمای 24 ساعت قبل.

max Temperature

object ( Temperature )

حداکثر (بالا) دما در 24 ساعت گذشته.

min Temperature

object ( Temperature )

حداقل (پایین) دما در 24 ساعت گذشته.

qpf

object ( QuantitativePrecipitationForecast )

مقدار بارندگی (باران یا برف) که به عنوان معادل آب مایع اندازه گیری می شود که در 24 ساعت گذشته جمع شده است. توجه: QPF مخفف Quantitative Precipitation Forecast است (لطفاً برای جزئیات بیشتر به تعریف QuantitativePrecipitationForecast مراجعه کنید).