REST Resource: projects.assets

المرجع: EarthEngineAsset

معلومات عن مادة عرض في Earth Engine

تمثيل 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 ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "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 ويستخدم 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"

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 معلومات حول مكان تخزين الوحدات المربّعة للصور النقطية وكيفية تخزينها يمكن أن يكون location واحدًا فقط مما يلي:
cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

تمّ الإيقاف. استخدِم image.importExternal بدلاً من ذلك. اطّلِع على https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff لمزيد من التفاصيل.

featureViewAssetLocation

object (FeatureViewLocation)

الموقع الجغرافي لعرض "الميزات" هذا في إسبانيا

CloudStorageLocation

الموقع الجغرافي لمادة العرض على Cloud Storage

تمثيل JSON
{
  "uris": [
    string
  ]
}
الحقول
uris[]

string

عناوين URL للبيانات. لا يُسمَح إلا بمعرّفات الموارد المنتظمة (URI) لخدمة Google Cloud Storage. يجب تحديد كل عنوان URL بالتنسيق التالي: "gs://bucket-id/object-id". لا يتوفّر حاليًا سوى عنوان URL واحد. في حال تحديد أكثر من معرّف موارد منتظم (URI) واحد، يتم عرض خطأ INALID_ARGUMENT.

FeatureViewLocation

مادة عرض FeatureView EE

تمثيل JSON
{
  "assetOptions": {
    object (FeatureViewOptions)
  }
}
الحقول
assetOptions

object (FeatureViewOptions)

خيارات وقت نقل بيانات مواد عرض "الملف الشخصي للمكان"

FeatureViewOptions

خيارات وقت نقل بيانات مواد عرض "الملف الشخصي للمكان"

تمثيل 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 قيمة عدد صحيح 64 بت
BOOLEAN قيمة منطقية صحيحة/خاطئة
DOUBLE عدد فاصل عائم بدقة مضاعفة
STRING سلسلة ذات طول غير محدود
DATE_TIME تاريخ/وقت، يتم تمثيله كعدد صحيح موقَّع 64 بت بالميكرو ثانية منذ تاريخ بدء حساب الفترة، وبالتالي يتيح الفترة الزمنية من 290,308 قبل الميلاد إلى 294,247 ميلادي

FeatureViewIngestionTimeParameters

مَعلمات وقت نقل البيانات إلى FeatureView يجب تحديد هذه المَعلمات في وقت نقل البيانات ولا يمكن تعديلها أثناء التنقل في "عرض العناصر الرئيسية".

تمثيل JSON
{
  "thinningOptions": {
    object (ThinningOptions)
  },
  "rankingOptions": {
    object (RankingOptions)
  }
}
الحقول
thinningOptions

object (ThinningOptions)

الحد الأقصى لعدد المربّعات الحدودية للعناصر المسموح لها بالتداخل مع مربّع. يجب أن يكون هذا الرقم غير سالب.

rankingOptions

object (RankingOptions)

خيارات لتحديد ترتيبات الترتيب حسب العمق وترتيبات التخفيف للعناصر

ThinningOptions

خيارات التخفيف التي تتحكّم في الكثافة التي يتم بها عرض العناصر لكل مربّع

تمثيل JSON
{
  "maxFeaturesPerTile": integer,
  "thinningStrategy": enum (ThinningStrategy)
}
الحقول
maxFeaturesPerTile

integer

الحد الأقصى لعدد المربّعات الحدودية للعناصر المسموح لها بالتداخل مع مربّع. يجب أن يكون هذا الرقم غير سالب.

thinningStrategy

enum (ThinningStrategy)

استراتيجية تقليل عدد الميزات التي يجب استخدامها

ThinningStrategy

استراتيجية تقليل عدد الميزات

عمليات التعداد
UNKNOWN_THINNING_STRATEGY استراتيجية تخفيف غير معروفة.
GLOBALLY_CONSISTENT عند التخفيف بدرجة LOD معيّنة، يعني التخفيف الموحّد على مستوى العالم أنّه في حال إزالة عنصر من خلال التخفيف، ستتم أيضًا إزالة جميع العناصر الأخرى التي لها ترتيب تخفيف مماثل أو أسوأ.
HIGHER_DENSITY

عند تقليل عدد العناصر، حاوِل الاقتراب قدر الإمكان من الحد الأقصى لعدد العناصر لكل مربّع. سنفضّل الميزات ذات الترتيب الأعلى على الميزات ذات الترتيب الأدنى، ولكننا سنتخلّص أحيانًا من الميزات ذات الترتيب الأعلى إذا كان ذلك يساعدنا في تحقيق كثافة أكبر للميزات.

نضمن أنّ الاستراتيجية حتمية، وأنّ مجموعة العناصر بعد التخفيف ستكون مجموعة شاملة من تلك التي تم إنشاؤها من خلال التخفيف المتسق على مستوى العالم.

RankingOptions

خيارات الترتيب لترتيب z وتخفيف الكثافة

تمثيل JSON
{
  "zOrderRankingRule": {
    object (RankingRule)
  },
  "thinningRankingRule": {
    object (RankingRule)
  }
}
الحقول
zOrderRankingRule

