Method: projects.tables.create

تُنشئ معرّفًا يمكن استخدامه لعرض بيانات "الجدول".

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

تتمثّل حالة الاستخدام الأكثر شيوعًا لهذا الزوج من نقاط النهاية في تقديم تعبير معقّد عبر طلب POST إلى tables.create، ثم استرجاع الجدول المحسوب عبر طلب GET إلى tables.getFeatures. تتيح هذه العملية المكوّنة من جزأين استخدامها في مواقف أكثر من ComputeFeatures. على وجه الخصوص: - تتطلّب نتيجة ComputeFeatures تقسيم الصفحات للاطّلاع على جميع الميزات. بالإضافة إلى ذلك، يتم عرض Feature فردية فقط. - لا يمكن استدعاء ComputeFeatures إلا من قِبل مستخدم مفوَّض باستخدام رمز مميَّز OAuth ذي نطاق مناسب. يسري القيد نفسه على tables.create، ولكن يمكن استدعاء GetTableData باستخدام عنوان URL يحتوي على مفتاح واجهة برمجة التطبيقات، وبالتالي يمكن استخدام عناوين URL التي تستدعيه على نطاق أوسع.

طلب HTTP

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

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

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

المعلمات
parent

string

مطلوب. العنصر الرئيسي للموقع الجغرافي الذي سيتم إنشاء الجدول فيه (مثل "projects/*").

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

المعلمات
workloadTag

string

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

نص الطلب

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

نص الاستجابة

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

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

يتطلب أحد نطاقات 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.