Method: projects.maps.create

تُنشئ هذه السمة رقم تعريف يمكن استخدامه لعرض شرائح الخريطة التي تعرض نتائج عملية حسابية. يجب استخدام المعرّف الناتج كجزء من طلبات GetTile.

تُستخدَم هذه السمة مع السمة GetTile. توفّر الدعوة إلى maps.create تعبيرًا وبعض خيارات الإخراج. نتيجة maps.create هي معرّف خريطة يمثّل صورة هي نتيجة تقييم هذا التعبير وتطبيق هذه الخيارات. بعد ذلك، يمكن إجراء طلبات إلى GetTile للحصول على بيانات الصورة لمربّع من الصورة الناتجة، في أي موقع جغرافي ومستوى تكبير أو تصغير مطلوبَين. سيكون معرّف الخريطة صالحًا لفترة معتدلة (بضع ساعات).

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

طلب HTTP

POST https://earthengine.googleapis.com/v1/{parent=projects/*}/maps

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

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

المعلمات
parent

string

مطلوب. العنصر الرئيسي لمجموعة الخرائط (مثل "projects/*").

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

  • earthengine.maps.create

مَعلمات طلب البحث

المعلمات
workloadTag

string

علامة قدّمها المستخدِم لتتبُّع هذا الحساب

نص الطلب

يحتوي نص الطلب على مثال EarthEngineMap.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من EarthEngineMap.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

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