بارگذاری مانیفست تصویر

اگر برای بارگذاری تصاویر در Google Earth Engine (EE) به انعطاف‌پذیری بیشتری نسبت‌به آنچه میانای کاربر Code Editor یا فرمان upload ابزار خط فرمان «earthengine» ارائه می‌دهد نیاز دارید، می‌توانید این کار را با توصیف بارگذاری تصویر بااستفاده از فایل JSON که به‌عنوان «مانیفست» شناخته می‌شود و بااستفاده از فرمان upload image --manifest ابزار خط فرمان انجام دهید.

نمونه کامل را در این دفتر Colab ببینید که بارگذاری کاشی‌های تصویر را به‌عنوان یک دارایی واحد بااستفاده از مانیفست نشان می‌دهد.

راه‌اندازی یک‌باره

  1. بارگذاری مانیفست فقط با فایل‌های موجود در Google Cloud Storage کار می‌کند. برای شروع استفاده از Google Cloud Storage، پروژه Google Cloud ایجاد کنید، اگر ازقبل ندارید. توجه داشته باشید که راه‌اندازی مستلزم مشخص کردن کارت اعتباری برای صورت‌حساب است. در این مرحله، EE خودش هزینه‌ای از کسی دریافت نمی‌کند، اما انتقال فایل‌ها به Google Cloud Storage قبل‌از بارگذاری آن‌ها در EE هزینه کمی خواهد داشت. برای اندازه داده‌های بارگذاری معمولی (ده‌ها یا صدها گیگابایت)، هزینه بسیار کم خواهد بود.
  2. در پروژه‌تان، Cloud Storage API را روشن کنید و یک bucket ایجاد کنید.
  3. نصب کردن کلاینت Python در Earth Engine. این ابزار شامل ابزار خط فرمان earthengine است که از آن برای بارگذاری داده‌ها استفاده خواهیم کرد.
  4. برای بارگذاری‌های خودکار، شاید بخواهید از حساب سرویس Google Cloud مرتبط با پروژه‌تان استفاده کنید. برای آزمایش به حساب سرویس نیاز ندارید، اما وقتی فرصت داشتید، لطفاً با نحوه استفاده از آن‌ها آشنا شوید.

فایل‌های منبع بسیار بزرگ (۱۰۰ گیگابایت یا بیشتر) اگر به چند کاشی تقسیم شوند، ممکن است سریع‌تر بارگذاری شوند.

شناسه‌ها و نام‌های دارایی

برای دارایی‌های تحت مالکیت پروژه Cloud، از این قرارداد برای نام دارایی‌ها استفاده کنید: projects/some-project-id/assets/some-asset-id.

درباره نام دارایی‌ها برای پروژه قدیمی و دارایی‌های تحت مالکیت کاربر بیشتر بدانید

برای پروژه‌های قدیمی‌تر، نام دارایی در مانیفست باید کمی با شناسه دارایی قابل‌مشاهده در جاهای دیگر Earth Engine متفاوت باشد. برای بارگذاری دارایی‌هایی که شناسه دارایی آن‌ها با users/some_user یا projects/some_project شروع می‌شود، نام دارایی در مانیفست باید رشته projects/earthengine-legacy/assets/ را به شناسه اضافه کند. برای مثال، شناسه دارایی EE users/username/my_geotiff باید بااستفاده از نام projects/earthengine-legacy/assets/users/username/my_geotiff بارگذاری شود.

بله، یعنی شناسه‌هایی مثل projects/some_projects/some_asset به نام‌هایی تبدیل می‌شوند که در آن‌ها projects دو بار ذکر شده است: projects/earthengine-legacy/assets/projects/some_projects/some_asset. این موضوع گیج‌کننده است اما برای مطابقت با استانداردهای Google Cloud API ضروری است.

استفاده از مانیفست‌ها

یک مانیفست پایه در بلوک کد زیر نشان داده شده است. فایلی با نام small.tif را از مخزن Google Cloud Storage با نام gs://earthengine-test بارگذاری می‌کند.

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://earthengine-test/small.tif"
          ]
        }
      ]
    }
  ]
}

