Method: projects.map.export

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

בקשת HTTP

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

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

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

פרמטרים
project

string

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

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

  • earthengine.exports.create

גוף הבקשה

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

ייצוג 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)

אפשרויות לייצוא של משבצות המפה, כולל המיקום והפורמט. נכון לעכשיו, 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 
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
שדות
startZoom

integer

רמת הזום שבה מתחילים ליצור אריחי מפה לייצוא. ברירת המחדל היא אפס.
minZoom
(deprecated)

integer

רמת הזום שבה מתחילים ליצור אריחי מפה לייצוא. ברירת המחדל היא אפס.
skipEmpty

boolean

אם הערך הוא true, המערכת מדלגת על כתיבה של אריחי מפה ריקים (כלומר, שקופים לחלוטין).
skipEmptyTiles
(deprecated)

boolean

אם הערך הוא true, המערכת מדלגת על כתיבה של אריחי מפה ריקים (כלומר, שקופים לחלוטין).
mapsApiKey

string

מפתח API אופציונלי של Google Maps Platform לצפייה במשבצות מפה שנוצרו.
dimensions

object (GridDimensions)

הרוחב והגובה של משבצות הווידאו בפלט, לשימוש רק בייצוא של פירמידות של משבצות וידאו (ExportVideoMap).
tileDimensions
(deprecated)

object (GridDimensions)

הרוחב והגובה של משבצות הווידאו בפלט, לשימוש רק בייצוא של פירמידות של משבצות וידאו (ExportVideoMap).
stride

integer

המרחק בין שורות ועמודות של משבצות. ‫(ExportVideoMap) מגדירים את הערך ל-4 עבור משבצות דלילות (WebGL בלבד) או ל-1 (ברירת מחדל) כדי לקבל תאימות מקסימלית.
zoomSubset

object (ZoomSubset)

קבוצת משנה של רמות זום שעבורן ייצרו אריחים. אפשר לציין את הערך הזה רק בקריאה ל-ExportVideoMap.
רמת הזום או קנה המידה שבהם יופסק יצירת משבצות המפה. צריך לציין את אחד מהם. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
endZoom

integer

רמת הזום שבה יופסק יצירת אריחי המפה.
maxZoom
(deprecated)

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

ייצוג JSON 
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
שדות
start

number

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

number

קבוצת משנה של רמות הזום שצריך ליצור עבורן משבצות (ExportVideoMap), כדי שתוכלו לעבד רמת זום באופן מצטבר, עד לקבוצת המשנה המקסימלית (אם צוינה) ולא כולל אותה, בסדר לא מוגדר אבל דטרמיניסטי.
min
(deprecated)

number

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

number

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