توضیح میدهد که چگونه سرویس EarthEngine باید یک تصویر را از مجموعهای از فایلها تشکیل دهد.
| نمایش JSON |
|---|
{ "name": string, "properties": { object }, "uriPrefix": string, "tilesets": [ { object ( |
| فیلدها | |
|---|---|
name | نام دارایی که قرار است ایجاد شود. |
properties | ویژگیهای اضافی دارایی. نامهای ویژگی "system:time_start" و "system:time_end" منسوخ شدهاند. به جای آنها از فیلدهای |
uriPrefix | پیشوند اختیاری به تمام |
tilesets[] | مجموعه کاشیها. هر مجموعه کاشی باید یک شناسه منحصر به فرد داشته باشد. |
bands[] | باندها. ترتیب باندهای یک دارایی مشابه ترتیب |
maskBands[] | نوارهای ماسک. |
footprint | مساحت تصویر (footprint) بر حسب مختصات پیکسلی (نه بر حسب مختصات عرض/طول). اگر خالی باشد، مساحت تصویر به طور پیشفرض کل تصویر است. برای توضیحات بیشتر در مورد مختصات پیکسلی به |
missingData | مقادیری که هیچ دادهای را در تمام باندهای تصویر نشان نمیدهند. برای تمام باندهایی که |
pyramidingPolicy | سیاست هرمیسازی. اگر مشخص نشود، سیاست MEAN به طور پیشفرض اعمال میشود. برای همه باندهایی که |
startTime | مهر زمانی مرتبط با دارایی، در صورت وجود، مثلاً زمانی که یک تصویر ماهوارهای گرفته شده است. برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند مقادیر میانگین در طول یک ماه یا سال، این مهر زمانی مربوط به شروع آن بازه زمانی است. از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
endTime | برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند میانگین مقادیر در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی است (به طور انحصاری). از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
skipMetadataRead | آیا از خواندن فراداده از فایلها با استفاده از GDAL صرف نظر شود. وقتی این فیلد درست باشد، tilesetها باید شامل فراداده کامل GDAL باشند: نوع داده، crs، تبدیل، ابعاد فایل، و بدون مقدار داده. |
memo | فیلد Freeform برای ذخیره یادداشتهای کاربر. در ingestion استفاده نمیشود. |
تایلستباند
نشان دهنده یک نوار واحد است که از یک مجموعه کاشی (tileset) تهیه شده است.
| نمایش JSON |
|---|
{ "id": string, "tilesetId": string, "tilesetBandIndex": integer, "missingData": { object ( |
| فیلدها | |
|---|---|
id | شناسنامه گروه موسیقی. |
tilesetId | شناسهی مجموعه کاشیهای مربوط به گروه. |
tilesetBandIndex | شاخص باند مبتنی بر صفر از مجموعه کاشی مربوط به باند. مثلاً اگر ۱ باشد، پیکسلهای باند، پیکسلهای باندی هستند که در شاخص ۱ مجموعه کاشی (در |
missingData | مقادیری که هیچ دادهای را در باند نشان نمیدهند. اگر |
pyramidingPolicy | سیاست هرمی سازی. |
کاشیستماسکبند
نشان دهنده یک نوار ماسک واحد است که از یک مجموعه کاشی تهیه شده است.
| نمایش JSON |
|---|
{ "tilesetId": string, "bandIds": [ string ] } |
| فیلدها | |
|---|---|
tilesetId | شناسهی مجموعه کاشیها (Tileset) مربوط به نوار ماسک. آخرین نوار مجموعه کاشیها همیشه به عنوان نوار ماسک استفاده میشود. |
bandIds[] | شناسههای باندهایی که باند ماسک به آنها اعمال میشود. اگر خالی باشد، باند ماسک به تمام باندهای موجود در دارایی اعمال میشود. هر باند فقط میتواند یک باند ماسک مربوطه داشته باشد. اگر هر یک از این باندها دارای ماسک داخلی باشند، ماسک داخلی به نفع این باند ماسک نادیده گرفته میشود. |
ردپای پیکسل
ردپایی از تمام پیکسلهای معتبر در یک تصویر.
| نمایش JSON |
|---|
{
"points": [
{
object ( |
| فیلدها | |
|---|---|
points[] | حلقهای که نمای بیرونی یک چندضلعی ساده را تشکیل میدهد که باید شامل مراکز تمام پیکسلهای معتبر تصویر باشد. این باید یک حلقه خطی باشد: آخرین نقطه باید برابر با اولین نقطه باشد. مختصات در تصویر باند مشخص شده توسط نکته: از مختصات غیرصحیح مانند مرکز هر پیکسل استفاده کنید زیرا اگر پیکسل (یک مستطیل ۱x۱) ردپا را قطع کند، ردپا شامل یک پیکسل میشود. برای جلوگیری از انتخاب تصادفی پیکسلهای همسایه، از مختصات با مقدار صحیح استفاده نکنید، زیرا آنها مرزهای بین پیکسلها هستند. رسم ردپا در امتداد مراکز پیکسل از گنجاندن پیکسلهای ناخواسته جلوگیری میکند، که میتواند باعث ایجاد خطا در زمانی شود که پیکسلهای مورد نظر در مجاورت مرز نقشه مانند خط پادمریدین یا یک قطب قرار دارند. برای مثال، برای یک تصویر ۲x۲ با هر ۴ پیکسل معتبر، یک حلقه ممکن به صورت زیر است: [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}] |
bandId | شناسه باندی که CRS آن مختصات ردپا را تعریف میکند. اگر خالی باشد، از باند اول استفاده میشود. |
گریدپوینت
یک نقطه یا بردار دوبعدی.
| نمایش JSON |
|---|
{ "x": number, "y": number } |
| فیلدها | |
|---|---|
x | مقدار مختصات x. |
y | مقدار مختصات y. |
توضیح میدهد که چگونه سرویس EarthEngine باید یک تصویر را از مجموعهای از فایلها تشکیل دهد.
| نمایش JSON |
|---|
{ "name": string, "properties": { object }, "uriPrefix": string, "tilesets": [ { object ( |
| فیلدها | |
|---|---|
name | نام دارایی که قرار است ایجاد شود. |
properties | ویژگیهای اضافی دارایی. نامهای ویژگی "system:time_start" و "system:time_end" منسوخ شدهاند. به جای آنها از فیلدهای |
uriPrefix | پیشوند اختیاری به تمام |
tilesets[] | مجموعه کاشیها. هر مجموعه کاشی باید یک شناسه منحصر به فرد داشته باشد. |
bands[] | باندها. ترتیب باندهای یک دارایی مشابه ترتیب |
maskBands[] | نوارهای ماسک. |
footprint | مساحت تصویر (footprint) بر حسب مختصات پیکسلی (نه بر حسب مختصات عرض/طول). اگر خالی باشد، مساحت تصویر به طور پیشفرض کل تصویر است. برای توضیحات بیشتر در مورد مختصات پیکسلی به |
missingData | مقادیری که هیچ دادهای را در تمام باندهای تصویر نشان نمیدهند. برای تمام باندهایی که |
pyramidingPolicy | سیاست هرمیسازی. اگر مشخص نشود، سیاست MEAN به طور پیشفرض اعمال میشود. برای همه باندهایی که |
startTime | مهر زمانی مرتبط با دارایی، در صورت وجود، مثلاً زمانی که یک تصویر ماهوارهای گرفته شده است. برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند مقادیر میانگین در طول یک ماه یا سال، این مهر زمانی مربوط به شروع آن بازه زمانی است. از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
endTime | برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند میانگین مقادیر در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی است (به طور انحصاری). از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
skipMetadataRead | آیا از خواندن فراداده از فایلها با استفاده از GDAL صرف نظر شود. وقتی این فیلد درست باشد، tilesetها باید شامل فراداده کامل GDAL باشند: نوع داده، crs، تبدیل، ابعاد فایل، و بدون مقدار داده. |
memo | فیلد Freeform برای ذخیره یادداشتهای کاربر. در ingestion استفاده نمیشود. |
تایلستباند
نشان دهنده یک نوار واحد است که از یک مجموعه کاشی (tileset) تهیه شده است.
| نمایش JSON |
|---|
{ "id": string, "tilesetId": string, "tilesetBandIndex": integer, "missingData": { object ( |
| فیلدها | |
|---|---|
id | شناسنامه گروه موسیقی. |
tilesetId | شناسهی مجموعه کاشیهای مربوط به گروه. |
tilesetBandIndex | شاخص باند مبتنی بر صفر از مجموعه کاشی مربوط به باند. مثلاً اگر ۱ باشد، پیکسلهای باند، پیکسلهای باندی هستند که در شاخص ۱ مجموعه کاشی (در |
missingData | مقادیری که هیچ دادهای را در باند نشان نمیدهند. اگر |
pyramidingPolicy | سیاست هرمی سازی. |
کاشیستماسکبند
نشان دهنده یک نوار ماسک واحد است که از یک مجموعه کاشی تهیه شده است.
| نمایش JSON |
|---|
{ "tilesetId": string, "bandIds": [ string ] } |
| فیلدها | |
|---|---|
tilesetId | شناسهی مجموعه کاشیها (Tileset) مربوط به نوار ماسک. آخرین نوار مجموعه کاشیها همیشه به عنوان نوار ماسک استفاده میشود. |
bandIds[] | شناسههای باندهایی که باند ماسک به آنها اعمال میشود. اگر خالی باشد، باند ماسک به تمام باندهای موجود در دارایی اعمال میشود. هر باند فقط میتواند یک باند ماسک مربوطه داشته باشد. اگر هر یک از این باندها دارای ماسک داخلی باشند، ماسک داخلی به نفع این باند ماسک نادیده گرفته میشود. |
ردپای پیکسل
ردپایی از تمام پیکسلهای معتبر در یک تصویر.
| نمایش JSON |
|---|
{
"points": [
{
object ( |
| فیلدها | |
|---|---|
points[] | حلقهای که نمای بیرونی یک چندضلعی ساده را تشکیل میدهد که باید شامل مراکز تمام پیکسلهای معتبر تصویر باشد. این باید یک حلقه خطی باشد: آخرین نقطه باید برابر با اولین نقطه باشد. مختصات در تصویر باند مشخص شده توسط نکته: از مختصات غیرصحیح مانند مرکز هر پیکسل استفاده کنید زیرا اگر پیکسل (یک مستطیل ۱x۱) ردپا را قطع کند، ردپا شامل یک پیکسل میشود. برای جلوگیری از انتخاب تصادفی پیکسلهای همسایه، از مختصات با مقدار صحیح استفاده نکنید، زیرا آنها مرزهای بین پیکسلها هستند. رسم ردپا در امتداد مراکز پیکسل از گنجاندن پیکسلهای ناخواسته جلوگیری میکند، که میتواند باعث ایجاد خطا در زمانی شود که پیکسلهای مورد نظر در مجاورت مرز نقشه مانند خط پادمریدین یا یک قطب قرار دارند. برای مثال، برای یک تصویر ۲x۲ با هر ۴ پیکسل معتبر، یک حلقه ممکن به صورت زیر است: [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}] |
bandId | شناسه باندی که CRS آن مختصات ردپا را تعریف میکند. اگر خالی باشد، از باند اول استفاده میشود. |
گریدپوینت
یک نقطه یا بردار دوبعدی.
| نمایش JSON |
|---|
{ "x": number, "y": number } |
| فیلدها | |
|---|---|
x | مقدار مختصات x. |
y | مقدار مختصات y. |