برای استفاده از آن، آن را در فایلی با نام manifest.json ذخیره کنید و اجرا کنید:

earthengine upload image --manifest /path/to/manifest.json

(فایل gs://earthengine-test/small.tif وجود دارد و به‌طور عمومی قابل‌خواندن است - می‌توانید از آن برای آزمایش استفاده کنید.)

مجموعه کاشی‌ها

ساختار مانیفست تا حدودی پیچیده JSON برای ارائه انعطاف‌پذیری کافی برای رسیدگی به یک چالش رایج بارگذاری ضروری است: نحوه توصیف همه راه‌های ممکن برای ترکیب پیکسل‌ها از چندین فایل منبع در یک دارایی واحد. به‌طور خاص، دو روش مستقل برای گروه‌بندی فایل‌ها باهم وجود دارد:

  • موزاییک. گاهی اوقات چندین فایل نشان‌دهنده چندین کاشی هستند (برای مثال، هر کاشی یک مربع ۱×۱ درجه است). چنین فایل‌هایی باید موزاییک‌کاری (باهم ادغام) شوند تا در یک باند در دارایی EE قرار گیرند.
  • باندها را جدا کنید. گاهی اوقات، چند فایل نشان‌دهنده چند باند است. چنین فایل‌هایی باید به‌عنوان باند در دارایی EE باهم دسته‌بندی شوند.

(ممکن است لازم باشد از هر دو روش به‌طور هم‌زمان استفاده شود، اما این وضعیت به‌ندرت پیش می‌آید.)

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

برای دریافت موزاییکی، مانیفست به این شکل خواهد بود:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/N30W22.tif"
          ]
        },
        {
          "uris": [
            "gs://bucket/N31W22.tif"
          ]
        }
      ]
    }
  ]
}

برای باندهای جداگانه، مانیفست به این شکل خواهد بود (همچنین باید بخش bands را همان‌طور که در زیر توضیح داده شده است اضافه کنید):

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "bands": ...,
  "tilesets": [
    {
      "id": "tileset_for_band1",
      "sources": [
        {
          "uris": [
            "gs://bucket/band1.tif"
          ]
        }
      ]
    },
    {
      "id": "tileset_for_band2",
      "sources": [
        {
          "uris": [
            "gs://bucket/band2.tif"
          ]
        }
      ]
    }
  ]
}

توجه داشته باشید که درصورت وجود باندهای جداگانه، برای شفافیت باید به هر مجموعه کاشی یک شناسه مجموعه کاشی متفاوت بدهیم. شناسه tileset می‌تواند رشته‌ای دلخواه باشد - این رشته‌ها در دارایی بارگذاری‌شده نگهداری نمی‌شوند. شناسه‌های Tileset فقط در فرایند دریافت برای متمایز کردن مجموعه‌های کاشی پشته‌ای از یکدیگر استفاده می‌شوند.

باند

مفهوم مهم دوم تطبیق فایل‌های منبع با باندهای دارایی EE است. این کار بااستفاده از بخش bands مانیفست انجام می‌شود.

می‌توان از بخش bands صرف‌نظر کرد، در این صورت باندها ابتدا از فایل‌های موجود در اولین مجموعه کاشی، سپس از مجموعه کاشی بعدی، و به همین ترتیب ایجاد می‌شوند. به‌طور پیش‌فرض، باندها «b1»،‏ «b2»، و غیره نام‌گذاری می‌شوند. برای لغو نام‌های پیش‌فرض باند، بخش «bands» را در انتها اضافه کنید، مانند این:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/rgb.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "R",
      "tilesetBandIndex": 0
    },
    {
      "id": "G",
      "tilesetBandIndex": 1
    },
    {
      "id": "B",
      "tilesetBandIndex": 2
    }
  ]
}

تعداد باندهای EE باید با تعداد کل باندها در همه مجموعه‌های کاشی یکسان باشد.

