این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

REST Resource: dataLayers

منبع: DataLayers
- نمایندگی JSON
تاریخ
- نمایندگی JSON
ImageryQuality
مواد و روش ها

منبع: DataLayers

اطلاعاتی در مورد پتانسیل خورشیدی یک منطقه داده‌های واقعی در تعدادی از فایل‌های GeoTIFF که منطقه درخواستی را پوشش می‌دهند، وجود دارد که این پیام حاوی URL است: هر رشته در پیام DataLayers حاوی یک URL است که می‌توان GeoTIFF مربوطه را از آن واکشی کرد. این URL ها برای چند ساعت پس از تولید معتبر هستند. اکثر فایل‌های GeoTIFF با وضوح 0.1 متر بر پیکسل هستند، اما فایل شار ماهانه 0.5 متر بر پیکسل و فایل‌های سایه ساعتی 1 متر بر پیکسل هستند. اگر مقدار pixelSizeMeters در GetDataLayersRequest مشخص شده باشد، حداقل وضوح در فایل‌های GeoTIFF همان مقدار خواهد بود.

نمایندگی JSON

نمایندگی JSON
{ "imageryDate": { object (`Date`) }, "imageryProcessedDate": { object (`Date`) }, "dsmUrl": string, "rgbUrl": string, "maskUrl": string, "annualFluxUrl": string, "monthlyFluxUrl": string, "hourlyShadeUrls": [ string ], "imageryQuality": enum (`ImageryQuality`) }

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

زمینه های
`imageryDate`	`object ( Date )` زمانی که تصویر منبع (که تمام داده های دیگر از آن استخراج شده اند) در این منطقه گرفته شد. لزوماً تا حدودی تقریبی است، زیرا ممکن است تصاویر بیش از یک روز گرفته شده باشند.
`imageryProcessedDate`	`object ( Date )` زمانی که پردازش روی این تصویر تکمیل شد.
`dsmUrl`	`string` نشانی اینترنتی تصویری از DSM (مدل سطح دیجیتال) منطقه. مقادیر بر حسب متر بالاتر از ژئوئید EGM96 (یعنی سطح دریا) هستند. مکان های نامعتبر (جایی که داده نداریم) به عنوان -9999 ذخیره می شوند.
`rgbUrl`	`string` نشانی اینترنتی تصویری از داده های RGB (عکس هوایی) منطقه.
`maskUrl`	`string` URL برای تصویر ماسک ساختمان: یک بیت در هر پیکسل نشان می دهد که آیا آن پیکسل بخشی از یک پشت بام در نظر گرفته می شود یا خیر.
`annualFluxUrl`	`string` نشانی اینترنتی نقشه شار سالانه (نور خورشید سالانه روی پشت بام ها) منطقه. مقادیر kWh/kW/year هستند. این شار بدون نقاب است: شار برای هر مکان محاسبه می‌شود، نه فقط پشت بام ساختمان. مکان‌های نامعتبر به‌عنوان -9999 ذخیره می‌شوند: مکان‌های خارج از منطقه تحت پوشش ما نامعتبر خواهند بود، و چند مکان در داخل منطقه تحت پوشش، که نتوانستیم شار را محاسبه کنیم، نیز نامعتبر خواهند بود.
`monthlyFluxUrl`	`string` نشانی اینترنتی نقشه شار ماهانه (نور خورشید روی پشت بام ها، تفکیک شده بر اساس ماه) منطقه. مقادیر kWh/kW/year هستند. GeoTIFF که توسط این URL به آن اشاره شده است به ترتیب شامل دوازده باند مربوط به ژانویه...دسامبر خواهد بود.
`hourlyShadeUrls[]`	`string` به ترتیب دوازده URL برای سایه ساعتی، مربوط به ژانویه...دسامبر. هر GeoTIFF شامل 24 باند، مربوط به 24 ساعت روز است. هر پیکسل یک عدد صحیح 32 بیتی است که مربوط به (تا) 31 روز آن ماه است. a 1 bit به این معنی است که مکان مربوطه می تواند خورشید را در آن روز، آن ساعت، آن ماه ببیند. مکان‌های نامعتبر به‌عنوان 9999- ذخیره می‌شوند (از آنجایی که این منفی است، بیت 31 تنظیم شده است، و هیچ مقدار معتبری نمی‌تواند بیت 31 را تنظیم کند که مطابق با روز 32 ماه باشد). یک مثال ممکن است مفید باشد. اگر می خواهید بدانید که آیا نقطه ای (در مکان پیکسل (x، y)) خورشید را در ساعت 4 بعد از ظهر روز 22 ژوئن دیده است، باید: ششمین URL در این لیست (مرتبط با ژوئن) را واکشی کنید. کانال هفدهم (مطابق با ساعت 16) را جستجو کنید. مقدار 32 بیتی را در (x, y) بخوانید. بیت 21 مقدار (مرتبط با 22 ماه) را بخوانید. اگر آن بیت 1 باشد، آن نقطه خورشید را در ساعت 4 بعدازظهر 22 ژوئن دید. به طور رسمی تر: `month` (1-12)، `day` (حداکثر 1 ... ماه؛ فوریه 28 روز دارد) و `hour` (0-23)، سایه/خورشید برای آن ماه/روز/ساعت در یک موقعیت `(x, y)` بیت است `(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))` که در آن `(x, y)` نمایه سازی فضایی است، `[month - 1]` به واکشی نشانی اینترنتی `month - 1` اشاره دارد (نمایه سازی از صفر)، `[hour]` نمایه سازی در کانال ها است، و نتیجه نهایی غیر صفر به معنای "آفتابی" است. . هیچ روز کبیسه وجود ندارد و DST وجود ندارد (تمام روزها 24 ساعت طول می کشد؛ ظهر همیشه ظهر "زمان استاندارد" است).
`imageryQuality`	`enum ( ImageryQuality )` کیفیت تصویر نتیجه

