Method: forecast.days.lookup

تا 10 روز پیش‌بینی‌های روزانه را در یک مکان مشخص، از روز جاری، برمی‌گرداند.

درخواست HTTP

GET https://weather.googleapis.com/v1/forecast/days:lookup

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

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

پارامترها
location

object ( LatLng )

مورد نیاز. مکانی برای دریافت پیش بینی روزانه.

units System

enum ( UnitsSystem )

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

page Size

integer

اختیاری. حداکثر تعداد رکوردهای پیش بینی روزانه برای بازگشت در هر صفحه - مقداری از 1 تا 10 (شامل). مقدار پیش فرض 5 است.

page Token

string

اختیاری. نشانه صفحه دریافت شده از درخواست قبلی. برای بازیابی صفحه بعدی استفاده می شود.

days

integer

اختیاری. تعداد کل روزها را برای واکشی از روز جاری محدود می کند - مقداری از 1 تا 10 (شامل). مقدار پیش فرض حداکثر مقدار مجاز 10 است.

language Code

string

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

درخواست بدن

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

بدن پاسخگو

پاسخ برای days.lookup RPC.

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

نمایندگی JSON 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
فیلدها
forecast Days[]

object ( ForecastDay )

رکوردهای پیش بینی روزانه، با توجه به تعداد روز و اندازه صفحه مشخص شده در درخواست.

time Zone

object ( TimeZone )

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

next Page Token

string

نشانه برای بازیابی صفحه بعدی.

محدوده مجوز

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

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

روز پیش بینی

یک رکورد پیش بینی روزانه را در یک مکان معین نشان می دهد.

نمایندگی JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
فیلدها
interval

object ( Interval )

فاصله زمانی UTC زمانی که این روز پیش بینی شده شروع می شود (شامل) و پایان می یابد (انحصاری). توجه: یک روز از ساعت 7 صبح شروع می شود و در ساعت 7 صبح روز بعد به وقت محلی به پایان می رسد. به عنوان مثال: اگر منطقه زمانی محلی UTC-7 باشد، این بازه زمانی در ساعت 14:00:00.000Z شروع می شود و در همان ساعت روز بعد به پایان می رسد.

display Date

object ( Date )

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

daytime Forecast

object ( ForecastDayPart )

وضعیت آب و هوای پیش بینی شده برای بخشی از روز (7 صبح تا 7 بعد از ظهر به وقت محلی).

nighttime Forecast

object ( ForecastDayPart )

شرایط آب و هوایی پیش‌بینی‌شده برای نیمه شبانه روز (7 بعد از ظهر تا 7 صبح روز بعد، به وقت محلی).

max Temperature

object ( Temperature )

حداکثر (بالا) دما در طول روز.

min Temperature

object ( Temperature )

حداقل (کم) دما در طول روز.

feels Like Max Temperature

object ( Temperature )

حداکثر (بالا) درجه حرارت مانند احساس در طول روز.

feels Like Min Temperature

object ( Temperature )

حداقل (پایین) درجه حرارت مانند احساس در طول روز.

max Heat Index

object ( Temperature )

حداکثر دمای شاخص گرما در طول روز.

sun Events

object ( SunEvents )

رویدادهای مربوط به خورشید (مثلاً طلوع، غروب خورشید).

moon Events

object ( MoonEvents )

رویدادهای مربوط به ماه (به عنوان مثال طلوع ماه، غروب ماه).

ice Thickness

object ( IceThickness )

مقدار یخ انباشته شده در طول روز.

تاریخ

نمایانگر یک تاریخ تقویم کامل یا جزئی، مانند روز تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده است یا ناچیز است. تاریخ مربوط به تقویم میلادی است. این می تواند نشان دهنده یکی از موارد زیر باشد:

  • تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
  • یک ماه و روز، با یک سال صفر (مثلاً یک سالگرد).
  • یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
  • یک سال و یک ماه، با روز صفر (مثلاً تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایندگی JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.

month

integer

ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.

day

integer

روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

ForecastDayPart

یک رکورد پیش بینی برای بخشی از روز را نشان می دهد.

نمایندگی JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
فیلدها
interval

object ( Interval )

تاریخ و زمان UTC که این قسمت از روز شروع می شود (شامل) و پایان می یابد (انحصاری). توجه: بخشی از یک روز از ساعت 7 صبح شروع می شود و در ساعت 19 همان روز به وقت محلی به پایان می رسد. به عنوان مثال: اگر منطقه زمانی محلی UTC-7 باشد، بازه زمانی روز در ساعت 14:00:00.000Z شروع می شود و در 02:00:00.000Z روز بعد به پایان می رسد و فاصله زمانی شبانه در 02:00:00.000Z روز بعد شروع می شود و در 14:00:00.000Z آن روز به پایان می رسد.

weather Condition

object ( WeatherCondition )

وضعیت آب و هوای پیش بینی شده

precipitation

object ( Precipitation )

بارش پیش بینی شده

wind

object ( Wind )

میانگین جهت باد و حداکثر سرعت و وزش باد.

relative Humidity

integer

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

uv Index

integer

حداکثر شاخص ماوراء بنفش (UV) پیش بینی شده.

thunderstorm Probability

integer

میانگین احتمال رعد و برق

cloud Cover

integer

میانگین درصد پوشش ابر

SunEvents

وقایع مربوط به خورشید (مثلا طلوع، غروب خورشید) را نشان می دهد.

نمایندگی JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
فیلدها
sunrise Time

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

sunset Time

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

رویدادهای ماه

وقایع مربوط به ماه را نشان می دهد (به عنوان مثال طلوع ماه، غروب ماه).

نمایندگی JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
فیلدها
moonrise Times[]

string ( Timestamp format)

زمانی که اندام فوقانی ماه در بالای افق ظاهر می شود (به https://en.wikipedia.org/wiki/Moonrise_and_moonset مراجعه کنید) .

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

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

moonset Times[]

string ( Timestamp format)

زمانی که اندام بالایی ماه در زیر افق ناپدید می شود (به https://en.wikipedia.org/wiki/Moonrise_and_moonset مراجعه کنید) .

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

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

moon Phase

enum ( MoonPhase )

فاز ماه (معروف به فاز قمری).

فاز ماه

فاز ماه (معروف به فاز قمری) را مشخص می کند.

Enums
MOON_PHASE_UNSPECIFIED فاز ماه نامشخص
NEW_MOON ماه توسط خورشید روشن نمی شود.
WAXING_CRESCENT ماه در سمت راستش در نیمکره شمالی 0 تا 50 درصد و در نیمکره جنوبی در سمت چپش 🌘 روشن می شود.
FIRST_QUARTER ماه در سمت راستش در نیمکره شمالی 🌓 50.1 درصد و در نیمکره جنوبی در سمت چپش 🌗 روشن می شود.
WAXING_GIBBOUS ماه در سمت راستش در نیمکره شمالی 50 تا 100 درصد و در نیمکره جنوبی در سمت چپش 🌖 روشن می شود.
FULL_MOON ماه کاملاً روشن است.
WANING_GIBBOUS ماه در نیمکره شمالی 50 تا 100 درصد در سمت چپ و در نیمکره جنوبی در سمت راستش روشن می شود.
LAST_QUARTER ماه در نیمکره شمالی 50.1% در سمت چپ و در نیمکره جنوبی در سمت راست خود روشن می شود.
WANING_CRESCENT ماه در سمت چپش در نیمکره شمالی 0%-50% و در سمت راستش در نیمکره جنوبی 🌒 روشن می شود.