Method: projects.image.export

यह एक बैच प्रोसेस शुरू करता है. इसमें किसी इमेज को प्रोसेस किया जाता है और नतीजे को कई जगहों में से किसी एक जगह पर लिखा जाता है.

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

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:export

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
project

string

Google Cloud Platform के उस प्रोजेक्ट का प्रोजेक्ट आईडी या प्रोजेक्ट नंबर जिसे इस अनुरोध के लिए, सेवा के ग्राहक के तौर पर माना जाना चाहिए. इसका फ़ॉर्मैट projects/{project-id} है.

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

  • earthengine.exports.create

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
expression

object (Expression)

यह एक्सप्रेशन, प्रोसेस और एक्सपोर्ट की जाने वाली इमेज को दिखाता है.

description

string

टास्क का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

maxPixels

string (Int64Value format)

प्रोसेस और एक्सपोर्ट किए जाने वाले पिक्सल की ज़्यादा से ज़्यादा संख्या. यह एक सुरक्षा उपाय है, ताकि आप गलती से भी अपनी ज़रूरत से ज़्यादा बड़ी इमेज एक्सपोर्ट न कर पाएं. डिफ़ॉल्ट वैल्यू 10 करोड़ पिक्सल होती है. हालांकि, इस सीमा को बढ़ाने या घटाने के लिए, वैल्यू साफ़ तौर पर सेट की जा सकती है.

grid

object (PixelGrid)

ये पैरामीटर बताते हैं कि expression से प्रोसेस की गई इमेज को कैसे रीप्रोजेक्ट और क्लिप किया जाना चाहिए. अगर ये पैरामीटर मौजूद नहीं हैं, तो प्रोसेस की गई पूरी इमेज को उसके ओरिजनल प्रोजेक्शन में दिखाया जाता है.

requestId

string

डुप्लीकेट अनुरोधों का पता लगाने के लिए इस्तेमाल की जाने वाली एक यूनीक स्ट्रिंग. अगर एक ही उपयोगकर्ता, एक से ज़्यादा अनुरोध करता है और उन सभी में एक ही नॉन-एम्टी requestId होता है, तो इनमें से सिर्फ़ एक अनुरोध, ज़्यादा समय तक चलने वाली कार्रवाई शुरू कर सकता है. requestId में a..z, A..Z, 0-9 या '-' वर्ण शामिल हो सकते हैं. requestId ज़्यादा से ज़्यादा 60 वर्णों का हो सकता है.

workloadTag

string

इस प्रोसेस को ट्रैक करने के लिए, उपयोगकर्ता की ओर से दिया गया लेबल.

priority

integer

ज़रूरी नहीं. प्रोजेक्ट में, एक्सपोर्ट टास्क की प्राथमिकता. ज़्यादा प्राथमिकता वाले टास्क को पहले शेड्यूल किया जाता है. यह 0 से 9999 के बीच का कोई पूर्णांक होना चाहिए. अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट वैल्यू 100 होती है.

ये विकल्प बताते हैं कि नतीजों को कहां और कैसे सेव किया जाना चाहिए. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे के साथ इस्तेमाल नहीं किए जा सकते. जवाब में, इनमें से ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
fileExportOptions

object (ImageFileExportOptions)

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

assetExportOptions

object (ImageAssetExportOptions)

अगर इसे तय किया जाता है, तो एक्सपोर्ट को Earth Engine ऐसेट के तौर पर कॉन्फ़िगर किया जाता है.

एक-दूसरे के साथ इस्तेमाल नहीं किए जा सकने वाले फ़ील्ड खत्म.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

इसके लिए, OAuth की इनमें से कोई एक अनुमति ज़रूरी है:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

ज़्यादा जानकारी के लिए, देखें OAuth 2.0 Overview.

ImageAssetExportOptions

इमेज को Earth Engine ऐसेट के तौर पर सेव करने के विकल्प.

JSON के काेड में दिखाना
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
pyramidingPolicy

enum (PyramidingPolicy)

सभी बैंड पर डिफ़ॉल्ट रूप से लागू की जाने वाली पिरामिडिंग नीति.

pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

हर बैंड के लिए, पिरामिड नीति के खास ओवरराइड.

इसमें "key": value पेयर की सूची शामिल होती है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

नतीजों को कहां लिखा जाना चाहिए. यहां ऐसे फ़ील्ड की सूची दी गई है जो एक-दूसरे के साथ इस्तेमाल नहीं किए जा सकते. जवाब में, इनमें से ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
earthEngineDestination

object (EarthEngineDestination)

अगर इसे तय किया जाता है, तो Earth Engine पर एक्सपोर्ट करने के लिए कॉन्फ़िगर किया जाता है.

एक-दूसरे के साथ इस्तेमाल नहीं किए जा सकने वाले फ़ील्ड खत्म.