اگر نمی‌خواهید همه باندهای یک فایل را وارد کنید، می‌توانید از فیلد tilesetBandIndex استفاده کنید تا مشخص کنید کدام‌یک از باندهای GDAL باید وارد شوند. اولین باند دارای tilesetBandIndex با مقدار ۰ است.

مثال:

فرض کنید فایل منبع چهار باند دارد: «tmin»، «tmin_error»، «tmax»، «tmax_error». ما فقط می‌خواهیم «tmin» و «tmax» را دریافت کنیم. بخش‌های مانیفست مربوطه به این شکل خواهد بود:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "temperature",
      "sources": [
        {
          "uris": [
            "gs://bucket/temperature.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "tmin",
      "tilesetBandIndex": 0,
      "tilesetId": "temperature"
    },
    {
      "id": "tmax",
      "tilesetBandIndex": 2,
      "tilesetId": "temperature"
    }
  ]
}

بندهای ماسک

پوشاندن باند توسط مؤلفه maskBands مانیفست کنترل می‌شود. سه پیکربندی ماسک ممکن پشتیبانی می‌شود (اما همیشه فرض می‌شود که باند ماسک آخرین باند در فایل خاصی است).

  1. ماسک برای همه باندهای داده در همان فایل.
  2. ماسک برای همه باندهای داده که از دیگر فایل‌ها می‌آیند.
  3. ماسک برای برخی باندهای داده.

۱. رایج‌ترین حالت یک GeoTIFF تکی است که آخرین باند آن به‌عنوان ماسک برای باندهای دیگر استفاده می‌شود. این فقط برای GeoTIFF از نوع بایت کار می‌کند. از مانیفست زیر استفاده کنید:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "data_tileset"
    }
  ]
}

۲. برای استفاده از GeoTIFF ماسک به‌عنوان ماسک برای همه باندها در GeoTIFF دیگر، از مانیفست زیر استفاده کنید:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    },
    {
      "id": "mask_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/mask_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "mask_tileset"
    }
  ]
}

۳. برای استفاده از GeoTIFF به‌عنوان ماسک برای باند خاصی در فایل دیگر، از مانیفست زیر استفاده کنید (تفاوت با مورد قبلی این است که فیلد bandIds در maskBands تنظیم شده است):

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    },
    {
      "id": "mask_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/mask_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "mask_tileset",
      "bandIds": ["data_band"]
    }
  ]
}

In the last example, we are working with two bands from the data_tileset tileset, but are only applying a mask to one of the bands (data_band), as designated by the bandIds field of the only provided maskBands list object.

توجه داشته باشید که فقط آخرین باند مجموعه کاشی ذکرشده در maskBands به‌عنوان باند ماسک استفاده می‌شود.

خط‌مشی هرمی

وقتی Earth Engine هرم‌های تصویر را درطول فرایند انتقال می‌سازد، باید به‌طور مکرر شبکه‌های ۲×۲ پیکسلی را به یک پیکسل کاهش دهد، و مقدار پیکسل را به نحوی تغییر دهد. به‌طور پیش‌فرض، مقادیر پیکسل میانگین‌گیری می‌شوند که در اکثر موارد، وقتی باند شطرنجی نشان‌دهنده داده‌های کم‌وبیش پیوسته است، کار درستی است. بااین‌حال، دو موقعیت وجود دارد که تکیه بر مقدار پیش‌فرض نتایج نادرستی تولید می‌کند، در این موارد فیلد pyramidingPolicy در تعریف باند باید تنظیم شود (اگر تنظیم نشود، مقدار آن به‌طور پیش‌فرض «MEAN» فرض می‌شود).

برای طبقه‌بندی تصاویر شطرنجی (مثلاً برای طبقه‌بندی پوشش زمین)، منطقی‌ترین روش برای هرمی کردن پیکسل‌ها این است که اکثریت چهار مقدار را برای تولید مقدار بعدی درنظر بگیریم. این کار بااستفاده از خط‌مشی هرمی «MODE» انجام می‌شود:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/landcover.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "landcover",
      "pyramidingPolicy": "MODE"
    }
  ]
}

