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)

تمّ الإيقاف. يمكنك استخدام ImportExternalImage كبديل. لمزيد من التفاصيل، يُرجى الانتقال إلى https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.

featureViewAssetLocation

object (FeatureViewLocation)

موقع FeatureView هذا في EE

CloudStorageLocation

تمثّل هذه السمة الموقع الجغرافي لأحد الأصول على Cloud Storage.

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

string

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

FeatureViewLocation

أحد مواد عرض FeatureView EE.

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

object (FeatureViewOptions)

خيارات وقت الاستيعاب لمواد عرض FeatureView

FeatureViewOptions

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

FeatureViewIngestionTimeParameters

مَعلمات وقت نقل البيانات إلى FeatureView يجب تحديد هذه المَعلمات في وقت الاستيعاب، ولا يمكن تعديلها أثناء التنفيذ في FeatureView.

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

object (ThinningOptions)

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

rankingOptions

object (RankingOptions)

خيارات لتعيين ترتيبات z وترتيبات التخفيف للعناصر

ThinningOptions

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

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

integer

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

thinningStrategy

enum (ThinningStrategy)

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

ThinningStrategy

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

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

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

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

RankingOptions

خيارات الترتيب حسب العمق والتقليل.

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

object (RankingRule)

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

thinningRankingRule

object (RankingRule)

قاعدة الترتيب لتحديد ترتيبات التخفيف للميزات

RankingRule

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

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

object (RankByOneThingRule)

قائمة مرتّبة تضم صفرًا أو أكثر من قواعد الترتيب حسب عنصر واحد (مثل سمة)، ويتم استخدامها كمفاتيح ترتيب أساسية وثانوية وما إلى ذلك لضبط thinning_rank في كل RankedFeature.

RankByOneThingRule

قاعدة ترتيب فردية للتحكّم في الترتيب من أجل التخفيف والترتيب حسب العمق

تمثيل 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 أصغر من جميع القيم الأخرى، بما في ذلك سالب اللانهاية - بالنسبة إلى السمات المنطقية، يتم اعتبار القيمة "خطأ" قبل القيمة "صحيح" - بالنسبة إلى سمات date_time، تأتي القيم الأقدم قبل القيم الأحدث - يتم ترتيب سمات السلسلة معجميًا - يتم اعتبار السمة التي لم يتم ضبط قيمتها على أنّها القيمة التلقائية للنوع المحدّد (0 للعدد الصحيح، و"خطأ" للقيمة المنطقية، وما إلى ذلك).

RankByMinVisibleLodRule

لا يتضمّن هذا النوع أي حقول.

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

RankByGeometryTypeRule

لا يتضمّن هذا النوع أي حقول.

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

RankByMinZoomLevelRule

لا يتضمّن هذا النوع أي حقول.

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

الاتجاه

تحديد ما إذا كان سيتم ترتيب قائمة من الأدنى إلى الأعلى (ASCENDING) أو من الأعلى إلى الأدنى (DESCENDING)

عمليات التعداد
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)

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

مجموعة المربّعات

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

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

تمثّل هذه السمة معرّفات الموارد الموحّدة (URI) للبيانات المطلوب استيرادها. في الوقت الحالي، لا تتوفّر سوى معرّفات الموارد المنتظمة (URI) لخدمة Google Cloud Storage. يجب تحديد كل معرّف URI بالتنسيق التالي: "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

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