REST Resource: projects.assets

משאב: EarthEngineAsset

מידע על נכס ב-Earth Engine.

ייצוג ב-JSON
{
  "type": enum (Type),
  "name": string,
  "id": string,
  "updateTime": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string,
  "featureCount": string,
  "quota": {
    object (FolderQuota)
  },
  "tilesets": [
    {
      object (Tileset)
    }
  ],

  // Union field location can be only one of the following:
  "cloudStorageLocation": {
    object (CloudStorageLocation)
  },
  "featureViewAssetLocation": {
    object (FeatureViewLocation)
  }
  // End of list of possible types for union field location.
}
שדות
type

enum (Type)

סוג הנכס.

name

string

שם הנכס. name צריך להיות בפורמט 'projects/*/assets/**' (למשל 'projects/earthengine-legacy/assets/users//').

id

string

מזהה הנכס. זהה ל-name בלי הקידומת 'projects/*/assets/‎' (למשל, 'users//'). חשוב לציין שהפעולה הזו מיועדת למטרות תצוגה בלבד. אין להשתמש בו כקלט לפעולה אחרת. במקום זאת, צריך להשתמש ב-name.

updateTime

string (Timestamp format)

זמן השינוי האחרון של הנכס.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

properties

object (Struct format)

מאפייני מפתח/ערך שמשויכים לנכס.

startTime

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

בנכסים שתואמים למרווח זמן מסוים, כמו ערכים ממוצעים לאורך חודש או שנה, חותמת הזמן הזו תואמת לסוף מרווח הזמן הזה (לא כולל).

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

geometry

object (Struct format)

טביעת הרגל המרחבית המשויכת לנכס, אם יש כזו, כאובייקט גיאומטריה של GeoJSON (ראו RFC 7946).

bands[]

object (ImageBand)

מידע על פס הנתונים של נכס התמונה. לא מוצג בנכסים שאינם תמונות.

sizeBytes

string (int64 format)

הגודל בבייטים של נכס עלה (למשל תמונה).

featureCount

string (int64 format)

מספר התכונות בנכס, אם רלוונטי.

quota

object (FolderQuota)

פרטי המכסה המשויכים לנכס התיקייה, אם יש כאלה. המערכת מחזירה את הערך הזה עבור נכסי תיקיות ברמה העליונה שבבעלות משתמשים (למשל, 'users/*' או 'projects/*').

tilesets[]

object (Tileset)

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

שדה האיחוד location. מידע על המיקום והאופן שבו מאוחסנים המשבצות של הרשת. הערך של location יכול להיות רק אחת מהאפשרויות הבאות:
cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב-image.importExternal. פרטים נוספים זמינים בכתובת https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff.

featureViewAssetLocation

object (FeatureViewLocation)

המיקום של תצוגת המאפיינים הזו ב-EE.

CloudStorageLocation

המיקום של נכס ב-Cloud Storage.

ייצוג ב-JSON
{
  "uris": [
    string
  ]
}
שדות
uris[]

string

מזהי ה-URI של הנתונים. יש תמיכה רק במזהי URI של Google Cloud Storage. כל מזהה URI צריך להיות מוגדר בפורמט הבא: "gs://bucket-id/object-id". בשלב זה יש תמיכה רק ב-URI אחד. אם צוין יותר מ-URI אחד, תוחזר שגיאה מסוג INALID_ARGUMENT.

FeatureViewLocation

נכס FeatureView EE.

ייצוג ב-JSON
{
  "assetOptions": {
    object (FeatureViewOptions)
  }
}
שדות
assetOptions

object (FeatureViewOptions)

אפשרויות בזמן הטמעת הנתונים לנכסי FeatureView.

FeatureViewOptions

אפשרויות בזמן הטמעת הנתונים לנכסי FeatureView.

ייצוג ב-JSON
{
  "featureViewAttributes": [
    {
      object (FeatureViewAttribute)
    }
  ],
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  }
}
שדות
featureViewAttributes[]

object (FeatureViewAttribute)

מאפיינים בנכס FeatureView, שמרכיבים סכימה לנכס. אלה המאפיינים שיכולים להיות לתכונות בנכס הזה. לכל מאפיין יש שם וסוג.

ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

