Method: projects.image.import

इमेज इंपोर्ट करता है.

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

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:import

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

पाथ पैरामीटर

पैरामीटर
project

string

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

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

  • earthengine.imports.create

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

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
फ़ील्ड
imageManifest

object (ImageManifest)

इमेज मेनिफ़ेस्ट.
description

string

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

boolean

किसी मौजूदा ऐसेट को ओवरराइट करने की अनुमति है या नहीं.
requestId

string

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

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

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

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

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

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

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

ImageManifest

इसमें बताया गया है कि EarthEngine सेवा, फ़ाइलों के सेट से इमेज कैसे कम्पोज़ करेगी.

JSON के काेड में दिखाना 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
फ़ील्ड
name

string

उस एसेट का नाम जिसे बनाना है. name का फ़ॉर्मैट "projects/*/assets/**" है. उदाहरण के लिए, "projects/earthengine-legacy/assets/users//". उपयोगकर्ता के मालिकाना हक वाली सभी एसेट, "earthengine-legacy" प्रोजेक्ट में होती हैं. जैसे, "projects/earthengine-legacy/assets/users/foo/bar". अन्य सभी एसेट, "earthengine-public" प्रोजेक्ट में शामिल हैं. उदाहरण के लिए, "projects/earthengine-public/assets/LANDSAT".
properties

object (Struct format)

ऐसेट की अन्य प्रॉपर्टी. "system:time_start" और "system:time_end" प्रॉपर्टी के नाम अब काम नहीं करते. इसके बजाय, startTime और endTime फ़ील्ड का इस्तेमाल करें.
uriPrefix

string

इस मेनिफ़ेस्ट में बताए गए सभी uri के आगे जोड़ा जाने वाला वैकल्पिक प्रीफ़िक्स.
tilesets[]

object (Tileset)

टाइलसेट. हर टाइलसेट का एक यूनीक आईडी होना चाहिए.
bands[]

object (TilesetBand)

बैंड. ऐसेट का बैंड क्रम, bands का क्रम होता है.
maskBands[]

object (TilesetMaskBand)

मास्क के बैंड.
footprint

object (PixelFootprint)

पिक्सल निर्देशांक में फ़ुटप्रिंट (अक्षांश/देशांतर निर्देशांक में नहीं). अगर यह फ़ील्ड खाली है, तो फ़ुटप्रिंट डिफ़ॉल्ट रूप से पूरी इमेज होगी. पिक्सल के निर्देशांक के बारे में ज़्यादा जानकारी के लिए, PixelGrid देखें.
missingData

object (MissingData)

ऐसी वैल्यू जो इमेज के सभी बैंड में कोई डेटा नहीं दिखाती हैं. यह उन सभी बैंड पर लागू होता है जो अपने missingData की जानकारी नहीं देते.
pyramidingPolicy

enum (PyramidingPolicy)

पिरामिड स्कीम से जुड़ी नीति. अगर इसकी वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से MEAN नीति लागू होती है. यह उन सभी बैंड पर लागू होता है जो अपने pyramidingPolicy की जानकारी नहीं देते.
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".
skipMetadataRead

boolean

GDAL का इस्तेमाल करके, फ़ाइलों से मेटाडेटा पढ़ने की प्रोसेस को छोड़ना है या नहीं. जब यह फ़ील्ड 'सही' पर सेट होता है, तो टाइलसेट में पूरा GDAL मेटाडेटा होना चाहिए: डेटा टाइप, सीआरएस, ट्रांसफ़ॉर्म, फ़ाइल डाइमेंशन, और कोई डेटा वैल्यू नहीं.
memo

string

उपयोगकर्ता के नोट सेव करने के लिए फ़्री फ़ॉर्म फ़ील्ड. डेटा डालने के लिए इस्तेमाल नहीं किया जाता.

TilesetBand

टाइलसेट से सोर्स किए गए एक बैंड को दिखाता है.

JSON के काेड में दिखाना 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
फ़ील्ड
id

string

बैंड का आईडी.
tilesetId

string

बैंड से जुड़े टाइलसेट का आईडी.
tilesetBandIndex

integer

बैंड से जुड़े टाइलसेट से, शून्य पर आधारित बैंड इंडेक्स. उदाहरण के लिए, अगर वैल्यू 1 है, तो बैंड के पिक्सल, टाइटलसेट के इंडेक्स 1 (ImageManifest.tilesets में) में मौजूद आईडी tilesetId वाले बैंड के पिक्सल होंगे.
missingData

object (MissingData)

ऐसी वैल्यू जो बैंड में कोई डेटा नहीं दिखाती हैं. अगर MissingData को बिना values के सेट किया जाता है, तो इस TilesetBand से जुड़ी फ़ाइलों के लिए मौजूद कोई भी nodata वैल्यू अनदेखी कर दी जाएगी.
pyramidingPolicy

enum (PyramidingPolicy)

पिरामिड स्कीम से जुड़ी नीति.

TilesetMaskBand

टाइलसेट से सोर्स किए गए एक मास्क बैंड को दिखाता है.

JSON के काेड में दिखाना 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
फ़ील्ड
tilesetId

string

मास्क बैंड से जुड़े टाइलसेट का आईडी. टाइलसेट के आखिरी बैंड का इस्तेमाल हमेशा मास्क बैंड के तौर पर किया जाता है.
bandIds[]

string

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

PixelFootprint

किसी इमेज में मौजूद सभी मान्य पिक्सल का फ़ुटप्रिंट.

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

object (GridPoint)

एक रिंग, जो किसी साधारण पॉलीगॉन के बाहरी हिस्से को बनाती है. इसमें इमेज के सभी मान्य पिक्सल के बीच के हिस्से होने चाहिए. यह एक लीनियर रिंग होनी चाहिए: आखिरी पॉइंट, पहले पॉइंट के बराबर होना चाहिए. कोऑर्डिनेट, bandId के तय किए गए बैंड के प्रोजेक्शन में होते हैं.

ध्यान दें: हर पिक्सल के बीच जैसे नॉन-इंटिजर कोऑर्डिनेट का इस्तेमाल करें, क्योंकि फ़ुटप्रिंट में किसी पिक्सल को शामिल करने के लिए ज़रूरी है कि पिक्सल (1x1 रेक्टैंगल) फ़ुटप्रिंट से इंटरसेक्शन करे. गलती से आस-पास के पिक्सल को चुनने से बचने के लिए, पूर्णांक वैल्यू वाले निर्देशांक का इस्तेमाल न करें, क्योंकि ये पिक्सल के बीच की सीमाएं होती हैं. पिक्सल के बीच में फ़ुटप्रिंट बनाने से, अनचाहे पिक्सल शामिल होने से रोका जा सकता है. अनचाहे पिक्सल शामिल होने पर, मैप की सीमा के आस-पास मौजूद पिक्सल में गड़बड़ियां हो सकती हैं. जैसे, एंटीमिडियन या पोल.

उदाहरण के लिए, चार मान्य पिक्सल वाली 2x2 इमेज के लिए, यहां दी गई रिंग का इस्तेमाल किया जा सकता है: [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

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

GridPoint

दो डाइमेंशन वाला पॉइंट या वेक्टर.

JSON के काेड में दिखाना 
{
  "x": number,
  "y": number
}
फ़ील्ड
x

number

x-कोऑर्डिनेट की वैल्यू.
y

number

y कॉर्डिनेट की वैल्यू.