Method: projects.map.export

يبدأ عملية دفعية تحسب خريطة مقسّمة إلى مربّعات وتكتب النتيجة في Google Cloud Storage.

طلب HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
project

string

رقم تعريف المشروع أو رقم مشروع Google Cloud Platform الذي يجب التعامل معه كمستهلك للخدمة لهذا الطلب التنسيق هو projects/{project-id}.

يتطلب التفويض إذن IAM التالي على المورد المحدّد project:

  • earthengine.exports.create

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
الحقول
expression

object (Expression)

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

string

اسم المهمة قابل للقراءة
tileOptions

object (TileOptions)

خيارات تصف مربّعات الخريطة المطلوب إنشاؤها
tileExportOptions

object (ImageFileExportOptions)

خيارات تحديد مكان تصدير مربّعات الخريطة وشكلها في الوقت الحالي، Cloud Storage هو الوجهة الوحيدة المتاحة لتصدير الخرائط.
requestId

string

سلسلة فريدة تُستخدم لرصد الطلبات المكرّرة إذا قدّم المستخدم أكثر من طلب واحد باستخدام requestId غير فارغ نفسه، قد يبدأ أحد هذه الطلبات عملية طويلة الأمد بنجاح. قد يحتوي requestId على الأحرف من a إلى z أو من A إلى Z أو من 0 إلى 9 أو على الرمز "-". يمكن أن يصل طول requestId إلى 60 حرفًا كحد أقصى.
workloadTag

string

تصنيف يقدّمه المستخدم لتتبُّع هذا الحساب
priority

integer

اختياريّ. أولوية مهمة التصدير ضمن المشروع تتم جدولة المهام ذات الأولوية الأعلى في وقت أقرب. يجب أن يكون عددًا صحيحًا بين 0 و9999. يتم ضبط القيمة تلقائيًا على 100 إذا لم يتم تحديدها.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Operation.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

TileOptions

خيارات تصف مربّعات الخريطة للصور أو الفيديوهات المطلوب تصديرها

تمثيل JSON 
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
الحقول
startZoom

integer

مستوى التكبير/التصغير الذي يجب بدء إنشاء مربّعات الخريطة لتصديرها عنده يتم ضبط القيمة تلقائيًا على صفر.
minZoom
(deprecated)

integer

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

boolean

إذا كانت القيمة true، يتم تخطّي كتابة مربّعات الخريطة الفارغة (أي الشفافة بالكامل).
skipEmptyTiles
(deprecated)

boolean

إذا كانت القيمة true، يتم تخطّي كتابة مربّعات الخريطة الفارغة (أي الشفافة بالكامل).
mapsApiKey

string

مفتاح واجهة برمجة تطبيقات منصة خرائط Google اختياري لعارض مربّعات الخريطة التي تم إنشاؤها
dimensions

object (GridDimensions)

عرض مربّعات الفيديو الناتجة وارتفاعها، ويُستخدم ذلك فقط لتصدير أهرامات الفيديو المقسّمة إلى مربّعات (ExportVideoMap)
tileDimensions
(deprecated)

object (GridDimensions)

عرض مربّعات الفيديو الناتجة وارتفاعها، ويُستخدم ذلك فقط لتصدير أهرامات الفيديو المقسّمة إلى مربّعات (ExportVideoMap)
stride

integer

خطوة الصف والعمود في المربّع (ExportVideoMap) يتم ضبط القيمة على 4 للمربّعات المتفرقة (خاصة بـ WebGL فقط) أو 1 (القيمة التلقائية) لتحقيق أقصى قدر من التوافق.
zoomSubset

object (ZoomSubset)

مجموعة فرعية من مستويات التكبير/التصغير التي سيتم إنشاء مربّعات لها لا يمكن تحديدها إلا في طلب ExportVideoMap.
مستوى التكبير/التصغير أو المقياس الذي يجب التوقف عن إنشاء مربّعات الخريطة عنده يجب تحديد أحد هذين الخيارَين. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الاستجابة:
endZoom

integer

مستوى التكبير/التصغير الذي يجب التوقف عن إنشاء مربّعات الخريطة عنده
maxZoom
(deprecated)

integer

مستوى التكبير/التصغير الذي يجب التوقف عن إنشاء مربّعات الخريطة عنده
scale

number

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

ZoomSubset

مجموعة فرعية من مستويات التكبير/التصغير التي سيتم إنشاء مربّعات لها (ExportVideoMap)، وتكون المجموعات الفرعية للبدء والانتهاء قيمًا مزدوجة الدقة، ما يسمح لك بعرض مستوى تكبير/تصغير أو مستويات تكبير/تصغير بشكل تدريجي. لعرض هرم كامل بمستوى تكبير/تصغير يبدأ من 12: startZoom=0 وendZoom=12، لا تضبط هذه الرسالة. لعرض المستويات من 0 إلى 11 وأول% 10 من المستوى 12: startZoom=0 وendZoom=12 وsubset = {min=0 وmax=12.1 } لعرض% 10 التالية من المستوى 12: startZoom=0 وendZoom=12 وsubset = {min=12.1 وmax=12.2 } لعرض% 80 المتبقية من المستوى 12: startZoom=0 وendZoom=12 وsubset = {min=12.2 وmax=13 } يُرجى أيضًا العِلم أنّ جميع أجزاء التصدير يجب أن يكون لها حجم الهرم نفسه (الكامل) في startZoom/endZoom.

تمثيل JSON 
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
الحقول
start

number

المجموعة الفرعية لمستوى التكبير/التصغير الذي يجب بدء إنشاء مربّعات له (ExportVideoMap)، حيث تكون المجموعة الفرعية قيمة مزدوجة الدقة، ما يسمح لك بعرض مستوى تكبير/تصغير بشكل تدريجي، لذا فإنّ 12.1 على سبيل المثال هي أول% 10 من المربّعات في مستوى التكبير/التصغير 12 بترتيب غير محدّد ولكنّه ثابت.
end

number

المجموعة الفرعية لمستوى التكبير/التصغير الذي يجب إنهاء إنشاء مربّعات له (ExportVideoMap)، ما يسمح لك بعرض مستوى تكبير/تصغير بشكل تدريجي، حتى المجموعة الفرعية القصوى (إذا تم تقديمها) ولكن بدون تضمينها بترتيب غير محدّد ولكنّه ثابت.
min
(deprecated)

number

المجموعة الفرعية لمستوى التكبير/التصغير الذي يجب بدء إنشاء مربّعات له (ExportVideoMap)، حيث تكون المجموعة الفرعية قيمة مزدوجة الدقة، ما يسمح لك بعرض مستوى تكبير/تصغير بشكل تدريجي، لذا فإنّ 12.1 على سبيل المثال هي أول% 10 من المربّعات في مستوى التكبير/التصغير 12 بترتيب غير محدّد ولكنّه ثابت.
max
(deprecated)

number

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