object (RankingRule)

قاعدة الترتيب لمنح ترتيبات الترتيب حسب العمق إلى العناصر

thinningRankingRule

object (RankingRule)

قاعدة الترتيب لتعيين ترتيبات التخفيف إلى العناصر

RankingRule

قواعد الترتيب التي تتحكّم في كيفية ترتيب العناصر لتخفيف الكثافة وترتيبها حسب الارتفاع

تمثيل JSON
{
  "rankByOneThingRule": [
    {
      object (RankByOneThingRule)
    }
  ]
}
الحقول
rankByOneThingRule[]

object (RankByOneThingRule)

قائمة مرتبة من قواعد ترتيب حسب سمة واحدة (مثل سمة) بدون قواعد أو أكثر، والتي تُستخدَم كمفاتيح ترتيب أساسية وثانوية وما إلى ذلك لضبط 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)

ترتيب حسب الحد الأدنى لمستوى التفاصيل الذي يظهر فيه شكل العنصر لأول مرة تظهر دائمًا العناصر التي تحتوي على أي نقاط في جميع مستويات التفاصيل. تم إيقاف هذه السمة نهائيًا: يُرجى استخدام rankByMinZoomLevelRule بدلاً منها.

rankByGeometryTypeRule

object (RankByGeometryTypeRule)

الترتيب حسب نوع الشكل الهندسي ترتيب الأولوية للأنواع، من الأعلى إلى الأدنى: مضلّع، وخط متعدد الخطوط، ونقطة، وبدون. في الميزات التي تتضمّن أنواعًا متعدّدة، تكون الأولوية للنوع الأعلى.

rankByMinZoomLevelRule

object (RankByMinZoomLevelRule)

ترتيب حسب الحد الأدنى لمستوى التكبير الذي يظهر فيه شكل العنصر لأول مرة تظهر دائمًا العناصر التي تحتوي على أي نقاط في جميع مستويات التفاصيل.

direction

enum (Direction)

ما إذا كان يجب ترتيب النتائج حسب هذا العامل بترتيب تصاعدي (القيم الأقل أولاً، أي الأكثر أهمية) أو تنازلي (القيم الأعلى أولاً، أي الأكثر أهمية) بعبارة أخرى، يعني ASCENDING استخدام الترتيب الموضّح مباشرةً في مستندات الرسالة الفرعية RankByAttributeRule (أو غيرها) أدناه، ويعني DESCENDING عكس هذا الترتيب.

RankByAttributeRule

الترتيب حسب قيمة سمة العنصر

تمثيل JSON
{
  "attributeName": string
}
الحقول
attributeName

string

ترتيب النتائج حسب قيمة السمة التي تحمل الاسم المحدّد هذا هو الترتيب الطبيعي لقيم النوع المحدّد، مع بعض التفاصيل والتوضيحات: - بالنسبة إلى السمات الصحيحة، تأتي القيم الأقل قبل القيم الأعلى - بالنسبة إلى السمات المزدوجة، تأتي القيم الأقل قبل القيم الأعلى مع اعتبار NaN أقل من جميع القيم الأخرى بما في ذلك ما لا نهاية ناقصًا - بالنسبة إلى السمات المنطقية، يُعتبَر أنّ القيمة false تأتي قبل القيمة true - بالنسبة إلى سمات تاريخ_الوقت، تأتي القيم الأقدم قبل القيم الأحدث - يتم ترتيب سمات السلسلة أبجديًا - يُعتبَر أنّ السمة التي لم يتم ضبط قيمتها لها القيمة التلقائية للنوع المحدّد (0 للقيمة الصحيحة، وfalse للقيمة المنطقية، وما إلى ذلك).

RankByMinVisibleLodRule

لا يحتوي هذا النوع على أي حقول.

ترتيب حسب الحد الأدنى لمستوى التفاصيل الذي يظهر فيه شكل العنصر لأول مرة تظهر دائمًا العناصر التي تحتوي على أي نقاط في جميع مستويات التفاصيل.

RankByGeometryTypeRule

لا يحتوي هذا النوع على أي حقول.

الترتيب حسب نوع الشكل الهندسي ترتيب الأولوية للأنواع، من الأعلى إلى الأدنى: مضلّع، وخط متعدد الخطوط، ونقطة، وبدون. في الميزات التي تتضمّن أنواعًا متعدّدة، تكون الأولوية للنوع الأعلى.

RankByMinZoomLevelRule

لا يحتوي هذا النوع على أي حقول.

ترتيب حسب الحد الأدنى لمستوى التكبير الذي يظهر فيه شكل العنصر لأول مرة تظهر دائمًا العناصر التي تحتوي على أي نقاط في جميع مستويات التفاصيل.

الاتجاه

ما إذا كان سيتم ترتيب قائمة من الأدنى إلى الأعلى (تصاعدي) أو من الأعلى إلى الأدنى (تنازلي).

عمليات التعداد
DIRECTION_UNSPECIFIED لم يتم تحديد اتجاه الترتيب.
ASCENDING ترتيب تصاعدي
DESCENDING ترتيب تنازلي