برای باندهای شطرنجی که نه «MEAN» و نه «MODE» در آن‌ها معنی ندارد (برای مثال، پیکسل‌های بیت‌پک‌شده)، باید از خط‌مشی هرمی «SAMPLE» استفاده شود. «SAMPLE» همیشه مقدار پیکسل بالا سمت چپ را از هر شبکه ۲×۲ می‌گیرد. مثال زیر خط‌مشی هرمی «MEAN» را به باندی که نشان‌دهنده متغیر پیوسته («NDVI») است و «SAMPLE» را به باند «QA» داده‌ها اختصاص می‌دهد.

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/ndvi.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "NDVI",
      "tilesetBandIndex": 0,
      "pyramidingPolicy": "MEAN"
    },
    {
      "id": "QA",
      "tilesetBandIndex": 1,
      "pyramidingPolicy": "SAMPLE"
    }
  ]
}

زمان شروع و پایان

همه دارایی‌ها باید زمان شروع و پایان را مشخص کنند تا بافت بیشتری به داده‌ها بدهند، به‌ویژه اگر در مجموعه‌ها گنجانده شده باشند. این فیلدها الزامی نیستند، اما اکیداً توصیه می‌کنیم هرجا ممکن بود از آن‌ها استفاده کنید.

زمان شروع و پایان معمولاً به‌معنای زمان مشاهده است، نه زمانی که فایل منبع تولید شده است.

برای سادگی، زمان پایان به‌عنوان مرز انحصاری درنظر گرفته می‌شود. برای مثال، برای دارایی‌هایی که دقیقاً یک روز را پوشش می‌دهند، از نیمه‌شب دو روز متوالی (برای مثال، 1980-01-31T00:00:00 و 1980-02-01T00:00:00) برای زمان شروع و پایان استفاده کنید. اگر دارایی مدت‌زمان ندارد، زمان پایان را همانند زمان شروع تنظیم کنید. زمان‌ها را در مانیفست‌ها به‌صورت رشته‌های ISO 8601 نمایش دهید. توصیه می‌کنیم فرض کنید که زمان پایان انحصاری است (برای مثال، نیمه‌شب روز بعد برای دارایی‌های روزانه) تا مقادیر تاریخ ساده شود.

مثال:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/img_20190612.tif"
          ]
        }
      ]
    }
  ],
  "startTime": "1980-01-31T00:00:00Z",
  "endTime": "1980-02-01T00:00:00Z"
}

مرجع ساختار مانیفست

ساختار JSON زیر شامل همه فیلدهای مانیفست بارگذاری تصویر ممکن است. تعاریف فیلد را در بخش تعاریف فیلد مانیفست در زیر پیدا کنید.

{
  "name": <string>,
  "tilesets": [
    {
      "dataType": <string>,
      "id": <string>,
      "crs": <string>,
      "sources": [
        {
          "uris": [
            <stringn>>
          ],
          "affineTransform": {
            "scaleX": <double>,
            "shearX": <double>,
            "translateX": <double>,
            "shearY": <double>,
            "scaleY": <double>,
            "translateY": <double>
          }
        }
      ]
    }
  ],
  "bands": [
    {
      "id": <string>,
      "tilesetId": <string>,
      "tilesetBandIndex": <int32>,
      "missingData": {
        "values": [<doublen>>]
      },
      "pyramindingPolicy": <string>
    }
  ],
  "maskBands": [
    {
      "tilesetId": <string>,
      "bandIds": [
        <stringn>>
      ]
    }
  ],
  "footprint": {
    "points": [
      {
        "x": <double>,
        "y": <doublen>>
      }
    ],
    "bandId": <string>
  },
  "missingData": {
     "values": [<double>]
  },
  "pyramidingPolicy": <string>,
  "uriPrefix": <string>,
  "startTime": {
    "seconds": <integer>
  },
  "endTime": {
    "seconds": <integer>
  },
  "properties": {
    <unspecified>
  }
}

