Method: projects.image.computePixels

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

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

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

בקשת HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:computePixels

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

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

פרמטרים
project

string

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

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

  • earthengine.computations.create

גוף הבקשה

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

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

object (Expression)

הביטוי לחישוב.

fileFormat

enum (ImageFileFormat)

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

grid

object (PixelGrid)

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

bandIds[]

string

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

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.