Method: currentConditions.lookup

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

درخواست HTTP

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

نشانی وب از نحو تراتبدیل 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)

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

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

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

integer

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

integer

شاخص فرابنفش (UV) کنونی.
thunderstormProbability

integer

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

توجه: این فیلد از پاسخ برای مکان‌های ژاپن و کره جنوبی حذف شده است.
cloudCover

integer

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

توجه: این فیلد از پاسخ برای مکان‌های ژاپن و کره جنوبی حذف شده است.

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

به گستره OAuth زیر نیاز دارد:

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

CurrentConditionsHistory

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

نمایش 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 مخفف Quantitative Precipitation Forecast (پیش‌بینی کمی بارش) است (برای جزئیات بیشتر، لطفاً تعریف QuantitativePrecipitationForecast را ببینید).
qpf

object (QuantitativePrecipitationForecast)

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