Method: projects.locations.maps.create

יצירת מזהה שאפשר להשתמש בו כדי ליצור ריבועי מפה שמוצגות בהם תוצאות החישוב. צריך להשתמש במזהה שנוצר כחלק מבקשות GetTile.

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

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

בקשת HTTP

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/maps

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

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

פרמטרים
parent

string

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

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

  • earthengine.maps.create

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

פרמטרים
workloadTag

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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