Method: projects.assets.listImages

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

בקשת HTTP

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages

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

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

פרמטרים
parent

string

חובה. השם של נכס אוסף התמונות שרוצים להוסיף לרשימת הנכסים. parent צריך להיות בפורמט 'projects/*/assets/**' (למשל, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). כל הנכסים שבבעלות המשתמשים נמצאים בפרויקט earthengine-legacy (למשל, "projects/earthengine-legacy/assets/users/foo/bar"). כל שאר הנכסים נמצאים בפרויקט earthengine-public (למשל, "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

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

פרמטרים
pageSize

integer

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

string

אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל, זהו הערך של ListImagesResponse.next_page_token שהוחזר מהקריאה הקודמת לשיטה assets.listImages.
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".
region

string

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

string

אם הערך הזה קיים, הוא מציין מסננים פשוטים נוספים של נכסים.
view

enum (EarthEngineAssetView)

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

הודעת התגובה של EarthEngineService.ListImages.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
שדות
images[]

object (Image)

רשימת התמונות שתואמות לשאילתה.
nextPageToken

string

אסימון לאחזור של דף התוצאות הבא. כדי לאחזר את דף התוצאות הבא, מעבירים את הערך הזה בשדה ListImagesRequest.page_token בקריאה הבאה לשיטה assets.listImages.

היקפי הרשאה

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

תמונה

מידע על תמונה ב-Earth Engine.

ייצוג ב-JSON 
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
שדות
name

string

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

string

המזהה של התמונה, אם הוא קיים. זהה ל-name בלי הקידומת 'projects/*/assets/‎' (למשל, 'users//'). בדרך כלל, השדה הזה צריך להופיע בתמונות שמאוחסנות, אבל הוא יהיה מחרוזת ריקה בתמונות מחושבות.
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".
title

string

שם הנכס.
description

string

התיאור של הנכס.
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)

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