Method: projects.map.export

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

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

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

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

पाथ पैरामीटर

पैरामीटर
project

string

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

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

  • earthengine.exports.create

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

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

JSON के काेड में दिखाना
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
फ़ील्ड
expression

object (Expression)

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

description

string

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

tileOptions

object (TileOptions)

मैप टाइल जनरेट करने के बारे में बताने वाले विकल्प.

tileExportOptions

object (ImageFileExportOptions)

मैप टाइल को कहां और किस फ़ॉर्मैट में एक्सपोर्ट करना है, इसके विकल्प. फ़िलहाल, मैप एक्सपोर्ट करने के लिए सिर्फ़ Cloud Storage का इस्तेमाल किया जा सकता है.

requestId

string

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

workloadTag

string

उपयोगकर्ता ने इस कैलकुलेशन को ट्रैक करने के लिए लेबल दिया है.

priority

integer

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में 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 देखें.

TileOptions

इमेज या वीडियो मैप टाइल एक्सपोर्ट करने के बारे में बताने वाले विकल्प.

JSON के काेड में दिखाना
{
  "startZoom": integer,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
फ़ील्ड
startZoom

integer

एक्सपोर्ट के लिए मैप टाइल जनरेट करने का ज़ूम लेवल. डिफ़ॉल्ट तौर पर, यह वैल्यू शून्य पर सेट होती है.

minZoom
(deprecated)

integer

एक्सपोर्ट के लिए मैप टाइल जनरेट करने का ज़ूम लेवल. डिफ़ॉल्ट तौर पर, यह वैल्यू शून्य पर सेट होती है.

skipEmpty

boolean

अगर यह विकल्प चुना जाता है, तो खाली (यानी कि पूरी तरह से पारदर्शी) मैप टाइल नहीं लिखी जाती हैं.

skipEmptyTiles
(deprecated)

boolean

अगर यह विकल्प चुना जाता है, तो खाली (यानी कि पूरी तरह से पारदर्शी) मैप टाइल नहीं लिखी जाती हैं.

mapsApiKey

string

जनरेट किए गए मैप टाइल व्यूअर के लिए, Google Maps Platform का एपीआई पासकोड (यह ज़रूरी नहीं है).

dimensions

object (GridDimensions)

आउटपुट वीडियो टाइल की चौड़ाई और ऊंचाई. इनका इस्तेमाल सिर्फ़ टाइल किए गए वीडियो पिरामिड (ExportVideoMap) को एक्सपोर्ट करने के लिए किया जाता है.

tileDimensions
(deprecated)

object (GridDimensions)

आउटपुट वीडियो टाइल की चौड़ाई और ऊंचाई. इनका इस्तेमाल सिर्फ़ टाइल किए गए वीडियो पिरामिड (ExportVideoMap) को एक्सपोर्ट करने के लिए किया जाता है.

stride

integer

टाइल की लाइन और कॉलम स्ट्राइड. (ExportVideoMap) स्पार्स टाइल के लिए 4 (सिर्फ़ WebGL) या ज़्यादा से ज़्यादा कंपैटिबिलिटी के लिए 1 (डिफ़ॉल्ट) पर सेट करें.

zoomSubset

object (ZoomSubset)

ज़ूम लेवल का सबसेट, जिसके लिए टाइलें जनरेट करनी हैं. इसे सिर्फ़ ExportVideoMap को कॉल करने के लिए तय किया जा सकता है.

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

integer

ज़ूम करने का लेवल, जिसके लिए मैप टाइल जनरेट करना बंद करना है.

maxZoom
(deprecated)

integer

ज़ूम करने का लेवल, जिसके लिए मैप टाइल जनरेट करना बंद करना है.

scale

number

मीटर प्रति पिक्सल में इमेज का ज़्यादा से ज़्यादा रिज़ॉल्यूशन. स्केल को भूमध्य रेखा पर सबसे सही ज़्यादा से ज़्यादा ज़ूम लेवल में बदल दिया जाएगा.

एक-दूसरे से अलग फ़ील्ड के आखिर में.

ZoomSubset

ज़ूम करने के लेवल का सबसेट, जिसके लिए टाइलें जनरेट करनी हैं (ExportVideoMap). स्टार्ट और एंड सबसेट, डबल प्रिसिशन वैल्यू हैं. इनकी मदद से, ज़ूम करने का लेवल या लेवल को धीरे-धीरे रेंडर किया जा सकता है. अगर आपको पूरे पिरामिड को रेंडर करना है और ज़ूम लेवल 12 से शुरू करना है, तो इस मैसेज को सेट न करें. इसके बजाय, startZoom=0 और endZoom=12 सेट करें. लेवल 0 से 11 और लेवल 12 का पहला 10% रेंडर करने के लिए: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } लेवल 12 का अगला 10% रेंडर करने के लिए: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } लेवल 12 का बाकी 80% रेंडर करने के लिए: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } यह भी ध्यान दें कि सभी एक्सपोर्ट शार्ड में start/endZoom में पिरामिड का साइज़ एक जैसा (पूरा) होना चाहिए.

JSON के काेड में दिखाना
{
  "start": number,
  "end": number,
  "min": number,
  "max": number
}
फ़ील्ड
start

number

ज़ूम करने के लेवल का वह सबसेट जिसके लिए टाइलें जनरेट करनी हैं (ExportVideoMap) यहां सबसेट, डबल प्रिसिशन वैल्यू है. इससे ज़ूम करने के लेवल को धीरे-धीरे रेंडर किया जा सकता है. उदाहरण के लिए, 12.1, ज़ूम 12 में टाइलों का पहला 10% है. हालांकि, यह किसी खास क्रम में नहीं होता है.

end

number

ज़ूम करने के लेवल का वह सबसेट जिसके लिए टाइलें जनरेट करनी हैं (ExportVideoMap). इससे आपको ज़ूम करने के लेवल को धीरे-धीरे रेंडर करने की सुविधा मिलती है. हालांकि, यह सुविधा, तय किए गए क्रम में ज़्यादा से ज़्यादा सबसेट (अगर दिया गया है) तक ही काम करती है.

min
(deprecated)

number

ज़ूम करने के लेवल का वह सबसेट जिसके लिए टाइलें जनरेट करनी हैं (ExportVideoMap) यहां सबसेट, डबल प्रिसिशन वैल्यू है. इससे ज़ूम करने के लेवल को धीरे-धीरे रेंडर किया जा सकता है. उदाहरण के लिए, 12.1, ज़ूम 12 में टाइलों का पहला 10% है. हालांकि, यह किसी क्रम में नहीं है.

max
(deprecated)

number

ज़ूम करने के लेवल का वह सबसेट जिसके लिए टाइलें जनरेट करनी हैं (ExportVideoMap). इससे आपको ज़ूम करने के लेवल को धीरे-धीरे रेंडर करने की सुविधा मिलती है. हालांकि, यह सुविधा, तय किए गए क्रम में ज़्यादा से ज़्यादा सबसेट (अगर दिया गया है) तक ही काम करती है.