Method: projects.assets.listImages

इमेज कलेक्शन ऐसेट में इमेज की सूची बनाता है. इस तरीके से, कॉल करने वाले व्यक्ति को इमेज कलेक्शन पर स्पेसटाइम और मेटाडेटा फ़िल्टर लागू करने की सुविधा मिलती है.

एचटीटीपी अनुरोध

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

यूआरएल में 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").

अनुमति पाने के लिए, दिए गए संसाधन parent पर IAM की यह अनुमति ज़रूरी है:

  • earthengine.assets.get

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

हर पेज पर नतीजों की ज़्यादा से ज़्यादा संख्या. ऐसा हो सकता है कि सर्वर, अनुरोध की गई संख्या से कम ऐसेट दिखाए. अगर पेज साइज़ की वैल्यू सबमिट नहीं की जाती है, तो पेज का डिफ़ॉल्ट साइज़ EarthEngineAssetView पर निर्भर करता है. साथ ही, ज़्यादा पाबंदी वाले व्यू के लिए, ज़्यादा सीमाएं होती हैं.

pageToken

string

नतीजों के उस पेज की पहचान करने वाला टोकन जिसे सर्वर को दिखाना चाहिए. आम तौर पर, यह assets.listImages वाले तरीके के पिछले कॉल से मिली ListImagesResponse.next_page_token की वैल्यू होती है.

startTime

string (Timestamp format)

अगर यह मौजूद है, तो नतीजों को उन पर फ़िल्टर करता है जिनका टाइमस्टैंप कम से कम इस वैल्यू के बराबर या उससे ज़्यादा है.

आरएफ़सी 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)

अगर यह मौजूद है, तो नतीजों को उन पर फ़िल्टर करता है जिनका टाइमस्टैंप इस वैल्यू से कम है (सिर्फ़).

आरएफ़सी 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".

region

string

अगर मौजूद है, तो क्वेरी के इलाके की जानकारी देने वाली ज्यामिति. इसे GeoJSON ज्यामिति स्ट्रिंग के तौर पर दिखाया जाता है (आरएफ़सी 7946 देखें). स्पेस इंटरसेक्शन की सटीक जानकारी एक मीटर तक मिलती है.

filter

string

अगर मौजूद है, तो यह प्रॉपर्टी के लिए अन्य आसान फ़िल्टर तय करता है.

view

enum (EarthEngineAssetView)

इससे पता चलता है कि जवाब में Image रिसॉर्स के कौनसे हिस्से दिखाए जाने चाहिए. अगर इस विकल्प को सेट नहीं किया जाता है, तो डिफ़ॉल्ट रूप से सभी प्रॉपर्टी दिखती हैं.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

EarthEngineService.ListImages के लिए रिस्पॉन्स मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
images[]

object (Image)

क्वेरी से मेल खाने वाली इमेज की सूची.

nextPageToken

string

नतीजों का अगला पेज पाने के लिए टोकन. नतीजों का अगला पेज पाने के लिए, assets.listImages तरीके के अगले कॉल में ListImagesRequest.page_token फ़ील्ड में यह वैल्यू पास करें.

अनुमति के दायरे

इसके लिए, 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

इमेज का आईडी, अगर मौजूद हो. "projects/*/assets/" प्रीफ़िक्स के बिना name के बराबर है (उदाहरण के लिए, "users//"). आम तौर पर, यह सेव की गई इमेज के लिए मौजूद होना चाहिए. हालांकि, कैलकुलेट की गई इमेज के लिए यह खाली स्ट्रिंग होगी.

updateTime

string (Timestamp format)

इमेज में पिछली बार बदलाव करने का समय.

आरएफ़सी 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".

title

string

ऐसेट का टाइटल.

description

string

एसेट की जानकारी.

properties

object (Struct format)

इमेज से जुड़ी की/वैल्यू प्रॉपर्टी.

startTime

string (Timestamp format)

अगर इमेज से जुड़ा कोई टाइमस्टैंप है, तो वह. उदाहरण के लिए, उपग्रह से ली गई इमेज को लेने का समय. किसी समयावधि से जुड़ी एसेट के लिए, यह टाइमस्टैंप उस समयावधि की शुरुआत से जुड़ा होता है. जैसे, किसी महीने या साल की औसत वैल्यू.

आरएफ़सी 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)

किसी समयावधि से जुड़ी ऐसेट के लिए, यह टाइमस्टैंप उस समयावधि के खत्म होने का होता है. जैसे, एक महीने या साल की औसत वैल्यू.

आरएफ़सी 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)

किसी लीफ़ ऐसेट (जैसे, इमेज) का साइज़, बाइट में. आम तौर पर, सेव की गई इमेज के लिए यह वैल्यू शून्य से ज़्यादा होनी चाहिए और कैलकुलेट की गई इमेज के लिए शून्य होनी चाहिए.