النوع

أنواع مواد العرض

عمليات التعداد
TYPE_UNSPECIFIED غير محدد
IMAGE صورة:
IMAGE_COLLECTION مجموعة صور
TABLE جدول.
FOLDER مجلد.
CLASSIFIER مصنِّف
FEATURE_VIEW مادة عرض FeatureView

ImageBand

معلومات عن نطاق بيانات واحد لمادة عرض صورة

تمثيل 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)

القيم التي تشير إلى البيانات غير المتوفّرة

PixelDataType

تُحدِّد النوع الرقمي للبكسل في شريط الصورة.

تمثيل JSON
{
  "precision": enum (Precision),
  "range": {
    object (DoubleRange)
  },
  "dimensionsCount": integer
}
الحقول
precision

enum (Precision)

الدقة الرقمية للنوع

range

object (DoubleRange)

نطاق النوع الرقمي، إن توفّر لا تتوفّر عادةً لأنواع الأرقام العشرية.

dimensionsCount

integer

عدد السمات في نوع بيانات قيمته صفيف، أو صفر للإشارة إلى نوع عددي عادي

الدقة

تُحدِّد دقة نوع البيانات الرقمية.

عمليات التعداد
PRECISION_UNSPECIFIED غير محدد
INT يحتوي نوع البيانات على دقة عدد صحيح. يُرجى العِلم أنّ هذا يمكن أن يمثّل أعدادًا صحيحة بحجم مختلف.
FLOAT يتميز نوع البيانات بدقة فاصلة عائمة 32 بت.
DOUBLE يتميز نوع البيانات بدقة فاصلة عائمة (مزدوجة) بسعة 64 بت.

MissingData

قائمة بالقيم التي لا تمثّل أي بيانات

تمثيل JSON
{
  "values": [
    number
  ]
}
الحقول
values[]

number

القيم التي لا تمثّل أي بيانات

FolderQuota

يصف الاستخدام الحالي للحدود القصوى لمجلد بمستوى أعلى.

تمثيل 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)

الحد الأقصى لعدد مواد العرض التي يمكن تخزينها في المجلد

مجموعة البلاط

مجموعة من مصادر الصور التي يمكن الإشارة إليها باستخدام معرّف فريد

تمثيل 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 في الحالات الأخرى

ImageSource

ملف صورة وملفاته الجانبية

تمثيل JSON
{
  "uris": [
    string
  ],
  "affineTransform": {
    object (AffineTransform)
  },
  "dimensions": {
    object (GridDimensions)
  }
}
الحقول
uris[]

string

عناوين URL للبيانات المطلوب استيرادها في الوقت الحالي، تتوفّر معرّفات الموارد المنتظمة (URI) لخدمة Google Cloud Storage فقط. يجب تحديد كل عنوان URL بالتنسيق التالي: "gs://bucket-id/object-id". يجب أن يكون العنصر الأساسي هو العنصر الأول في القائمة، ويجب إدراج العناصر الجانبية بعد ذلك. يُضاف البادئة ImageManifest.uri_prefix إلى كلّ معرّف موارد منتظم (URI) في حال ضبطها.

affineTransform

object (AffineTransform)

عملية تحويل خطي اختيارية يجب عدم تحديد هذا الخيار إلا إذا لم تكن البيانات الواردة من uris (بما في ذلك أيّ ملفات جانبية) كافية لوضع الوحدات البكسيلية.

dimensions

object (GridDimensions)

أبعاد الصورة المركّبة بالبكسل لا يتم استخدام هذا الحقل إلا عند ضبط skipMetadataRead.

DataType

تُحدِّد نوع البيانات الرقمية.

عمليات التعداد
DATA_TYPE_UNSPECIFIED غير محدد
INT8 عدد صحيح موقَّع 8 بت
UINT8 عدد صحيح غير موقَّت بسعة 8 بت
INT16 عدد صحيح بقيمة سالبة أو موجبة 16 بت
UINT16 عدد صحيح غير موقَّت بسعة 16 بت
INT32 عدد صحيح موقَّع 32 بت
UINT32 عدد صحيح غير موقَّت بسعة 32 بت
FLOAT قيمة عائمة 32 بت
DOUBLE قيمة عددية عائمة بسعة 64 بت

الطُرق

copy

نسخ مادة عرض

create

لإنشاء مادة عرض

delete

لحذف مادة عرض

get

للحصول على معلومات تفصيلية عن مادة عرض

getIamPolicy

تحصل على سياسة التحكّم في الوصول إلى مورد.

getPixels

تُستخدَم هذه الدالة لجلب وحدات البكسل من مادة عرض صورة.

listAssets

يسرد أي مادة عرض حاوية، مثل مجلد أو مجموعة.

listFeatures

يسرد العناصر في مادة عرض جدول.

move

نقل مادة عرض

patch

تعديل مادة عرض

setIamPolicy

تُستخدَم لضبط سياسة التحكّم في الوصول إلى المورد المحدّد.

testIamPermissions

عرض الأذونات التي يمتلكها المتصل على المورد المحدّد