تاریخ

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

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

انواع مرتبط:

google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp

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

زمینه های

زمینه های
`year`	`integer` سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.
`month`	`integer` ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.
`day`	`integer` روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

year

integer

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

month

integer

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

day

integer

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

ImageryQuality

کیفیت تصاویر مورد استفاده برای محاسبه برخی از نتایج API.

توجه: صرف نظر از سطح کیفیت تصویر، خروجی‌های DSM همیشه دارای وضوح 0.1 متر بر پیکسل، خروجی‌های شار ماهانه همیشه وضوح 0.5 متر بر پیکسل و خروجی‌های سایه ساعتی همیشه وضوح 1 متر بر پیکسل دارند.

Enums
`IMAGERY_QUALITY_UNSPECIFIED`	کیفیتی مشخص نیست
`HIGH`	تصاویر زیربنایی و داده های DSM با سرعت 0.1 متر بر پیکسل پردازش شدند.
`MEDIUM`	تصاویر زیربنایی و داده های DSM با 0.25 متر بر پیکسل پردازش شدند.
`LOW`	تصاویر زیربنایی و داده‌های DSM با سرعت 0.5 متر بر پیکسل پردازش شدند.

مواد و روش ها
`get`	اطلاعات خورشیدی را برای منطقه اطراف یک مکان دریافت می کند.

منبع: DataLayers
- نمایندگی JSON
تاریخ
- نمایندگی JSON
ImageryQuality
مواد و روش ها

منبع: DataLayers

اطلاعاتی در مورد پتانسیل خورشیدی یک منطقه داده‌های واقعی در تعدادی از فایل‌های GeoTIFF وجود دارد که منطقه درخواستی را پوشش می‌دهند، که این پیام حاوی URL است: هر رشته در پیام DataLayers حاوی یک URL است که می‌توان GeoTIFF مربوطه را از آن واکشی کرد. این URL ها برای چند ساعت پس از تولید معتبر هستند. اکثر فایل‌های GeoTIFF با وضوح 0.1 متر بر پیکسل هستند، اما فایل flux ماهانه 0.5 متر بر پیکسل و فایل‌های سایه ساعتی 1 متر بر پیکسل هستند. اگر مقدار pixelSizeMeters در GetDataLayersRequest مشخص شده باشد، حداقل وضوح در فایل‌های GeoTIFF همان مقدار خواهد بود.

نمایندگی JSON

نمایندگی JSON
{ "imageryDate": { object (`Date`) }, "imageryProcessedDate": { object (`Date`) }, "dsmUrl": string, "rgbUrl": string, "maskUrl": string, "annualFluxUrl": string, "monthlyFluxUrl": string, "hourlyShadeUrls": [ string ], "imageryQuality": enum (`ImageryQuality`) }

{
  "imageryDate": {
    object (Date)
  },
  "imageryProcessedDate": {
    object (Date)
  },
  "dsmUrl": string,
  "rgbUrl": string,
  "maskUrl": string,
  "annualFluxUrl": string,
  "monthlyFluxUrl": string,
  "hourlyShadeUrls": [
    string
  ],
  "imageryQuality": enum (ImageryQuality)
}

