REST Resource: projects.assets

منبع: EarthEngineAsset

اطلاعات مربوط به دارایی موتور زمینی.

نمایش JSON
{
  "type": enum (Type),
  "name": string,
  "id": string,
  "updateTime": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string,
  "featureCount": string,
  "quota": {
    object (FolderQuota)
  },
  "tilesets": [
    {
      object (Tileset)
    }
  ],

  // Union field location can be only one of the following:
  "cloudStorageLocation": {
    object (CloudStorageLocation)
  },
  "featureViewAssetLocation": {
    object (FeatureViewLocation)
  }
  // End of list of possible types for union field location.
}
فیلدها
type

enum ( Type )

نوع دارایی.

name

string

نام دارایی. name به فرمت "projects/*/assets/**" است (مثلاً "projects/earthengine-legacy/assets/users/"). / ").

id

string

شناسه دارایی. معادل name بدون پیشوند "projects/*/assets/" (مثلاً "users/" / "). توجه داشته باشید که این فقط برای اهداف نمایشی در نظر گرفته شده است. نباید از آن به عنوان ورودی برای عملیات دیگری استفاده شود. به جای آن name استفاده کنید.

updateTime

string ( Timestamp format)

آخرین زمان اصلاح دارایی.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

properties

object ( Struct format)

ویژگی‌های کلید/مقدار مرتبط با دارایی.

startTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

geometry

object ( Struct format)

ردپای مکانی مرتبط با دارایی، در صورت وجود، به عنوان یک شیء هندسی GeoJSON (به RFC 7946 مراجعه کنید).

bands[]

object ( ImageBand )

اطلاعات مربوط به باندهای داده‌ی تصویر. برای داده‌های غیرتصویری حذف شده است.

sizeBytes

string ( int64 format)

اندازه یک عنصر برگ (مثلاً یک تصویر) بر حسب بایت.

featureCount

string ( int64 format)

تعداد ویژگی‌های موجود در دارایی، در صورت وجود.

quota

object ( FolderQuota )

اطلاعات سهمیه مرتبط با دارایی پوشه، در صورت وجود. برای دارایی‌های پوشه سطح بالای متعلق به کاربر (مثلاً "users/*" یا "projects/*") برگردانده می‌شود.

tilesets[]

object ( Tileset )

مجموعه کاشی‌های پشتیبان این تصویر. فقط برای تصاویر خارجی ارائه می‌شود که پیکسل‌های آنها از فضای ذخیره‌سازی غیرمتعلق به Earth Engine بازیابی می‌شوند.

location فیلد Union. اطلاعاتی در مورد محل و نحوه ذخیره کاشی‌های شطرنجی. location می‌تواند فقط یکی از موارد زیر باشد:
cloudStorageLocation
(deprecated)

object ( CloudStorageLocation )

منسوخ شده. به جای آن ImportExternalImage استفاده کنید. برای جزئیات بیشتر به https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff مراجعه کنید.

featureViewAssetLocation

object ( FeatureViewLocation )

محل قرارگیری این FeatureView در EE.

مکان ذخیره‌سازی ابری

محل قرارگیری یک دارایی در فضای ذخیره‌سازی ابری.

نمایش JSON
{
  "uris": [
    string
  ]
}
فیلدها
uris[]

string

آدرس‌های اینترنتی (URI) داده‌ها. فقط آدرس‌های اینترنتی ذخیره‌سازی ابری گوگل پشتیبانی می‌شوند. هر آدرس اینترنتی باید با فرمت زیر مشخص شود: "gs://bucket-id/object-id". در حال حاضر فقط یک آدرس اینترنتی پشتیبانی می‌شود. اگر بیش از یک آدرس اینترنتی مشخص شود، خطای INALID_ARGUMENT برگردانده می‌شود.

نمای ویژهموقعیت مکانی

یک دارایی FeatureView EE.

نمایش JSON
{
  "assetOptions": {
    object (FeatureViewOptions)
  }
}
فیلدها
assetOptions

object ( FeatureViewOptions )

گزینه‌های زمان مصرف برای دارایی‌های FeatureView.

گزینه‌های نمای ویژه

گزینه‌های زمان مصرف برای دارایی‌های FeatureView.

نمایش JSON
{
  "featureViewAttributes": [
    {
      object (FeatureViewAttribute)
    }
  ],
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  }
}
فیلدها
featureViewAttributes[]

