יצירת מזהה שאפשר להשתמש בו כדי להציג נתוני 'טבלה'.
משתמשים בו בשילוב עם tables.getFeatures. קריאה ל-tables.create מספקת ביטוי וכמה אפשרויות פלט. התוצאה של tables.create היא מזהה שמייצג טבלה שהיא תוצאת הערכת הביטוי הזה והחלה של האפשרויות האלה. לאחר מכן, אפשר לבצע קריאות ל-tables.getFeatures כדי לקבל את נתוני הטבלה של כל הטבלה שנוצרה. התעודה המזהה תהיה תקפה למשך פרק זמן קצר (כמה שעות).
התרחיש לדוגמה הנפוץ ביותר לשימוש בשני נקודות הקצה האלה הוא לספק ביטוי מורכב באמצעות POST אל tables.create, ולאחר מכן לאחזר את הטבלה המחושבת באמצעות GET אל tables.getFeatures. התהליך הזה, שמורכב משני חלקים, מאפשר שימוש במצבים רבים יותר מאשר ComputeFeatures. באופן ספציפי: - התוצאה של ComputeFeatures דורשת חלוקה לדפים כדי לקבל את כל התכונות. בנוסף, המערכת מחזירה רק ערכים ספציפיים של Feature. - רק משתמש מורשה יכול להפעיל את ComputeFeatures באמצעות אסימון OAuth ברמת היקף מתאימה. ל-tables.create יש את אותה הגבלה, אבל אפשר להפעיל את GetTableData באמצעות כתובת URL שמכילה מפתח API, כך שאפשר להשתמש בכתובות URL שמפעילות אותו באופן רחב יותר.
בקשת HTTP
POST https://earthengine.googleapis.com/v1/{parent=projects/*}/tables
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
parent |
חובה. ההורה של המיקום שבו הטבלה תיווצר (למשל, "projects/*"). |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
workloadTag |
תג שהמשתמש סיפק כדי לעקוב אחרי החישוב הזה. |
גוף הבקשה
גוף הבקשה מכיל מופע של Table.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Table.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/earthengine.readonlyhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
מידע נוסף זמין בOAuth 2.0 Overview.