زمینه های
`imageryDate`	`object ( Date )` زمانی که تصویر منبع (که تمام داده های دیگر از آن استخراج شده اند) در این منطقه گرفته شد. لزوماً تا حدودی تقریبی است، زیرا ممکن است تصاویر بیش از یک روز گرفته شده باشند.
`imageryProcessedDate`	`object ( Date )` زمانی که پردازش روی این تصویر تکمیل شد.
`dsmUrl`	`string` نشانی اینترنتی تصویری از DSM (مدل سطح دیجیتال) منطقه. مقادیر بر حسب متر بالاتر از ژئوئید EGM96 (یعنی سطح دریا) هستند. مکان های نامعتبر (جایی که داده نداریم) به عنوان -9999 ذخیره می شوند.
`rgbUrl`	`string` نشانی اینترنتی تصویری از داده های RGB (عکس هوایی) منطقه.
`maskUrl`	`string` URL برای تصویر ماسک ساختمان: یک بیت در هر پیکسل نشان می دهد که آیا آن پیکسل بخشی از یک پشت بام در نظر گرفته می شود یا خیر.
`annualFluxUrl`	`string` نشانی اینترنتی نقشه شار سالانه (نور خورشید سالانه روی پشت بام ها) منطقه. مقادیر kWh/kW/year هستند. این شار بدون نقاب است: شار برای هر مکان محاسبه می‌شود، نه فقط پشت بام ساختمان. مکان‌های نامعتبر به‌عنوان -9999 ذخیره می‌شوند: مکان‌های خارج از منطقه تحت پوشش ما نامعتبر خواهند بود، و چند مکان در داخل منطقه تحت پوشش، که نتوانستیم شار را محاسبه کنیم، نیز نامعتبر خواهند بود.
`monthlyFluxUrl`	`string` نشانی اینترنتی نقشه شار ماهانه (نور خورشید روی پشت بام ها، تفکیک شده بر اساس ماه) منطقه. مقادیر kWh/kW/year هستند. GeoTIFF که توسط این URL به آن اشاره شده است به ترتیب شامل دوازده باند مربوط به ژانویه...دسامبر خواهد بود.
`hourlyShadeUrls[]`	`string` به ترتیب دوازده URL برای سایه ساعتی، مربوط به ژانویه...دسامبر. هر GeoTIFF شامل 24 باند، مربوط به 24 ساعت روز است. هر پیکسل یک عدد صحیح 32 بیتی است که مربوط به (تا) 31 روز آن ماه است. a 1 bit به این معنی است که مکان مربوطه می تواند خورشید را در آن روز، آن ساعت، آن ماه ببیند. مکان‌های نامعتبر به‌عنوان 9999- ذخیره می‌شوند (از آنجایی که این منفی است، بیت 31 تنظیم شده است، و هیچ مقدار معتبری نمی‌تواند بیت 31 را تنظیم کند که مطابق با روز 32 ماه باشد). یک مثال ممکن است مفید باشد. اگر می خواهید بدانید که آیا نقطه ای (در مکان پیکسل (x، y)) خورشید را در ساعت 4 بعد از ظهر روز 22 ژوئن دیده است، باید: ششمین URL در این لیست (مرتبط با ژوئن) را واکشی کنید. کانال هفدهم (مطابق با ساعت 16) را جستجو کنید. مقدار 32 بیتی را در (x, y) بخوانید. بیت 21 مقدار (مرتبط با 22 ماه) را بخوانید. اگر آن بیت 1 باشد، آن نقطه خورشید را در ساعت 4 بعدازظهر 22 ژوئن دید. به طور رسمی تر: `month` (1-12)، `day` (1... ماه حداکثر؛ فوریه 28 روز دارد) و `hour` (0-23)، سایه/خورشید برای آن ماه/روز/ساعت در یک موقعیت `(x, y)` بیت است `(hourly_shade[month - 1])(x, y)[hour] & (1 << (day - 1))` که در آن `(x, y)` نمایه سازی فضایی است، `[month - 1]` به واکشی نشانی اینترنتی `month - 1` اشاره دارد (نمایه سازی از صفر)، `[hour]` نمایه سازی در کانال ها است، و نتیجه نهایی غیر صفر به معنای "آفتابی" است. . هیچ روز کبیسه وجود ندارد و DST وجود ندارد (تمام روزها 24 ساعت طول می کشد؛ ظهر همیشه ظهر "زمان استاندارد" است).
`imageryQuality`	`enum ( ImageryQuality )` کیفیت تصویر نتیجه

تاریخ

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

انواع مرتبط:

google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp

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

زمینه های

زمینه های
`year`	`integer` سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.
`month`	`integer` ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.
`day`	`integer` روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

year

integer

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

month

integer

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

day

integer

ImageryQuality

کیفیت تصاویر مورد استفاده برای محاسبه برخی از نتایج API.

Enums
`IMAGERY_QUALITY_UNSPECIFIED`	کیفیتی مشخص نیست
`HIGH`	تصاویر زیربنایی و داده های DSM با سرعت 0.1 متر بر پیکسل پردازش شدند.
`MEDIUM`	تصاویر زیربنایی و داده های DSM با 0.25 متر بر پیکسل پردازش شدند.
`LOW`	تصاویر زیربنایی و داده‌های DSM با سرعت 0.5 متر بر پیکسل پردازش شدند.

مواد و روش ها
`get`	اطلاعات خورشیدی را برای منطقه اطراف یک مکان دریافت می کند.

REST Resource: dataLayers

منبع: DataLayers

تاریخ

ImageryQuality

مواد و روش ها

`get`

منبع: DataLayers

تاریخ

ImageryQuality

مواد و روش ها

`get`