object ( FeatureViewAttribute )

ویژگی‌های موجود در دارایی FeatureView، که شامل یک طرحواره برای دارایی است. اینها ویژگی‌هایی هستند که ویژگی‌های این دارایی می‌توانند داشته باشند. هر ویژگی دارای یک نام و یک نوع است.

ingestionTimeParameters

object ( FeatureViewIngestionTimeParameters )

پارامترهای زمان مصرف FeatureView.

ویژگی FeatureViewAttribute

یک ویژگی FeatureView و نوع آن.

نمایش JSON
{
  "name": string,
  "type": enum (Type)
}
فیلدها
name

string

نام ویژگی.

type

enum ( Type )

نوع ویژگی.

نوع

این نوع‌ها آینه‌ای از انواع موجود در geo/enterprise/layers/public/data_source_schema.proto هستند.

انوم‌ها
TYPE_UNSPECIFIED نوع نامشخص.
INTEGER یک مقدار صحیح ۶۴ بیتی.
BOOLEAN مقدار بولی درست/نادرست.
DOUBLE یک عدد ممیز شناور با دقت مضاعف.
STRING رشته‌ای با طول نامحدود.
DATE_TIME یک تاریخ/زمان، که به صورت یک عدد صحیح ۶۴ بیتی علامت‌دار بر حسب میکروثانیه از آن دوره زمانی نمایش داده می‌شود و بنابراین دوره زمانی از ۲۹۰,۳۰۸ قبل از میلاد تا ۲۹۴,۲۴۷ بعد از میلاد را پشتیبانی می‌کند.

پارامترهای FeatureViewIngestionTime

پارامترهای زمان مصرف FeatureView. این پارامترها باید در زمان مصرف مشخص شوند و نمی‌توانند در لحظه برای FeatureView به‌روزرسانی شوند.

نمایش JSON
{
  "thinningOptions": {
    object (ThinningOptions)
  },
  "rankingOptions": {
    object (RankingOptions)
  }
}
فیلدها
thinningOptions

object ( ThinningOptions )

حداکثر تعداد کادرهای محدودکننده عارضه که مجاز به قطع یک کاشی هستند. این عدد باید غیرمنفی باشد.

rankingOptions

object ( RankingOptions )

گزینه‌هایی برای اختصاص رتبه‌های مرتبه z و نازک‌سازی رتبه‌ها به ویژگی‌ها.

گزینه‌های نازک‌سازی

گزینه‌های نازک‌سازی که چگالی نمایش ویژگی‌ها در هر کاشی را کنترل می‌کنند.

نمایش JSON
{
  "maxFeaturesPerTile": integer,
  "thinningStrategy": enum (ThinningStrategy)
}
فیلدها
maxFeaturesPerTile

integer

حداکثر تعداد کادرهای محدودکننده عارضه که مجاز به قطع یک کاشی هستند. این عدد باید غیرمنفی باشد.

thinningStrategy

enum ( ThinningStrategy )

استراتژی نازک‌سازی ویژگی که باید استفاده شود.

استراتژی رقیق‌سازی

استراتژی کاهش ویژگی‌ها.

انوم‌ها
UNKNOWN_THINNING_STRATEGY استراتژی تنک کردن ناشناخته.
GLOBALLY_CONSISTENT هنگام نازک‌سازی در یک LOD خاص، نازک‌سازی سازگار با سراسری به این معنی است که اگر یک ویژگی با نازک‌سازی حذف شود، تمام ویژگی‌های دیگر با رتبه نازک‌سازی برابر یا بدتر نیز حذف خواهند شد.
HIGHER_DENSITY

هنگام نازک‌سازی، سعی کنید تا حد امکان به حد maxFeaturesPerTile برای هر کاشی نزدیک شوید. ما ویژگی‌های با رتبه بهتر را به ویژگی‌های با رتبه بدتر ترجیح می‌دهیم، اما گاهی اوقات اگر این به ما در دستیابی به تراکم ویژگی بالاتر کمک کند، ویژگی‌های با رتبه بهتر را کنار می‌گذاریم.

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

