يبدأ عملية مجمّعة تعمل على احتساب خريطة مصغّرة وتُسجّل النتيجة في Google Cloud Storage.
طلب HTTP
POST https://earthengine.googleapis.com/v1/{project=projects/*}/map:export
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
project |
معرّف المشروع أو رقم المشروع على Google Cloud Platform الذي يجب التعامل معه كمستهلك الخدمة لهذا الطلب. التنسيق هو يتطلب التفويض إذن IAM التالي على المورد المحدّد
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "expression": { object ( |
الحقول | |
---|---|
expression |
تعبير يُحتسب على أنّه الصورة المطلوب احتسابها وتصديرها سيتم استخدام حدود الصورة لتحديد مجموعة شرائح الخريطة التي سيتم عرضها. للتحكّم في المنطقة التي يتم تصديرها، عليك اقتصاص الصورة قبل تصديرها. |
description |
اسم المهمة الذي يمكن لشخص عادي قراءته |
tileOptions |
خيارات تصف مربّعات الخريطة المطلوب إنشاؤها |
tileExportOptions |
خيارات لمكان تصدير مربّعات الخريطة وشكل تصديرها إنّ Cloud Storage هي الوجهة الوحيدة المتاحة حاليًا لعمليات تصدير الخرائط. |
requestId |
سلسلة فريدة تُستخدَم لرصد الطلبات المكرّرة إذا قدّم المستخدم نفسه أكثر من طلب واحد باستخدام |
workloadTag |
تصنيف يوفّره المستخدِم لتتبُّع عملية الحساب هذه |
priority |
اختياريّ. أولوية مهمة التصدير ضمن المشروع يتم تحديد موعد مبكر للمهام ذات الأولوية الأعلى. يجب أن تكون القيمة عددًا صحيحًا بين 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 ( |
الحقول | |
---|---|
startZoom |
مستوى التكبير/التصغير لبدء إنشاء شرائح الخريطة بغرض تصديرها القيمة التلقائية هي صفر. |
skipEmpty |
إذا كانت القيمة "true"، سيتم تخطّي كتابة مربّعات الخريطة الفارغة (أي الشفافة بالكامل). |
mapsApiKey |
مفتاح Google Maps Platform API اختياري لعارض مربّعات الخريطة التي تم إنشاؤها |
dimensions |
عرض مربّعات الفيديو التي يتم عرضها وارتفاعها، لا تُستخدَم إلا لتصدير مخططات الفيديوهات المربّعة (ExportVideoMap). |
stride |
خطوة الصف والعمود في المربّع (ExportVideoMap) اضبط القيمة على 4 للوحات المربّعة المتفرقة (WebGL فقط) أو 1 (القيمة التلقائية) لتحقيق أقصى توافق. |
zoomSubset |
مجموعة فرعية من مستويات التكبير/التصغير لإنشاء مربّعات بها لا يمكن تحديدها إلا في طلب موجَّه إلى |
حقل الربط end_zoom_or_scale مستوى التكبير أو المقياس الذي يتم عند الوصول إليه إيقاف إنشاء شرائح الخريطة يجب تحديد أحدهما. يمكن أن يكون end_zoom_or_scale واحدًا فقط مما يلي: |
|
endZoom |
مستوى التكبير/التصغير الذي يتم إيقاف إنشاء مربعات الخريطة عنده |
scale |
الحد الأقصى لدقة الصورة بالمتر لكل بكسل سيتم تحويل مقياس الرسم إلى الحد الأقصى الأنسب لمستوى التكبير/التصغير عند خط الاستواء. |
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 |
مجموعة فرعية لبدء مستوى التكبير المطلوب إنشاء مربّعاتها (ExportVideoMap): في هذه الحالة، تكون المجموعة الفرعية قيمة ذات دقة مزدوجة، ما يتيح لك عرض مستوى تكبير بشكل تدريجي، لذا فإنّ 12.1 على سبيل المثال هو أول% 10 من المربّعات في مستوى التكبير 12 بترتيب غير محدّد ولكن حتمي. |
end |
مجموعة فرعية نهائية لمستوى التكبير أو التصغير لإنشاء مربّعات (ExportVideoMap)، ما يتيح لك عرض مستوى تكبير أو تصغير بشكل تدريجي، حتى الحد الأقصى للمجموعة الفرعية (إن توفّرت) بدون تضمينها، وذلك بترتيب غير محدّد ولكن حتمي. |