قدّمت Earth Engine فئات حصص غير تجارية لحماية موارد الحوسبة المشتركة وضمان أداء موثوق للجميع. تستخدم المشاريع غير التجارية "فئة المجتمع" تلقائيًا، ولكن يمكنك تغيير فئة المشروع في أي وقت.

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

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`

project

string

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

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

earthengine.exports.create

نص الطلب

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

تمثيل JSON

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

تمثيل JSON
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { 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, "scale": number // End of mutually exclusive fields. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    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,
  "scale": number
  // End of mutually exclusive fields.
}

الحقول
`startZoom`	`integer` مستوى التكبير/التصغير الذي يجب بدء إنشاء مربّعات الخريطة لتصديرها عنده يتم ضبط القيمة تلقائيًا على صفر.
`skipEmpty`	`boolean` إذا كانت القيمة "true"، يتم تخطّي كتابة مربّعات الخريطة الفارغة (أي الشفافة بالكامل).
`mapsApiKey`	`string` مفتاح واجهة برمجة تطبيقات منصة خرائط Google اختياري لعارض مربّعات الخريطة التي تم إنشاؤها
`dimensions`	`object (GridDimensions)` عرض مربّعات الفيديو الناتجة وارتفاعها، ويُستخدم فقط لتصدير أهرامات الفيديو المقسّمة إلى مربّعات (ExportVideoMap)
`stride`	`integer` خطوة الصف والعمود في المربّع (ExportVideoMap) يتم ضبط القيمة على 4 للمربّعات المتفرّقة (خاصة بـ WebGL فقط) أو 1 (القيمة التلقائية) لتحقيق أقصى توافق.
`zoomSubset`	`object (ZoomSubset)` مجموعة فرعية من مستويات التكبير/التصغير التي سيتم إنشاء مربّعات لها لا يمكن تحديدها إلا في طلب `ExportVideoMap`.
مستوى التكبير/التصغير أو المقياس الذي يجب التوقف عن إنشاء مربّعات الخريطة عنده يجب تحديد أحد هذين الخيارَين. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الاستجابة:
`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} يُرجى أيضًا العِلم أنّ جميع أجزاء التصدير يجب أن يكون لها حجم الهرم نفسه (الكامل) في startZoom/endZoom.

تمثيل JSON
{ "start": number, "end": number }

الحقول

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

start

number

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

end