Method: projects.image.export

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

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

POST https://earthengine.googleapis.com/v1/{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)

कंप्यूट और एक्सपोर्ट किए जाने वाले पिक्सल की ज़्यादा से ज़्यादा संख्या. यह एक सुरक्षा सुविधा है. इससे आपको गलती से, अपनी ज़रूरत से ज़्यादा डेटा एक्सपोर्ट करने से रोका जा सकता है. डिफ़ॉल्ट वैल्यू 1e8 पिक्सल होती है. हालांकि, इस सीमा को बढ़ाने या घटाने के लिए, वैल्यू को साफ़ तौर पर सेट किया जा सकता है.
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 में एक्सपोर्ट करने की सुविधा कॉन्फ़िगर की जाती है.
एक-दूसरे से अलग फ़ील्ड के आखिर में.