Method: projects.image.import

یک تصویر را وارد می کند.

درخواست HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:import

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

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

پارامترها
project

string

شناسه پروژه یا شماره پروژه پروژه Google Cloud Platform که باید به عنوان مصرف کننده سرویس برای این درخواست در نظر گرفته شود. قالب projects/{project-id} است.

مجوز نیاز به مجوز IAM زیر در project منبع مشخص شده دارد:

  • earthengine.imports.create

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
فیلدها
imageManifest

object ( ImageManifest )

مانیفست تصویر

description

string

نام کار قابل خواندن برای انسان.

overwrite

boolean

اجازه بازنویسی یک دارایی موجود را می دهد یا خیر.

requestId

string

یک رشته منحصر به فرد که برای شناسایی درخواست های تکراری استفاده می شود. اگر بیش از یک درخواست توسط یک کاربر با همان requestId غیر خالی ارسال شود، تنها یکی از آن درخواست‌ها ممکن است با موفقیت یک عملیات طولانی‌مدت را آغاز کند. requestId ممکن است شامل کاراکترهای a..z، A..Z، 0-9 یا '-' باشد. requestId ممکن است حداکثر 60 کاراکتر باشد.

بدن پاسخگو

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

ImageManifest

توضیح می دهد که چگونه سرویس EarthEngine باید یک تصویر را از مجموعه ای از فایل ها بسازد.

نمایندگی JSON 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
فیلدها
name

string

نام دارایی که باید ایجاد شود. name از قالب "projects/*/assets/**" است (به عنوان مثال "projects/earthengine-legacy/assets/users/ / "). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال "پروژه‌ها/میراث زمینی/دارایی/کاربران/فو/بار"). همه دارایی‌های دیگر تحت پروژه "عمومی-خاکی" قرار دارند (مثلاً "پروژه‌ها/خارجی-عمومی/دارایی‌ها/LANDSAT").

properties

object ( Struct format)

ویژگی های اضافی دارایی نام ویژگی "system:time_start" و "system:time_end" منسوخ شده است. به جای آن از فیلدهای startTime و endTime استفاده کنید.

uriPrefix

string

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

tilesets[]

object ( Tileset )

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

bands[]

object ( TilesetBand )

باندها ترتیب باند دارایی مانند ترتیب bands است.

maskBands[]

object ( TilesetMaskBand )

نوارهای ماسک

footprint

object ( PixelFootprint )

ردپای در مختصات پیکسل (نه در مختصات lat/lng). اگر خالی باشد، ردپا به طور پیش فرض کل تصویر است. برای توضیحات دقیق تر مختصات پیکسل به PixelGrid مراجعه کنید.

missingData

object ( MissingData )

مقادیری که هیچ داده ای را در تمام باندهای تصویر نشان نمی دهند. برای همه باندهایی که missingData خود را مشخص نمی کنند اعمال می شود.

pyramidingPolicy

enum ( PyramidingPolicy )

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

startTime

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

endTime

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

skipMetadataRead

boolean

آیا از خواندن فراداده از فایل‌ها با استفاده از GDAL صرفنظر کنید. وقتی این فیلد درست است، مجموعه‌های کاشی باید حاوی فراداده کامل GDAL باشند: نوع داده، crs، تبدیل، ابعاد فایل و بدون مقدار داده.

memo

string

فیلد Freeform برای ذخیره یادداشت های کاربر. در بلع استفاده نمی شود.

TilsetBand

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

نمایندگی JSON 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
فیلدها
id

string

شناسه گروه

tilesetId

string

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

tilesetBandIndex

integer

شاخص باند مبتنی بر صفر از مجموعه کاشی مربوط به باند. به عنوان مثال، اگر 1 باشد، پیکسل های باند هستند، پیکسل های باند در نمایه 1 مجموعه tileset (در ImageManifest.tilesets ) با شناسه tilesetId هستند.

missingData

object ( MissingData )

مقادیری که هیچ داده ای را در باند نشان نمی دهند. اگر MissingData بدون values تنظیم شود، هر مقدار nodata موجود برای فایل های مربوط به این TilesetBand نادیده گرفته می شود.

pyramidingPolicy

enum ( PyramidingPolicy )

سیاست هرمی

TilesetMaskBand

نشان دهنده یک نوار ماسک منفرد است که از یک مجموعه کاشی تهیه شده است.

نمایندگی JSON 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
فیلدها
tilesetId

string

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

bandIds[]

string

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

PixelFootprint

ردپایی از تمام پیکسل های معتبر در یک تصویر.

نمایندگی JSON 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
فیلدها
points[]

object ( GridPoint )

حلقه ای که نمای بیرونی یک چندضلعی ساده را تشکیل می دهد که باید مرکز تمام پیکسل های معتبر تصویر را در خود جای دهد. این باید یک حلقه خطی باشد: آخرین نقطه باید برابر با اولین باشد. مختصات در طرح بندی باند مشخص شده توسط bandId هستند.

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

برای مثال، برای یک تصویر 2x2 با هر 4 پیکسل معتبر، یک حلقه ممکن زیر وجود دارد: [{"x": 0.5، "y": 0.5}، {"x": 0.5، "y": 1.5}، {"x": 1.5، "y": 1.5}، {"x": 1.5}، {"x": 1.5}، {"x": 0.5، "y": 0.5، "y": 0.5. "y": 0.5}]

bandId

string

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

GridPoint

یک نقطه یا بردار دو بعدی.

نمایندگی JSON 
{
  "x": number,
  "y": number
}
فیلدها
x

number

مقدار مختصات x.

y

number

مقدار مختصات y.