Method: projects.assets.getPixels

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

הבקשות מוגבלות ל-48MB של נתונים לא דחוסים לכל בקשה, שמחושב כמכפלה של מידות הבקשה בפיקסלים, מספר פס התמונה המבוקש ומספר הבייטים לכל פיקסל בכל פס. בנוסף, הבקשות מוגבלות ל-32,000 פיקסלים לכל היותר בכל אחת מהמידות, ול-1,024 פסים לכל היותר. בקשות שיחרגו מהמגבלות האלה יגרמו לקוד שגיאה 400 (BAD_REQUEST).

אם הפעולה תצליח, גוף התגובה יכלול את נתוני הפיקסלים המבוקשים בקידוד שצוין בשדה fileFormat בבקשה.

בקשת HTTP

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

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

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

פרמטרים
name

string

חובה. השם של נכס התמונה שממנו רוצים לקבל פיקסלים. name צריך להיות בפורמט 'projects/*/assets/**' (למשל, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). כל הנכסים שבבעלות המשתמשים נמצאים בפרויקט earthengine-legacy (למשל, "projects/earthengine-legacy/assets/users/foo/bar"). כל שאר הנכסים נמצאים בפרויקט earthengine-public (למשל, "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

גוף הבקשה

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

ייצוג ב-JSON 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
שדות
fileFormat

enum (ImageFileFormat)

פורמט קובץ הפלט שבו יוחזרו ערכי הפיקסלים.
grid

object (PixelGrid)

פרמטרים שמתארים את רשת הפיקסלים שבה צריך לאחזר נתונים. ברירת המחדל היא רשת הפיקסלים המקורית של הנתונים.
region

object (Struct format)

אם השדה הזה קיים, הוא מציין את האזור של הנתונים שיש להחזיר, כפי שמוגדר באובייקט גיאומטריה של GeoJSON (ראו RFC 7946). מכיוון שהתמונה שתוחזר תמיד ריבועית, בעצם נעשה שימוש בתיבת המכסה של הגיאומטריה הנתונה במערכת הקואורדינטות של הפלט. אם מציינים גם את grid.dimensions, בסיום תתבצע שינוי של גודל התצוגה של הרשת לגודל המבוקש.
bandIds[]

string

אם הערך הזה קיים, הוא מציין קבוצה ספציפית של פסים שמהם רוצים לקבל פיקסלים. הפסקות מזוהות לפי מזהה, כפי שמצוין בשדה id של פרוטו ImageBand.
visualizationOptions

object (VisualizationOptions)

אם האפשרות הזו קיימת, היא כוללת קבוצה של אפשרויות להצגת נתונים חזותית, שאפשר להחיל כדי ליצור תצוגה חזותית של הנתונים בפורמט RGB של 8 ביט, במקום להחזיר את הנתונים הגולמיים.
workloadTag

string

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, התשובה היא תגובה רגילה של HTTP שהפורמט שלה מוגדר על ידי השיטה.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של 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.