گزینه‌های رتبه‌بندی

گزینه‌های رتبه‌بندی برای مرتبه z و نازک شدن.

نمایش JSON
{
  "zOrderRankingRule": {
    object (RankingRule)
  },
  "thinningRankingRule": {
    object (RankingRule)
  }
}
فیلدها
zOrderRankingRule

object ( RankingRule )

قانون رتبه‌بندی برای اختصاص رتبه‌های مرتبه z به ویژگی‌ها.

thinningRankingRule

object ( RankingRule )

قاعده رتبه‌بندی برای اختصاص رتبه‌های نازک‌سازی به ویژگی‌ها.

قانون رتبه‌بندی

قوانین رتبه‌بندی که نحوه رتبه‌بندی ویژگی‌ها را برای نازک‌سازی و مرتبه z کنترل می‌کنند.

نمایش JSON
{
  "rankByOneThingRule": [
    {
      object (RankByOneThingRule)
    }
  ]
}
فیلدها
rankByOneThingRule[]

object ( RankByOneThingRule )

فهرستی مرتب از صفر یا چند قانون رتبه‌بندی بر اساس یک چیز (مانند attr) که به عنوان کلیدهای رتبه‌بندی اولیه، ثانویه، ... برای تنظیم thinning_rank در هر RankedFeature استفاده می‌شوند.

RankByOneThingRule

یک قانون رتبه‌بندی فردی برای کنترل رتبه برای نازک‌سازی و مرتبه z.

نمایش JSON
{

  // Union field rule can be only one of the following:
  "rankByAttributeRule": {
    object (RankByAttributeRule)
  },
  "rankByMinVisibleLodRule": {
    object (RankByMinVisibleLodRule)
  },
  "rankByGeometryTypeRule": {
    object (RankByGeometryTypeRule)
  },
  "rankByMinZoomLevelRule": {
    object (RankByMinZoomLevelRule)
  }
  // End of list of possible types for union field rule.
  "direction": enum (Direction)
}
فیلدها
rule فیلد اتحادیه. نوع قانون رتبه‌بندی مورد استفاده. rule می‌تواند فقط یکی از موارد زیر باشد:
rankByAttributeRule

object ( RankByAttributeRule )

رتبه‌بندی بر اساس مقدار ویژگی.

rankByMinVisibleLodRule
(deprecated)

object ( RankByMinVisibleLodRule )

رتبه‌بندی بر اساس حداقل فاصله زمانی که هندسه عارضه برای اولین بار در آن قابل مشاهده است. یک عارضه با هر نقطه‌ای، همیشه در تمام LODها قابل مشاهده است. منسوخ شده: لطفاً به جای آن از rankByMinZoomLevelRule استفاده کنید.

rankByGeometryTypeRule

object ( RankByGeometryTypeRule )

رتبه‌بندی بر اساس نوع هندسه. اولویت انواع، از زیاد به کم: چندضلعی، چندخطی، نقطه‌ای، هیچ‌کدام. در عوارضی با چندین نوع، بالاترین اولویت را دارد.

rankByMinZoomLevelRule

object ( RankByMinZoomLevelRule )

بر اساس حداقل سطح بزرگنمایی که در آن هندسه ویژگی برای اولین بار قابل مشاهده است، رتبه‌بندی کنید. یک ویژگی با هر نقطه‌ای، همیشه در تمام LODها قابل مشاهده است.

direction

enum ( Direction )

اینکه آیا رتبه‌بندی بر اساس این مورد باید صعودی (مقادیر پایین‌تر اول، یعنی مهم‌تر) باشد یا نزولی (مقادیر بالا اول، یعنی مهم‌تر). به عبارت دیگر، صعودی به معنای استفاده مستقیم از ترتیب شرح داده شده در مستندات زیرپیام RankByAttributeRule (یا سایر) در زیر است، و نزولی به معنای معکوس کردن آن ترتیب است.

RankByAttributeRule

رتبه‌بندی بر اساس مقدار ویژگی.