פרמטרים של זמן הטמעת הנתונים ב-FeatureView.

FeatureViewAttribute

מאפיין של FeatureView והסוג שלו.

ייצוג ב-JSON
{
  "name": string,
  "type": enum (Type)
}
שדות
name

string

שם המאפיין.

type

enum (Type)

סוג המאפיין.

סוג

הסוגים האלה הם רפליקות של הסוגים שמופיעים בקובץ geo/enterprise/layers/public/data_source_schema.proto.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED הסוג לא צוין.
INTEGER ערך של מספר שלם ב-64 סיביות.
BOOLEAN ערך בוליאני True/False.
DOUBLE מספר נקודה צפה (floating-point) עם דיוק כפול.
STRING מחרוזת באורך בלתי מוגבל.
DATE_TIME תאריך/שעה, שמיוצגים כמספר שלם בן 64 סיביות עם סימן במיקרו-שניות מאז תחילת הזמן, ולכן תומכים בתקופה שבין 290,308 לפנה"ס ל-294,247 לספירה.

FeatureViewIngestionTimeParameters

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

ייצוג ב-JSON
{
  "thinningOptions": {
    object (ThinningOptions)
  },
  "rankingOptions": {
    object (RankingOptions)
  }
}
שדות
thinningOptions

object (ThinningOptions)

המספר המקסימלי של תיבות מלבניות של תכונות שיכולות לחצות משבצת. המספר הזה חייב להיות לא שלילי.

rankingOptions

object (RankingOptions)

אפשרויות להקצאת דירוגים לפי סדר z ודירוגים של דילול לתכונות.

ThinningOptions

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

ייצוג ב-JSON
{
  "maxFeaturesPerTile": integer,
  "thinningStrategy": enum (ThinningStrategy)
}
שדות
maxFeaturesPerTile

integer

המספר המקסימלי של תיבות מלבניות של תכונות שיכולות לחצות משבצת. המספר הזה חייב להיות לא שלילי.

thinningStrategy

enum (ThinningStrategy)

אסטרטגיית הסינון של התכונות שצריך להשתמש בה.

ThinningStrategy

אסטרטגיית דילול של תכונות.

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

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

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

RankingOptions

אפשרויות דירוג לסדר z ולדילול.

ייצוג ב-JSON
{
  "zOrderRankingRule": {
    object (RankingRule)
  },
  "thinningRankingRule": {
    object (RankingRule)
  }
}
שדות
zOrderRankingRule

object (RankingRule)

כלל דירוג להקצאת דירוגים לפי סדר z למאפיינים.

thinningRankingRule

object (RankingRule)

כלל הדירוג להקצאת דירוגים של דילול לתכונות.

RankingRule

כללי דירוג שקובעים איך תכונות מדורגות לצורך דילול וסדר z.

ייצוג ב-JSON
{
  "rankByOneThingRule": [
    {
      object (RankByOneThingRule)
    }
  ]
}
שדות
rankByOneThingRule[]

object (RankByOneThingRule)

רשימה מסודרת של אפס או יותר כללים של דירוג לפי תכונה אחת (למשל, מאפיין), שמשמשים כמפתחות דירוג ראשיים, משניים וכו' להגדרת thinning_rank בכל RankedFeature.

RankByOneThingRule

כלל דירוג ספציפי לצורך בקרה על הדירוג של דילול ו-z-order.

ייצוג ב-JSON
{

  // Union field rule can be only one of the following:
  "rankByAttributeRule": {
    object (RankByAttributeRule)
  },
  "rankByMinVisibleLodRule": {
    object (RankByMinVisibleLodRule)
  },
  "rankByGeometryTypeRule": {
    object (RankByGeometryTypeRule)
  },
  "rankByMinZoomLevelRule": {
    object (RankByMinZoomLevelRule)
  }
  // End of list of possible types for union field rule.
  "direction": enum (Direction)
}
שדות
שדה האיחוד rule. סוג כלל הדירוג שבו רוצים להשתמש. הערך של rule יכול להיות רק אחת מהאפשרויות הבאות:
rankByAttributeRule

object (RankByAttributeRule)

דירוג לפי ערך מאפיין התכונה.

