דף זה תורגם על ידי Cloud Translation API.

Method: projects.map.export

הפונקציה מפעילה תהליך באצווה שמחשב מפה מחולקת לריבועים וכותב את התוצאה ב-Google Cloud Storage.

בקשת HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

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

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

פרמטרים

פרמטרים
`project`	`string` מזהה הפרויקט או מספר הפרויקט ב-Google Cloud Platform שצריך להתייחס אליו כצרכן השירות של הבקשה הזו. הפורמט הוא `projects/{project-id}`. כדי לקבל הרשאה, נדרשת ההרשאה הבאה ב-IAM למשאב שצוין `project`: `earthengine.exports.create`

project

string

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

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

earthengine.exports.create

גוף הבקשה

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "expression": { object (`Expression`) }, "description": string, "tileOptions": { object (`TileOptions`) }, "tileExportOptions": { object (`ImageFileExportOptions`) }, "requestId": string, "workloadTag": string, "priority": integer }

{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}

שדות
`expression`	`object (Expression)` ביטוי שמתקבלת ממנו התמונה לחישוב ולייצוא. המערכת תשתמש בגבולות התמונה כדי לקבוע את קבוצת המשבצות של המפה שצריך ליצור להן רינדור. כדי לקבוע את האזור שייוצא, צריך לחתוך את התמונה לפני הייצוא.
`description`	`string` שם המשימה שקריא לבני אדם.
`tileOptions`	`object (TileOptions)` אפשרויות שמתארות את המשבצות של המפה שייווצרו.
`tileExportOptions`	`object (ImageFileExportOptions)` אפשרויות למקום ולפורמט שבו לייצא את המשבצות של המפה. Cloud Storage הוא היעד היחיד כרגע שאפשר לייצא אליו מפות.
`requestId`	`string` מחרוזת ייחודית המשמשת לזיהוי בקשות כפולות. אם אותו משתמש שולח יותר מבקשה אחת עם אותו `requestId` לא ריק, רק אחת מהבקשות האלה עשויה להתחיל פעולה ממושכת. השדה `requestId` יכול להכיל את התווים a..z,‏ A..Z,‏ 0-9 או '-'. האורך המקסימלי של השדה `requestId` הוא 60 תווים.
`workloadTag`	`string` תווית שהמשתמש סיפק כדי לעקוב אחרי החישוב הזה.
`priority`	`integer` זה שינוי אופציונלי. העדיפות של משימה הייצוא בפרויקט. משימות בעדיפות גבוהה יותר מתוזמנות מוקדם יותר. חייב להיות מספר שלם בין 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

ייצוג ב-JSON
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

שדות
`startZoom`	`integer` רמת הזום שבה מתחילים ליצור אריחי מפה לייצוא. ברירת המחדל היא אפס.
`skipEmpty`	`boolean` אם הערך הוא True, המערכת תדלג על כתיבת אריחי מפה ריקים (כלומר אריחים שקופים לחלוטין).
`mapsApiKey`	`string` מפתח API אופציונלי של הפלטפורמה של מפות Google לצפייה בקטעי המפה שנוצרו.
`dimensions`	`object (GridDimensions)` הרוחב והגובה של משבצות הווידאו בפלט. האפשרות הזו משמשת רק לייצוא של פירמידות וידאו בחלוקה למשבצות (ExportVideoMap).
`stride`	`integer` מרווח השורות והעמודות של המשבצות. (ExportVideoMap) מגדירים את הערך ל-4 עבור משבצות דלילות (WebGL בלבד) או ל-1 (ברירת המחדל) לקבלת תאימות מקסימלית.
`zoomSubset`	`object (ZoomSubset)` קבוצת משנה של רמות זום שעבורן ייווצרו אריחים. אפשר לציין אותו רק בקריאה ל-`ExportVideoMap`.
שדה האיחוד `end_zoom_or_scale`. רמת הזום או קנה המידה שבו המערכת תפסיק ליצור משבצות מפה. צריך לציין אחד מהם. הערך של `end_zoom_or_scale` יכול להיות רק אחת מהאפשרויות הבאות:
`endZoom`	`integer` רמת הזום שבה המערכת תפסיק ליצור אריחי מפה.
`scale`	`number` רזולוציית התמונה המקסימלית במטרים לכל פיקסל. התצוגה תומר לרמת מרחק התצוגה המקסימלית המתאימה ביותר לקו המשווה.

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 } חשוב גם לזכור שלכל פלחי הייצוא צריך להיות אותו גודל פירמידה (מלא) ב-startZoom/endZoom.

ייצוג ב-JSON
{ "start": number, "end": number }

שדות

שדות
`start`	`number` קבוצת משנה של רמת מרחק מתצוגה ראשונית שעבורה ייווצרו משבצות (ExportVideoMap). כאן, קבוצת המשנה היא ערך בעל דיוק כפול, שמאפשר ליצור רמת מרחק מתצוגה באופן מצטבר. לדוגמה, הערך 12.1 הוא 10% הראשונים של המשבצות ברמת מרחק מתצוגה 12 בסדר כלשהו, לא מוגדר אבל דטרמיניסטי.
`end`	`number` קבוצת משנה של רמת הזום הסופית שעבורה ייווצרו משבצות (ExportVideoMap), שמאפשרת ליצור רמת זום באופן מצטבר, עד לקבוצת המשנה המקסימלית (אם צוינה) אבל לא כולל אותה, בסדר מסוים, דטרמיניסטי אבל לא מוגדר.

start

number

קבוצת משנה של רמת מרחק מתצוגה ראשונית שעבורה ייווצרו משבצות (ExportVideoMap). כאן, קבוצת המשנה היא ערך בעל דיוק כפול, שמאפשר ליצור רמת מרחק מתצוגה באופן מצטבר. לדוגמה, הערך 12.1 הוא 10% הראשונים של המשבצות ברמת מרחק מתצוגה 12 בסדר כלשהו, לא מוגדר אבל דטרמיניסטי.

end