Method: currentConditions.lookup

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
location

object ( LatLng )

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

unitsSystem

enum ( UnitsSystem )

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

languageCode

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
}
فیلدها
currentTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 )

تغییرات در شرایط فعلی طی ۲۴ ساعت گذشته.

isDaytime

boolean

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

relativeHumidity

integer

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

uvIndex

integer

شاخص فعلی اشعه ماوراء بنفش (UV).

thunderstormProbability

integer

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

cloudCover

integer

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

دامنه‌های مجوز

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

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

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

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

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

object ( Temperature )

دمای فعلی منهای دمای ۲۴ ساعت پیش.

maxTemperature

object ( Temperature )

حداکثر (بالاترین) دما در ۲۴ ساعت گذشته.

minTemperature

object ( Temperature )

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

snowQpf

object ( QuantitativePrecipitationForecast )

مقدار برفی که در ۲۴ ساعت گذشته انباشته شده است، به صورت معادل آب مایع اندازه‌گیری می‌شود. توجه: QPF مخفف پیش‌بینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیش‌بینی کمی بارش مراجعه کنید).

qpf

object ( QuantitativePrecipitationForecast )

میزان بارندگی، که به صورت معادل آب مایع اندازه‌گیری می‌شود و در طول ۲۴ ساعت گذشته انباشته شده است. توجه: QPF مخفف پیش‌بینی کمی بارش است (برای جزئیات بیشتر، لطفاً به تعریف پیش‌بینی کمی بارش مراجعه کنید).