نمایش JSON
{
  "attributeName": string
}
فیلدها
attributeName

string

بر اساس مقدار ویژگی با نام داده شده رتبه‌بندی کنید. این تقریباً ترتیب طبیعی مقادیر نوع داده شده است، با برخی ظرافت‌ها و توضیحات: - برای attr های عدد صحیح، مقادیر پایین‌تر قبل از مقادیر بالاتر می‌آیند - برای attr های دابل، مقادیر پایین‌تر قبل از مقادیر بالاتر می‌آیند و NaN از همه مقادیر دیگر، از جمله منهای بی‌نهایت، کمتر در نظر گرفته می‌شود - برای attr های بولی، false قبل از true در نظر گرفته می‌شود - برای attr های تاریخ_زمان، مقادیر قبلی قبل از مقادیر بعدی می‌آیند - attr های رشته‌ای به صورت لغوی رتبه‌بندی می‌شوند - attr ای که مقدار آن تعیین نشده است، مقدار پیش‌فرض نوع داده شده را دارد (0 برای عدد صحیح، false برای بولی و غیره).

RankByMinVisibleLodRule

این نوع هیچ فیلدی ندارد.

رتبه‌بندی بر اساس حداقل فاصله زمانی که هندسه عارضه برای اولین بار در آن قابل مشاهده است. یک عارضه با هر نقطه‌ای، همیشه در تمام LODها قابل مشاهده است.

RankByGeometryTypeRule

این نوع هیچ فیلدی ندارد.

رتبه‌بندی بر اساس نوع هندسه. اولویت انواع، از زیاد به کم: چندضلعی، چندخطی، نقطه‌ای، هیچ‌کدام. در عوارضی با چندین نوع، بالاترین اولویت را دارد.

RankByMinZoomLevelRule

این نوع هیچ فیلدی ندارد.

بر اساس حداقل سطح بزرگنمایی که در آن هندسه ویژگی برای اولین بار قابل مشاهده است، رتبه‌بندی کنید. یک ویژگی با هر نقطه‌ای، همیشه در تمام LODها قابل مشاهده است.

جهت

اینکه آیا لیست از پایین به بالا (صعودی) یا از بالا به پایین (نزولی) مرتب شود.

انوم‌ها
DIRECTION_UNSPECIFIED هیچ جهت رتبه‌بندی مشخص نشده است.
ASCENDING ترتیب صعودی.
DESCENDING ترتیب نزولی.

نوع

انواع دارایی.

انوم‌ها
TYPE_UNSPECIFIED نامشخص.
IMAGE تصویر.
IMAGE_COLLECTION مجموعه تصاویر.
TABLE میز.
FOLDER پوشه.
CLASSIFIER طبقه بندی کننده.
FEATURE_VIEW دارایی FeatureView.

ایمیج‌باند

اطلاعات مربوط به یک باند داده واحد از یک دارایی تصویری.

