ImageFileExportOptions

خيارات لتصدير الصور كملفات خارج Earth Engine

تمثيل JSON
{
  "fileFormat": enum (ImageFileFormat),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "geoTiffOptions": {
    object (GeoTiffImageExportOptions)
  },
  "tfRecordOptions": {
    object (TfRecordImageExportOptions)
  }
  // End of mutually exclusive fields.
}
الحقول
fileFormat

enum (ImageFileFormat)

تنسيق الملف الذي سيتم تصدير الصور به.

مكان كتابة النتائج في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
driveDestination

object (DriveDestination)

في حال تحديدها، يتم ضبط عملية التصدير إلى Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

في حال تحديدها، يتم ضبط عملية التصدير إلى Google Cloud Storage.

نهاية الحقول التي يستبعد كلّ منها الآخر
خيارات خاصة بتنسيق الملف في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
geoTiffOptions

object (GeoTiffImageExportOptions)

خيارات خاصة بتنسيق الملفات لعمليات تصدير GEO_TIFF

tfRecordOptions

object (TfRecordImageExportOptions)

خيارات خاصة بتنسيق الملفات لعمليات تصدير TF_RECORD_IMAGE

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

GeoTiffImageExportOptions

خيارات لترميز الصور كملفات GeoTIFF

تمثيل JSON
{
  "cloudOptimized": boolean,
  "tileDimensions": {
    object (GridDimensions)
  },
  "skipEmptyFiles": boolean,
  "tileSize": integer,
  "noData": {
    object (Number)
  },
  "metadataKeys": [
    string
  ]
}
الحقول
cloudOptimized

boolean

إذا كانت القيمة صحيحة، يتم إنشاء ملفات GeoTIFF "محسّنة للسحابة الإلكترونية" لتوفير وصول أكثر فعالية في البيئات السحابية (راجِع www.cogeo.org).

tileDimensions

object (GridDimensions)

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

skipEmptyFiles

boolean

في حال ضبط القيمة على "صحيح"، سيتم تخطّي كتابة ملفات الصور الفارغة (أي التي تم إخفاء جميع عناصرها).

tileSize

integer

اختيارية: معلَمة اختيارية تحدّد حجم المربّع الناتج. تمثّل هذه المَعلمة بُعد الجانب بوحدة البكسل لمربّعات الإخراج الوسيطة. حجم المربّع التلقائي هو 256، وهو ما يتوافق مع مربّع 256x256.

noData

object (Number)

اختيارية: قيمة اختيارية لعدم توفّر البيانات لا تتوفّر حاليًا سوى القيمة noData.float_value.

metadataKeys[]

string

اختيارية: مفاتيح البيانات الوصفية التي سيتم استخدامها لضبط خصائص GeoTIFF. سيتم قراءة قيم السمات لكل مفتاح من صورته. يجب أن تكون هذه القيم سلاسل بشكل عام. بالنسبة إلى المفتاح TIFFTAG_DATETIME، يمكن أن تكون القيم أيضًا مثيلات ee.Date أو أرقامًا (بالملّي ثانية منذ بداية الحقبة)، ويتم تحويلها تلقائيًا إلى تنسيق السلسلة "YYYY:MM:DD HH:MM:SS". إذا تم تحديد TIFFTAG_DATETIME ولكن لم يتم ضبطها على الصورة، سيتم تلقائيًا استخدام قيمة system:time_start إذا كانت متوفرة.

العدد

رقم

تمثيل JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "floatValue": number,
  "integerValue": string
  // End of mutually exclusive fields.
}
الحقول
القيمة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
floatValue

number

قيمة نقطة عائمة بدقة مزدوجة

integerValue

string (int64 format)

قيمة عدد صحيح 64 بت

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

TfRecordImageExportOptions

خيارات لترميز الصور كملفات TFRecord

تمثيل JSON
{
  "tileDimensions": {
    object (GridDimensions)
  },
  "marginDimensions": {
    object (GridDimensions)
  },
  "compress": boolean,
  "maxSizeBytes": string,
  "defaultValue": number,
  "tensorDepths": {
    string: integer,
    ...
  },
  "sequenceData": boolean,
  "collapseBands": boolean,
  "maxMaskedRatio": number
}
الحقول
tileDimensions

object (GridDimensions)

يتم تقسيم الأبعاد إلى مربّعات متجانبة فوق منطقة التصدير، ما يغطّي كل بكسل في المربّع المحيط مرة واحدة بالضبط (إلا عندما لا تقسم أبعاد الرقعة المربّع المحيط بالتساوي، وفي هذه الحالة سيتم إسقاط المربّعات المتجانبة على طول أكبر حواف س/ص). يجب أن تكون الأبعاد أكبر من 0.

marginDimensions

object (GridDimensions)

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

compress

boolean

في حال ضبط القيمة على "صحيح"، يتم ضغط ملفات ‎ .tfrecord باستخدام gzip وإضافة اللاحقة ".gz".

maxSizeBytes

string (Int64Value format)

الحد الأقصى للحجم بالبايت لملف ‎.tfrecord تم تصديره (قبل الضغط) سيؤدي حجم الملف الأصغر إلى تقسيم أكبر (وبالتالي، المزيد من ملفات الإخراج). القيمة التلقائية هي 1 غيغابايت.

defaultValue

number

القيمة المضبوطة في كل نطاق من البكسل الذي تم إخفاؤه جزئيًا أو كليًا، والقيمة المضبوطة في كل قيمة في عنصر ثلاثي الأبعاد ناتج عن نطاق صفيف حيث كان طول الصفيف في بكسل المصدر أقل من عمق قيمة العنصر يتم حذف الجزء الكسري لنطاقات النوع "عدد صحيح"، ويتم حصرها في نطاق نوع النطاق. القيمة التلقائية هي 0.

tensorDepths

map (key: string, value: integer)

ربط أسماء نطاقات مصفوفة الإدخال بعمق موترات الأبعاد الثلاثية التي تنشئها سيتم اقتطاع المصفوفات أو إضافة قيم تلقائية إليها لتناسب الشكل المحدّد. يجب أن يتضمّن كل نطاق مصفوفة إدخالاً مطابقًا.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

sequenceData

boolean

إذا كانت القيمة صحيحة، يتم إخراج كل بكسل كـ SequenceExample يربط النطاقات العددية بالسياق ونطاقات المصفوفة بتسلسلات المثال. يتم عرض SequenceExamples بترتيب الصفوف الرئيسية لوحدات البكسل في كل رقعة، ثم بترتيب الصفوف الرئيسية لرقع المساحات في تسلسل الملفات.

collapseBands

boolean

إذا كانت القيمة "صحيح"، سيتم دمج جميع النطاقات في موتر ثلاثي الأبعاد واحد، مع أخذ اسم النطاق الأول في الصورة. يتم تحويل جميع النطاقات إلى وحدات بايت، ثم إلى أعداد صحيحة 64 بت، ثم إلى أعداد عشرية بهذا الترتيب استنادًا إلى النوع الأبعد في هذا التسلسل ضمن جميع النطاقات. يُسمح بنطاقات المصفوفات طالما تم تحديد tensorDepths.

maxMaskedRatio

number

الحد الأقصى المسموح به لنسبة وحدات البكسل المخفية في رقعة. سيتم تجاهل التصحيحات التي تتجاوز هذا الحدّ بدلاً من كتابتها في الملفات. إذا تم ضبط هذا الحقل على أي قيمة أخرى غير 1، لن يتم إنشاء ملف JSON المصاحب. القيمة التلقائية هي 1.