تعاریف فیلد مانیفست

نام

string

نام دارایی‌ای که باید ایجاد شود. ‫name در قالب «projects/*/assets/**‎» است (برای مثال، «projects/earthengine-legacy/assets/users/USER/ASSET»).

مجموعه کاشی‌ها

list

فهرستی از واژه‌نامه‌ها که ویژگی‌های مجموعه‌های کاشی را تعریف می‌کند. برای اطلاعات بیشتر، فیلدهای عنصر فرهنگ لغت tilesets زیر را ببینید.

tilesets[i].dataType

string

نوع داده عددی داده‌ها را مشخص می‌کند. پیش‌فرض نوعی است که GDAL گزارش می‌کند، که در این صورت نیازی به تعریف نیست.

نوع داده مقدار
نامشخص "DATA_TYPE_UNSPECIFIED"
عدد صحیح علامت‌دار ۸ بیتی "INT8"
عدد صحیح بدون علامت ۸ بیتی «UINT8»
عدد صحیح علامت‌دار ۱۶ بیتی "INT16"
عدد صحیح بدون علامت ۱۶ بیتی "UINT16"
عدد صحیح علامت‌دار ۳۲ بیتی "INT32"
عدد صحیح بدون علامت ۳۲ بیتی "UINT32"
‫۳۲ بیت ممیز شناور "FLOAT32"
‫۶۴ بیتی شناور "FLOAT64"

tilesets[i].id

string

شناسه مجموعه کاشی. باید در میان مجموعه‌های کاشی مشخص‌شده در مانیفست دارایی منحصربه‌فرد باشد. این شناسه درطول مرحله پردازش دور انداخته می‌شود؛ فقط برای پیوند دادن مجموعه کاشی به باند استفاده می‌شود. رشته خالی شناسه معتبری است.

tilesets[i].crs

string

سیستم مرجع مختصات شبکه پیکسل، که درصورت امکان به‌عنوان کد استاندارد (برای مثال، کد EPSG) و درغیراین‌صورت در قالب WKT مشخص می‌شود.

tilesets[i].sources

list

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

tilesets[i].sources[j].uris

list

فهرستی از URIهای داده‌ها برای جذب. فقط URIهای Google Cloud Storage پشتیبانی می‌شود. هر URI باید در قالب زیر مشخص شود: gs://bucket-id/object-id. شیء اصلی باید اولین عنصر فهرست باشد و موارد جانبی بعداز آن فهرست شوند. هر URI با ImageManifest.uriPrefix پیشوندگذاری می‌شود (درصورت تنظیم).

tilesets[i].sources[j].affineTransform

dictionary

تبدیل آفین اختیاری. فقط درصورتی باید مشخص شود که داده‌های uris (ازجمله هرگونه فایل جانبی) برای قرار دادن پیکسل‌ها کافی نباشد. به‌عنوان واژه‌نامه‌ای با کلیدهای زیر ارائه شده است: «scaleX»،‏ «shearX»،‏ «translateX»،‏ «shearY»،‏ «scaleY»،‏ «translateY». برای اطلاعات بیشتر، این مرجع را ببینید.

نمونه کلیدها و مقادیر:

{
  "scaleX": 0.1,
  "shearX": 0.0,
  "translateX": -180.0,
  "shearY": 0.0,
  "scaleY": -0.1,
  "translateY": 90.0
}

باندها

list

فهرستی از واژه‌نامه‌ها که ویژگی‌های یک باند تکی را که از یک مجموعه کاشی منبع‌یابی شده است تعریف می‌کند. توجه داشته باشید که ترتیب باند دارایی با ترتیب bands یکسان است. برای اطلاعات بیشتر، فیلدهای عنصر واژه‌نامه bands زیر را ببینید.

bands[i].id

string

شناسه (نام) باند.

bands[i].tilesetId

string

شناسه مجموعه کاشی‌های مربوط به باند.

bands[i].tilesetBandIndex

int32

شاخص باند صفرمبنا از مجموعه کاشی مربوط به باند.

bands[i].missingData.values

list

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

bands[i].pyramidingPolicy

string

خط‌مشی هرمی. برای اطلاعات بیشتر، این پیوند را ببینید. گزینه ها عبارت‌اند از:

  • «MEAN» (پیش‌فرض)
  • «حالت»
  • «نمونه»

maskBands

list

فهرستی از واژه‌نامه‌ها که ویژگی‌های یک باند ماسک تکی را که از یک مجموعه کاشی منبع‌یابی شده است تعریف می‌کند. حداکثر ۱ باند پوشش می‌تواند ارائه شود. برای اطلاعات بیشتر، فیلدهای عنصر واژه‌نامه maskBands زیر را ببینید.

maskBands[i].tilesetId

string

شناسه مجموعه کاشی مربوط به باند ماسک. آخرین باند مجموعه کاشی همیشه به‌عنوان باند ماسک استفاده می‌شود.

maskBands[i].bandIds

list of strings

فهرست شناسه‌های باندهایی که باند ماسک به آن‌ها اعمال می‌شود. اگر خالی باشد، نوار ماسک روی همه نوارهای دارایی اعمال می‌شود. هر باند فقط می‌تواند یک باند ماسک متناظر داشته باشد.

رد پا

dictionary

واژه‌نامه‌ای که ویژگی‌های ردپای همه پیکسل‌های معتبر در تصویر را تعریف می‌کند. اگر خالی باشد، ردپای پیش‌فرض کل تصویر است. برای اطلاعات بیشتر، فیلدهای عنصر واژه‌نامه footprint زیر را ببینید.

footprint.points

list

فهرستی از نقاطی که ردپای همه پیکسل‌های معتبر را در تصویر تعریف می‌کند. نقطه با واژه‌نامه‌ای با کلیدهای «x» و «y» که مقادیر اعشاری دارند تعریف می‌شود. فهرستی از نقاط برای توصیف حلقه‌ای است که نمای بیرونی چندضلعی ساده‌ای را تشکیل می‌دهد که باید شامل مراکز همه پیکسل‌های معتبر تصویر باشد. این باید حلقه‌ای خطی باشد: نقطه آخر باید با نقطه اول برابر باشد. مختصات در تصویرسازی باند مشخص‌شده توسط bandId است.

توجه: از مختصات غیرعدد صحیح مانند مرکز هر پیکسل استفاده کنید زیرا footprint برای گنجاندن پیکسل درنظر گرفته می‌شود اگر پیکسل (مستطیل ۱×۱) با ردپا تقاطع داشته باشد. برای جلوگیری از انتخاب تصادفی پیکسل‌های مجاور، از مختصات با مقدار عدد صحیح استفاده نکنید، زیرا این مقادیر مرزهای بین پیکسل‌ها هستند. ترسیم ردپا در امتداد مراکز پیکسل از گنجاندن پیکسل‌های ناخواسته جلوگیری می‌کند، که می‌تواند باعث ایجاد خطا شود وقتی پیکسل‌های موردنظر در مجاورت مرز نقشه مانند ضد نصف‌النهار یا قطب قرار دارند.

برای مثال، برای تصویر ۲×۲ با هر چهار پیکسل معتبر، یکی‌از حلقه‌های ممکن به‌صورت زیر است:

[
  {
    "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
  }
]

footprint.bandId

string

شناسه باندی که CRS آن مختصات ردپا را تعریف می‌کند. اگر خالی باشد، از باند اول استفاده می‌شود.

missingData.values

list

فهرستی از مقادیر (نوع دوبرابر) که نشان‌دهنده عدم وجود داده در همه باندهای تصویر است. برای همه باندهایی که missingData خودشان را مشخص نمی‌کنند اعمال می‌شود.

pyramidingPolicy

string

خط‌مشی هرمی. اگر مشخص نشده باشد، خط‌مشی «MEAN» به‌طور پیش‌فرض اعمال می‌شود. بر همه باندهایی که باند خودشان را مشخص نکرده‌اند اعمال می‌شود. برای اطلاعات بیشتر، این پیوند را ببینید. گزینه ها عبارت‌اند از:

  • «MEAN» (پیش‌فرض)
  • «حالت»
  • «نمونه»

uriPrefix

string

پیشوند اختیاری که به همه uris تعریف‌شده در مانیفست اضافه می‌شود.

startTime

integer

مُهر زمان مربوط به دارایی، درصورت وجود. این معمولاً با زمانی که تصویر ماهواره‌ای گرفته شده است مطابقت دارد. برای دارایی‌هایی که با یک بازه زمانی مطابقت دارند، مانند مقادیر میانگین در طول یک ماه یا سال، این مُهر زمان با شروع آن بازه مطابقت دارد. به‌صورت ثانیه و (اختیاری) نانوثانیه از مبدأ تاریخ (۱۹۷۰-۰۱-۰۱) مشخص می‌شود. فرض می‌شود که در منطقه زمانی UTC باشد.

endTime

integer

برای دارایی‌هایی که با یک بازه زمانی مطابقت دارند، مانند مقادیر میانگین در طول یک ماه یا سال، این مُهر زمان با پایان آن بازه زمانی مطابقت دارد (انحصاری). به‌صورت ثانیه و (اختیاری) نانوثانیه از مبدأ تاریخ (۱۹۷۰-۰۱-۰۱) مشخص می‌شود. فرض می‌شود که در منطقه زمانی UTC باشد.

اقامتگاه‌ها

dictionary

فرهنگ لغت مسطح دلخواه از جفت‌های کلید-مقدار. کلیدها باید رشته باشند و مقادیر می‌توانند عدد یا رشته باشند. مقادیر فهرست هنوز برای دارایی‌های بارگذاری‌شده توسط کاربر پشتیبانی نمی‌شود.

محدودیت‌ها

اندازه مانیفست JSON

حد اندازه فایل مانیفست JSON‏ ۱۰ مگابایت است. اگر فایل‌های زیادی برای بارگذاری دارید، روش‌هایی را برای کاهش تعداد نویسه‌های لازم برای توصیف مجموعه داده درنظر بگیرید. برای مثال، از فیلد uriPrefix استفاده کنید تا نیاز به ارائه مسیر مخزن Google Cloud برای هر URI در فهرست uris را حذف کنید. اگر کاهش بیشتر اندازه لازم است، نام فایل‌ها را کوتاه‌تر کنید.

قالب فایل تصویری

هر فایل تصویری باید تصویر TIFF باشد. اگر CRS در مانیفست مشخص نشده باشد، فایل باید GeoTIFF با CRS جاسازی‌شده باشد.

فایل‌های TIFF را می‌توان با DEFLATE،‏ JPEG-XL/JXL،‏ LERC،‏ LERC_DEFLATE،‏ LERC_ZSTD،‏ LZMA،‏ LZW،‏ WEBP، یا ZSTD فشرده کرد.

توصیه‌هایی برای بهترین تجربه بارگذاری فایل‌های بزرگ:

  • بهترین انتخاب: ZSTD تعادل خوبی بین سرعت و فشرده‌سازی ارائه می‌دهد.
  • اجتناب کنید: LZMA با وجود فشرده‌سازی خوب می‌تواند بسیار کند باشد.
  • فایل‌های فشرده‌نشده: منجر به فایل‌های بزرگ‌تر و زمان بارگذاری طولانی‌تر می‌شود.
  • فشرده‌سازی پراتلاف (مثلاً JPEG): ممکن است مقادیر پیکسل را تغییر دهد. از فشرده‌سازی بدون اتلاف (مثلاً DEFLATE،‏ LZMA،‏ LZW،‏ ZSTD) استفاده کنید، مگراینکه از تأثیر احتمالی آن بر داده‌هایتان مطلع باشید.