نمایش JSON
{
  "id": string,
  "dataType": {
    object (PixelDataType)
  },
  "grid": {
    object (PixelGrid)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "missingData": {
    object (MissingData)
  }
}
فیلدها
id

string

شناسنامه گروه موسیقی.

dataType

object ( PixelDataType )

نوع عددی باند.

grid

object ( PixelGrid )

شبکه پیکسلی باند.

pyramidingPolicy

enum ( PyramidingPolicy )

سیاست هرمی گروه.

missingData

object ( MissingData )

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

پیکسل نوع داده

نوع عددی پیکسل‌ها را در یک باند تصویر مشخص می‌کند.

نمایش JSON
{
  "precision": enum (Precision),
  "range": {
    object (DoubleRange)
  },
  "dimensionsCount": integer
}
فیلدها
precision

enum ( Precision )

دقت عددی نوع.

range

object ( DoubleRange )

محدوده نوع عددی، در صورت وجود. معمولاً برای انواع اعشاری وجود ندارد.

dimensionsCount

integer

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

دقت

دقت یک نوع داده عددی را مشخص می‌کند.

انوم‌ها
PRECISION_UNSPECIFIED نامشخص.
INT نوع داده دارای دقت عدد صحیح است. توجه داشته باشید که این می‌تواند نشان‌دهنده اعداد صحیح با اندازه‌های مختلف باشد.
FLOAT نوع داده دارای دقت اعشاری ۳۲ بیتی است.
DOUBLE این نوع داده دارای دقت اعشاری (مضاعف) ۶۴ بیتی است.

داده‌های گمشده

فهرستی از مقادیر که هیچ داده‌ای را نشان نمی‌دهند.

نمایش JSON
{
  "values": [
    number
  ]
}
فیلدها
values[]

number

مقادیری که هیچ داده‌ای را نشان نمی‌دهند.

فولدرکوتا

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

نمایش JSON
{
  "sizeBytes": string,
  "maxSizeBytes": string,
  "assetCount": string,
  "maxAssets": string
}
فیلدها
sizeBytes

string ( int64 format)

اندازه پوشه بر حسب بایت.

maxSizeBytes

string ( int64 format)

حداکثر اندازه پوشه بر حسب بایت.

assetCount

string ( int64 format)

تعداد دارایی‌های ذخیره شده در پوشه.

maxAssets

string ( int64 format)

حداکثر تعداد فایل‌هایی که می‌توان در پوشه ذخیره کرد.

کاشی‌کاری

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

نمایش JSON
{
  "id": string,
  "sources": [
    {
      object (ImageSource)
    }
  ],
  "dataType": enum (DataType),
  "crs": string
}
فیلدها
id

string

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

sources[]

object ( ImageSource )

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

dataType

enum ( DataType )

یک نوع داده اختیاری برای باند. در صورت مشخص شدن، هیچ بررسی برای تأیید مطابقت نوع هر فایل ورودی انجام نمی‌شود. dataType باید با نوع هر فایل ورودی مطابقت داشته باشد، به جز مواردی که نوع ورودی مبهم است (مثلاً Byte می‌تواند INT8 یا UINT8 باشد).

crs

string

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

منبع تصویر

یک فایل تصویری و فایل‌های جانبی آن.

نمایش JSON
{
  "uris": [
    string
  ],
  "affineTransform": {
    object (AffineTransform)
  },
  "dimensions": {
    object (GridDimensions)
  }
}
فیلدها
uris[]

string

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

affineTransform

object ( AffineTransform )

یک تبدیل آفین اختیاری. فقط در صورتی باید مشخص شود که داده‌های uris (شامل هرگونه sidecar) برای قرار دادن پیکسل‌ها کافی نباشد.

dimensions

object ( GridDimensions )

ابعاد رستر بر حسب پیکسل. فقط زمانی استفاده می‌شود که 'skipMetadataRead' تنظیم شده باشد.

نوع داده

نوع داده عددی را مشخص می‌کند.

انوم‌ها
DATA_TYPE_UNSPECIFIED نامشخص.
INT8 عدد صحیح علامت‌دار ۸ بیتی.
UINT8 عدد صحیح بدون علامت ۸ بیتی.
INT16 عدد صحیح علامت‌دار ۱۶ بیتی.
UINT16 عدد صحیح بدون علامت ۱۶ بیتی.
INT32 عدد صحیح علامت‌دار ۳۲ بیتی.
UINT32 عدد صحیح بدون علامت ۳۲ بیتی.
FLOAT عدد شناور ۳۲ بیتی.
DOUBLE عدد شناور ۶۴ بیتی.

روش‌ها

copy

یک دارایی را کپی می‌کند.

create

دارایی ایجاد می‌کند.

delete

یک دارایی را حذف می‌کند.

get

اطلاعات دقیقی در مورد یک دارایی دریافت می‌کند.

getIamPolicy

سیاست کنترل دسترسی برای یک منبع را دریافت می‌کند.

getPixels

پیکسل‌ها را از یک تصویر دریافت می‌کند.

listAssets

هر گونه دارایی کانتینر، مانند یک پوشه یا مجموعه را فهرست می‌کند.

listFeatures

ویژگی‌های موجود در یک جدول را فهرست می‌کند.

move

یک دارایی را جابجا می‌کند.

patch

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

setIamPolicy

سیاست کنترل دسترسی را روی منبع مشخص شده تنظیم می‌کند.

testIamPermissions

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