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)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cloudStorageLocation": {
    object (CloudStorageLocation)
  },
  "featureViewAssetLocation": {
    object (FeatureViewLocation)
  }
  // End of mutually exclusive fields.
}
שדות
type

enum (Type)

סוג הנכס.

name

string

שם הנכס. ‫name הוא בפורמט 'projects/*/assets/**' (לדוגמה, 'projects/earthengine-legacy/assets/users//').

id

string

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

updateTime

string (Timestamp format)

הזמן שבו בוצע השינוי האחרון בנכס.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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.

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

object (CloudStorageLocation)

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

featureViewAssetLocation

object (FeatureViewLocation)

המיקום של FeatureView הזה ב-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 מספר בשיטת נקודה צפה עם דיוק כפול.
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-order ולדילול.

ייצוג 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.

ייצוג JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "rankByAttributeRule": {
    object (RankByAttributeRule)
  },
  "rankByMinVisibleLodRule": {
    object (RankByMinVisibleLodRule)
  },
  "rankByGeometryTypeRule": {
    object (RankByGeometryTypeRule)
  },
  "rankByMinZoomLevelRule": {
    object (RankByMinZoomLevelRule)
  }
  // End of mutually exclusive fields.
  "direction": enum (Direction)
}
שדות
סוג כלל הדירוג שבו רוצים להשתמש. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
rankByAttributeRule

object (RankByAttributeRule)

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

rankByMinVisibleLodRule
(deprecated)

object (RankByMinVisibleLodRule)

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

rankByGeometryTypeRule

object (RankByGeometryTypeRule)

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

rankByMinZoomLevelRule

object (RankByMinZoomLevelRule)

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

סוף השדות הבלעדיים.
direction

enum (Direction)

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

RankByAttributeRule

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

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

string

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

RankByMinVisibleLodRule

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

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

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)

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

dimensionsCount

integer

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

דיוק

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

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

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)

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

Tileset

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

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

string

המזהה של ערכת המשבצות. הערך חייב להיות ייחודי בין כל ערכות המשבצות שצוינו ב-ImageManifest. המזהה הזה נמחק במהלך שלב העיבוד, והוא משמש רק לקישור של Tileset לרצועה. מחרוזת ריקה היא מזהה תקין.

sources[]

object (ImageSource)

המקורות שמהם מורכב אוסף המשבצות הזה.

dataType

enum (DataType)

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

crs

string

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

ImageSource

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

ייצוג 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)

טרנספורמציה אפינית אופציונלית. צריך לציין את הערך הזה רק אם הנתונים מ-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

מחזירה את ההרשאות שיש למבצע הקריאה במשאב שצוין.