Method: projects.table.export

הפונקציה מפעילה תהליך באצווה שמחשב טבלה וכותב את התוצאה לאחד מכמה יעדים.

בקשת HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:export

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
project

string

מזהה הפרויקט או מספר הפרויקט ב-Google Cloud Platform שצריך להתייחס אליו כצרכן השירות של הבקשה הזו. הפורמט הוא projects/{project-id}.

כדי לקבל הרשאה, נדרשת ההרשאה הבאה ב-IAM למשאב שצוין project:

  • earthengine.exports.create

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of list of possible types for union field export_options.
}
שדות
expression

object (Expression)

ביטוי שמתקבלת ממנו הטבלה לחישוב ולייצוא.
description

string

שם המשימה שקריא לבני אדם.
selectors[]

string

רשימה מפורשת של עמודות שרוצים לכלול בתוצאה.
requestId

string

מחרוזת ייחודית המשמשת לזיהוי בקשות כפולות. אם אותו משתמש שולח יותר מבקשה אחת עם אותו requestId לא ריק, רק אחת מהבקשות האלה עשויה להתחיל פעולה ממושכת. השדה requestId יכול להכיל את התווים a..z,‏ A..Z,‏ 0-9 או '-'. האורך המקסימלי של השדה requestId הוא 60 תווים.
maxErrorMeters

number

השגיאה המקסימלית המותרת במטרים במהלך טרנספורמציה של גיאומטריה בין מערכות קואורדינטות. אם השדה ריק, ערך השגיאה המקסימלי הוא מטר אחד כברירת מחדל.
maxVertices

integer

המספר המקסימלי של קודקודים ללא חיתוך לכל גיאומטריה. גיאומטריות עם יותר קודקודים יחתוכו לחתיכות קטנות יותר מהגודל הזה.
workloadTag

string

תווית שהמשתמש סיפק כדי לעקוב אחרי החישוב הזה.
priority

integer

זה שינוי אופציונלי. העדיפות של משימה הייצוא בפרויקט. משימות בעדיפות גבוהה יותר מתוזמנות מוקדם יותר. חייב להיות מספר שלם בין 0 ל-9999. אם לא מגדירים ערך, ערך ברירת המחדל הוא 100.
שדה האיחוד export_options. אפשרויות שמתארות איפה ואיך לשמור את התוצאות. הערך של export_options יכול להיות רק אחת מהאפשרויות הבאות:
fileExportOptions

object (TableFileExportOptions)

אם מצוין, מגדיר את הייצוא כקובץ.
assetExportOptions

object (TableAssetExportOptions)

אם מצוין, מגדיר את הייצוא כנכס ב-Earth Engine.
featureViewExportOptions

object (FeatureViewAssetExportOptions)

אם מצוין, מגדיר את הייצוא כמפה של תצוגת המאפיינים.
bigqueryExportOptions

object (BigQueryExportOptions)

אם מצוין, מגדיר ייצוא של נתונים בטבלאות ל-BigQuery.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של 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.

TableFileExportOptions

אפשרויות לייצוא טבלאות כקבצים מחוץ ל-Earth Engine.

ייצוג ב-JSON 
{
  "fileFormat": enum (TableFileFormat),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
שדות
fileFormat

enum (TableFileFormat)

פורמט הקובץ שבו לייצא את הטבלאות.
שדה האיחוד destination. איפה לכתוב את התוצאות. הערך של destination יכול להיות רק אחת מהאפשרויות הבאות:
driveDestination

object (DriveDestination)

אם מצוין, מגדיר ייצוא ל-Google Drive.
cloudStorageDestination

object (CloudStorageDestination)

אם מצוין, מגדיר ייצוא ל-Google Cloud Storage.

TableAssetExportOptions

אפשרויות לשמירת טבלאות כנכסים ב-Earth Engine.

ייצוג ב-JSON 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
שדות
שדה האיחוד destination. איפה לכתוב את התוצאות. הערך של destination יכול להיות רק אחת מהאפשרויות הבאות:
earthEngineDestination

object (EarthEngineDestination)

אם מצוין, מגדיר ייצוא ל-Earth Engine.

FeatureViewAssetExportOptions

אפשרויות לשמירת טבלאות או FeatureCollections כמפות של FeatureView.

ייצוג ב-JSON 
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

  // Union field destination can be only one of the following:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of list of possible types for union field destination.
}
שדות
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

הפרמטרים של זמן הטמעת הנתונים ב-FeatureView. צריך לציין את הפרמטרים האלה בזמן הטמעת הנתונים, ואי אפשר לעדכן אותם בזמן אמת.
שדה האיחוד destination. איפה לכתוב את התוצאות. הערך של destination יכול להיות רק אחת מהאפשרויות הבאות:
featureViewDestination

object (FeatureViewDestination)

אם מצוין, מגדיר ייצוא ל-FeatureViews.

FeatureViewDestination

הגדרה של יעד FeatureView ב-Earth Engine.

ייצוג ב-JSON 
{
  "name": string,
  "assetVersion": integer
}
שדות
name

string

חובה. מזהה הנכס של תצוגת המאפיינים. השרת יוצר שם מפה מהמזהה.
assetVersion

integer

גרסת הנכס של תצוגת המאפיינים שרוצים ליצור. משמש ליצירת כינויים לגרסאות עם נכסים. אם לא מגדירים את המדיניות, המערכת תשתמש ב-0.

BigQueryExportOptions

אפשרויות לייצוא נתונים בטבלאות ל-BigQuery.

ייצוג ב-JSON 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
שדות
שדה האיחוד destination. איפה לכתוב את הנתונים. הערך של destination יכול להיות רק אחת מהאפשרויות הבאות:
bigqueryDestination

object (BigQueryDestination)

אם מצוין, מגדיר ייצוא ל-BigQuery.

BigQueryDestination

הגדרה של יעד ב-BigQuery.

ייצוג ב-JSON 
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
שדות
table

string

חובה. ההפניה לטבלת היעד ב-BigQuery בפורמט הבא: projectId.dataset_id.table_id.

אם המשאב שמצוין לא קיים, תיווצר טבלה חדשה. המצב הזה רלוונטי גם אם הפרמטרים 'append' ו-'overwrite' הם false.

אם המשאב שמצוין קיים ויש לו סכימה תואמת, אחד מהפרמטרים 'overwrite' ו-'append' צריך להיות true, אחרת המשימה תיכשל.

אם המשאב שמצוין קיים והסכימה לא תואמת להסכימה הקיימת, גם המשימה תיכשל.
overwrite

boolean

מציין אם צריך לשכתב את נתוני הטבלה אם הטבלה כבר קיימת ויש לה הסכימה תואמת.

הפרמטרים overwrite ו-append לא יכולים להיות true בו-זמנית.
append

boolean

קובע אם צריך לצרף את נתוני הטבלה אם הטבלה כבר קיימת ויש לה הסכימה תואמת.

הפרמטרים overwrite ו-append לא יכולים להיות true בו-זמנית.