Method: projects.map.export

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

طلب HTTP

POST https://earthengine.googleapis.com/v1/{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,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
الحقول
startZoom

integer

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

skipEmpty

boolean

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

mapsApiKey

string

مفتاح Google Maps Platform API اختياري لعارض مربّعات الخريطة التي تم إنشاؤها

dimensions

object (GridDimensions)

عرض مربّعات الفيديو التي يتم عرضها وارتفاعها، لا تُستخدَم إلا لتصدير مخططات الفيديوهات المربّعة (ExportVideoMap).

stride

integer

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

zoomSubset

object (ZoomSubset)

مجموعة فرعية من مستويات التكبير/التصغير لإنشاء مربّعات بها لا يمكن تحديدها إلا في طلب موجَّه إلى ExportVideoMap.

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

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 } يُرجى العلم أيضًا أنّه يجب أن يكون حجم الهرم (الكامل) نفسه في start/endZoom لجميع أقسام التصدير.

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

number

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

end

number

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