Method: projects.locations.thumbnails.create

יצירת מזהה שאפשר להשתמש בו כדי ליצור תמונה 'ממוזערת'.

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

התרחיש לדוגמה הנפוץ ביותר לשימוש בשני נקודות הקצה האלה הוא לספק ביטוי מורכב באמצעות POST אל thumbnails.create, ואז לאחזר את התמונה המחושבת באמצעות GET אל GetThumbnailPixels. התהליך הזה, שמורכב משני חלקים, מאפשר שימוש במצבים רבים יותר מאשר ComputePixels. באופן ספציפי: - צריך לפתוח את האריזה של התוצאה של ComputePixels כדי לקבל את הבייטים של התמונה המוצפנת. התוצאה של GetThumbnailPixels יכולה להופיע ישירות בדפדפן. - רק משתמש מורשה יכול להפעיל את ComputePixels באמצעות אסימון OAuth ברמת היקף מתאימה. ל-thumbnails.create יש את אותה הגבלה, אבל אפשר להפעיל את GetThumbnailPixels באמצעות כתובת URL שמכילה מפתח API, כך שאפשר להשתמש בכתובות URL שמפעילות אותו באופן רחב יותר.

התוצאה של הערכת הביטוי צריכה לעמוד בדרישות סבירות לגבי פורמט התמונה המבוקש. באופן ספציפי, בפורמט JPEG או PNG צריכים להיות פס אחד או שלושה של פלט, וערכים של קליפים מחוץ לטווח 0-255.

התיאור 'תמונה ממוזערת' לא מרמז על הגבלה על גודל התמונה המחושבת: אותן הגבלות שחלות על ComputePixels חלות על thumbnails.create/GetThumbnailPixels. הבקשות מוגבלות ל-48MB של נתונים לא דחוסים לכל בקשה, שמחושבים כמכפלה של מידות הבקשה בפיקסלים, מספר פס התמונה המבוקש ומספר הבייטים לכל פיקסל בכל פס. בנוסף, הבקשות מוגבלות ל-32,000 פיקסלים לכל היותר בכל אחת מהמידות, ול-1,024 פסים לכל היותר. בקשות שיחרגו מהמגבלות האלה יגרמו לקוד שגיאה 400 (BAD_REQUEST).

בקשת HTTP

POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/thumbnails

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

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

פרמטרים
parent

string

חובה. הורה של אוסף התמונות הממוזערות (למשל, "projects/*").

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

  • earthengine.thumbnails.create

פרמטרים של שאילתה

פרמטרים
workloadTag

string

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

גוף הבקשה

גוף הבקשה מכיל מופע של Thumbnail.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Thumbnail.

היקפי הרשאה

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