rankByMinVisibleLodRule
(deprecated)

object (RankByMinVisibleLodRule)

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

rankByGeometryTypeRule

object (RankByGeometryTypeRule)

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

rankByMinZoomLevelRule

object (RankByMinZoomLevelRule)

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

direction

enum (Direction)

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

RankByAttributeRule

דירוג לפי ערך מאפיין התכונה.

ייצוג ב-JSON
{
  "attributeName": string
}
שדות
attributeName

string

דירוג לפי הערך של המאפיין עם השם הנתון. ברוב המקרים, זהו הסדר הטבעי של הערכים של הסוג הנתון, עם כמה דקויות והבהרות: - במאפייני integer, ערכים נמוכים מופיעים לפני ערכים גבוהים - במאפייני double, ערכים נמוכים מופיעים לפני ערכים גבוהים, כאשר NaN נחשב לערכו הנמוך ביותר מבין כל הערכים האחרים, כולל מינוס אינסוף - במאפייני boolean, הערך false נחשב לקודם לערך true - במאפייני date_time, ערכים מוקדמים מופיעים לפני ערכים מאוחרים - מאפייני מחרוזת מדורגים לפי סדר אלפביתי - למאפיין שהערך שלו לא הוגדר, נחשב הערך שמוגדר כברירת מחדל של הסוג הנתון (0 למספר שלם, false למאפיין בוליאני וכו').

RankByMinVisibleLodRule

אין שדות לסוג הזה.

דירוג לפי רמת הפירוט המינימלית (lod) שבה הגיאומטריה של התכונה נראית בפעם הראשונה. תכונה עם נקודות כלשהן תמיד גלויה בכל רמות הפירוט.

RankByGeometryTypeRule

אין שדות לסוג הזה.

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

RankByMinZoomLevelRule

אין שדות לסוג הזה.

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

כיוון

סדר הרשימה: מהנמוך לגבוה (ASCENDING) או מהגבוה לנמוך (DESCENDING).

טיפוסים בני מנייה (enum)
DIRECTION_UNSPECIFIED לא צוין כיוון דירוג.
ASCENDING סדר עולה.
DESCENDING בסדר יורד.

סוג

סוגי הנכסים.

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED לא צוין.
IMAGE תמונה.
IMAGE_COLLECTION אוסף תמונות.
TABLE טבלה.
FOLDER תיקייה.
CLASSIFIER מסווג.
FEATURE_VIEW נכס FeatureView.

ImageBand

מידע על פס נתונים יחיד של נכס תמונה.

ייצוג ב-JSON
{
  "id": string,
  "dataType": {
    object (PixelDataType)
  },
  "grid": {
    object (PixelGrid)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "missingData": {
    object (MissingData)
  }
}
שדות
id

string

המזהה של הלהקה.

dataType

object (PixelDataType)

הסוג המספרי של התדר.

grid

object (PixelGrid)

רשת הפיקסלים של הרצועה.

pyramidingPolicy

enum (PyramidingPolicy)

מדיניות הפירמידה של הלהקה.

missingData

object (MissingData)

הערכים שמציינים נתונים חסרים.

PixelDataType

מציין את הסוג המספרי של הפיקסלים בפס תמונה.

ייצוג ב-JSON
{
  "precision": enum (Precision),
  "range": {
    object (DoubleRange)
  },
  "dimensionsCount": integer
}
שדות
precision

enum (Precision)

רמת הדיוק המספרי של הטיפוס.

range

object (DoubleRange)

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

dimensionsCount

integer

מספר המאפיינים בסוג נתונים בעל ערך מערך, או אפס כדי לציין סוג סקלר רגיל.

דיוק

מציין את הדיוק של סוג נתונים מספרי.

טיפוסים בני מנייה (enum)
PRECISION_UNSPECIFIED לא צוין.
INT לסוג הנתונים יש דיוק של מספר שלם. חשוב לזכור שאפשר להשתמש ב-int כדי לייצג מספרים שלמים בגדלים שונים.
FLOAT רמת הדיוק של סוג הנתונים היא 32 ביט של נקודה צפה.
DOUBLE סוג הנתונים הוא 64 ביט עם נקודה צפה (double).

MissingData

רשימה של ערכים שלא מייצגים נתונים.

ייצוג ב-JSON
{
  "values": [
    number
  ]
}
שדות
values[]

number

ערכים שלא מייצגים נתונים.

FolderQuota

תיאור של השימוש הנוכחי והמגבלות של תיקייה ברמה העליונה.

ייצוג ב-JSON
{
  "sizeBytes": string,
  "maxSizeBytes": string,
  "assetCount": string,
  "maxAssets": string
}
שדות
sizeBytes

string (int64 format)

גודל התיקייה בבייטים.

maxSizeBytes

string (int64 format)

הגודל המקסימלי של התיקייה, בבייטים.

assetCount

string (int64 format)

מספר הנכסים שמאוחסנים בתיקייה.

maxAssets

string (int64 format)

המספר המקסימלי של נכסים שאפשר לאחסן בתיקייה.

קבוצת אריחים

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

ייצוג ב-JSON
{
  "id": string,
  "sources": [
    {
      object (ImageSource)
    }
  ],
  "dataType": enum (DataType),
  "crs": string
}
שדות
id

string

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

sources[]

object (ImageSource)

המקורות שמרכיבים את ערכת האריחים הזו.

dataType

enum (DataType)

סוג נתונים אופציונלי של הלהקה. אם מצוין, לא מתבצעת בדיקה כדי לוודא שסוג כל קובץ קלט תואם. הערך של dataType חייב להתאים לסוג של כל קובץ קלט, למעט במקרים שבהם סוג הקלט לא ברור (למשל, Byte יכול להיות INT8 או UINT8).

crs

string

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

ImageSource

קובץ תמונה והקובצים הנלווים שלו.

ייצוג ב-JSON
{
  "uris": [
    string
  ],
  "affineTransform": {
    object (AffineTransform)
  },
  "dimensions": {
    object (GridDimensions)
  }
}
שדות
uris[]

string

מזהי ה-URI של הנתונים לייבוא. בשלב הזה יש תמיכה רק במזהי URI של Google Cloud Storage. כל מזהה URI צריך להיות מוגדר בפורמט הבא: "gs://bucket-id/object-id". האובייקט הראשי צריך להיות הרכיב הראשון ברשימה, והקובצי הצדדים צריכים להופיע אחריו. אם ההגדרה מוגדרת, כל מזהה URI מתחיל ב-ImageManifest.uri_prefix.

affineTransform

object (AffineTransform)

טרנספורמציה אופציונלית של affine. צריך לציין את השדה הזה רק אם הנתונים מ-uris (כולל קובצי sidecar) לא מספיקים כדי למקם את הפיקסלים.

dimensions

object (GridDimensions)

מידות הרשת בפיקסלים. נעשה בו שימוש רק כשהערך של skipMetadataRead מוגדר.

DataType

מציין את סוג הנתונים המספרי.

טיפוסים בני מנייה (enum)
DATA_TYPE_UNSPECIFIED לא צוין.
INT8 מספר שלם ב-8 סיביות עם סימן.
UINT8 מספר שלם ללא סימן באורך 8 ביט.
INT16 מספר שלם ב-16 סיביות עם סימן.
UINT16 מספר שלם ללא סימן באורך 16 ביט.
INT32 מספר שלם בסימן של 32 ביט.
UINT32 מספר שלם ללא סימן באורך 32 ביט.
FLOAT מספר ממשי (float) ב-32 ביט.
DOUBLE מספר ממשי (float) ב-64 ביט.

Methods

copy

העתקת נכס.

create

יצירת נכס.

delete

מחיקה של נכס.

get

הצגת מידע מפורט על נכס.

getIamPolicy

הצגת מדיניות בקרת הגישה של משאב.

getPixels

אחזור פיקסלים מנכס תמונה.

listAssets

הצגת רשימה של נכסי מאגר, כמו תיקייה או אוסף.

listFeatures

רשימה של התכונות בנכס טבלה.

move

העברת נכס.

patch

עדכון נכס.

setIamPolicy

הגדרת מדיניות בקרת הגישה במשאב שצוין.

testIamPermissions

הפונקציה מחזירה את ההרשאות שיש למבצע הקריאה החוזרת (caller) למשאב שצוין.