इमेज मेनिफ़ेस्ट अपलोड करना

अगर आपको Google Earth Engine (EE) में इमेज अपलोड करने के लिए, कोड एडिटर यूज़र इंटरफ़ेस (यूआई) या 'earthengine' कमांड-लाइन टूल के upload कमांड से ज़्यादा सुविधाएं चाहिए, तो JSON फ़ाइल का इस्तेमाल करके इमेज अपलोड करने के बारे में बताएं. इस फ़ाइल को "मेनिफ़ेस्ट" कहा जाता है. इसके बाद, कमांड-लाइन टूल के upload image --manifest कमांड का इस्तेमाल करें.

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

सिर्फ़ एक बार वाला सेटअप

  1. मेनिफ़ेस्ट अपलोड करने की सुविधा, सिर्फ़ Google Cloud Storage में मौजूद फ़ाइलों के साथ काम करती है. Google Cloud Storage का इस्तेमाल शुरू करने के लिए, एक Google Cloud प्रोजेक्ट बनाएं. ऐसा तब करें, जब आपके पास पहले से कोई प्रोजेक्ट न हो. ध्यान दें कि सेटअप के लिए, बिलिंग के लिए क्रेडिट कार्ड की जानकारी देना ज़रूरी है. EE फ़िलहाल किसी से कोई शुल्क नहीं ले रहा है. हालांकि, EE पर फ़ाइलें अपलोड करने से पहले, उन्हें Google Cloud Storage में ट्रांसफ़र करने पर थोड़ा शुल्क लगेगा. अपलोड किए जाने वाले डेटा के सामान्य साइज़ (दस या सैकड़ों गीगाबाइट) के लिए, शुल्क काफ़ी कम होगा.
  2. अपने प्रोजेक्ट में, Cloud Storage API चालू करें और एक बकेट बनाएं.
  3. Earth Engine Python क्लाइंट इंस्टॉल करें. इसमें earthengine कमांड-लाइन टूल शामिल है. इसका इस्तेमाल, हम डेटा अपलोड करने के लिए करेंगे.
  4. अपने-आप होने वाले अपलोड के लिए, अपने प्रोजेक्ट से जुड़े Google Cloud सेवा खाते का इस्तेमाल किया जा सकता है. टेस्टिंग के लिए, आपको सेवा खाते की ज़रूरत नहीं है. हालांकि, जब आपके पास समय हो, तो कृपया इसके इस्तेमाल के बारे में जानकारी हासिल करें.

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

ऐसेट के आईडी और नाम

क्लाउड प्रोजेक्ट के मालिकाना हक वाली ऐसेट के लिए, ऐसेट के नाम के लिए इस कन्वेंशन का इस्तेमाल करें: projects/some-project-id/assets/some-asset-id.

लेगसी प्रोजेक्ट और उपयोगकर्ता के मालिकाना हक वाली ऐसेट के लिए, ऐसेट के नामों के बारे में जानकारी

पुराने लेगसी प्रोजेक्ट के लिए, मेनिफ़ेस्ट में ऐसेट का नाम, Earth Engine में कहीं और दिखने वाले ऐसेट का आईडी से थोड़ा अलग होना चाहिए. ऐसी ऐसेट अपलोड करने के लिए जिनके आईडी users/some_user या projects/some_project से शुरू होते हैं, मेनिफ़ेस्ट में ऐसेट के नाम के आईडी से पहले स्ट्रिंग projects/earthengine-legacy/assets/ होनी चाहिए. उदाहरण के लिए, EE ऐसेट का आईडी users/username/my_geotiff को projects/earthengine-legacy/assets/users/username/my_geotiff नाम का इस्तेमाल करके अपलोड किया जाना चाहिए.

हां, इसका मतलब है कि projects/some_projects/some_asset जैसे आईडी, उन नामों में बदल जाते हैं जिनमें projects को दो बार शामिल किया जाता है: projects/earthengine-legacy/assets/projects/some_projects/some_asset. यह भ्रम पैदा करने वाला है, लेकिन Google Cloud API के मानकों का पालन करने के लिए ज़रूरी है.

मेनिफ़ेस्ट का इस्तेमाल करना

यहां दिए गए कोड ब्लॉक में, एक बुनियादी मेनिफ़ेस्ट दिखाया गया है. यह gs://earthengine-test नाम की Google Cloud Storage बकेट से, small.tif नाम की फ़ाइल अपलोड करता है.

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://earthengine-test/small.tif"
          ]
        }
      ]
    }
  ]
}

इसका इस्तेमाल करने के लिए, इसे manifest.json नाम की फ़ाइल में सेव करें और चलाएं:

earthengine upload image --manifest /path/to/manifest.json

(gs://earthengine-test/small.tif फ़ाइल मौजूद है और इसे सार्वजनिक तौर पर पढ़ा जा सकता है. इसका इस्तेमाल, जांच के लिए किया जा सकता है.)

टाइल्ससेट

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

  • मोज़ेक. कभी-कभी कई फ़ाइलें, कई टाइल दिखाती हैं. उदाहरण के लिए, हर टाइल 1x1 डिग्री का स्क्वेयर होती है. ऐसी फ़ाइलों को EE ऐसेट में एक ही बैंड में मोज़ेक (एक साथ मर्ज) किया जाना चाहिए.
  • अलग-अलग बैंड. कभी-कभी, एक से ज़्यादा फ़ाइलें एक से ज़्यादा बैंड दिखाती हैं. ऐसी फ़ाइलों को EE ऐसेट में बैंड के तौर पर एक साथ स्टैक किया जाना चाहिए.

(दोनों तरीकों का इस्तेमाल एक साथ करना पड़ सकता है, लेकिन ऐसा बहुत कम होता है.)

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

मोज़ेक इंजेक्शन के लिए, मेनिफ़ेस्ट कुछ ऐसा दिखेगा:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/N30W22.tif"
          ]
        },
        {
          "uris": [
            "gs://bucket/N31W22.tif"
          ]
        }
      ]
    }
  ]
}

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

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "bands": ...,
  "tilesets": [
    {
      "id": "tileset_for_band1",
      "sources": [
        {
          "uris": [
            "gs://bucket/band1.tif"
          ]
        }
      ]
    },
    {
      "id": "tileset_for_band2",
      "sources": [
        {
          "uris": [
            "gs://bucket/band2.tif"
          ]
        }
      ]
    }
  ]
}

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

बैंड

दूसरा अहम कॉन्सेप्ट है, सोर्स फ़ाइलों को ईई ऐसेट बैंड से मैच करना. ऐसा करने के लिए, मेनिफ़ेस्ट के bands सेक्शन का इस्तेमाल किया जाता है.

bands सेक्शन को छोड़ा जा सकता है. ऐसा करने पर, बैंड पहले टाइलसेट की फ़ाइलों से बनाए जाते हैं. इसके बाद, अगले टाइलसेट से और इसी तरह आगे भी. डिफ़ॉल्ट रूप से, बैंड के नाम "b1", "b2" वगैरह होते हैं. डिफ़ॉल्ट बैंड के नामों को बदलने के लिए, आखिर में "बैंड" सेक्शन शामिल करें. जैसे:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/rgb.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "R",
      "tilesetBandIndex": 0
    },
    {
      "id": "G",
      "tilesetBandIndex": 1
    },
    {
      "id": "B",
      "tilesetBandIndex": 2
    }
  ]
}

EE बैंड की संख्या, सभी टाइलसेट में मौजूद बैंड की कुल संख्या के बराबर होनी चाहिए.

अगर आपको किसी फ़ाइल के सभी बैंड शामिल नहीं करने हैं, तो tilesetBandIndex फ़ील्ड का इस्तेमाल करके यह बताया जा सकता है कि कौनसे GDAL बैंड शामिल किए जाने चाहिए. पहले बैंड का tilesetBandIndex 0 होता है.

उदाहरण:

मान लें कि सोर्स फ़ाइल में चार बैंड हैं: "tmin", "tmin_error", "tmax", "tmax_error". हमें सिर्फ़ "tmin" और "tmax" को शामिल करना है. मेनिफ़ेस्ट के काम के सेक्शन कुछ इस तरह दिखेंगे:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "temperature",
      "sources": [
        {
          "uris": [
            "gs://bucket/temperature.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "tmin",
      "tilesetBandIndex": 0,
      "tilesetId": "temperature"
    },
    {
      "id": "tmax",
      "tilesetBandIndex": 2,
      "tilesetId": "temperature"
    }
  ]
}

मास्क बैंड

बैंड मास्किंग को मेनिफ़ेस्ट के maskBands कॉम्पोनेंट से कंट्रोल किया जाता है. मास्क के तीन संभावित कॉन्फ़िगरेशन इस्तेमाल किए जा सकते हैं. हालांकि, मास्क बैंड को हमेशा किसी फ़ाइल में आखिरी बैंड माना जाता है.

  1. एक ही फ़ाइल में मौजूद सभी डेटा बैंड के लिए मास्क.
  2. अन्य सभी फ़ाइलों से आने वाले सभी डेटा बैंड के लिए मास्क.
  3. कुछ डेटा बैंड के लिए मास्क.

1. सबसे आम मामला एक GeoTIFF का है, जिसके आखिरी बैंड का इस्तेमाल अन्य बैंड के लिए मास्क के तौर पर किया जाता है. यह सिर्फ़ बाइट टाइप के GeoTIFF के लिए काम करता है. इस मेनिफ़ेस्ट का इस्तेमाल करें:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "data_tileset"
    }
  ]
}

2. किसी GeoTIFF में मौजूद सभी बैंड के लिए, मास्क GeoTIFF को मास्क के तौर पर इस्तेमाल करने के लिए, इस मेनिफ़ेस्ट का इस्तेमाल करें:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    },
    {
      "id": "mask_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/mask_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "mask_tileset"
    }
  ]
}

3. किसी दूसरी फ़ाइल में किसी खास बैंड के लिए, GeoTIFF को मास्क के तौर पर इस्तेमाल करने के लिए, इस मेनिफ़ेस्ट का इस्तेमाल करें. पिछले मामले से अंतर यह है कि maskBands में bandIds फ़ील्ड सेट है:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "id": "data_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/data_file.tif"
          ]
        }
      ]
    },
    {
      "id": "mask_tileset",
      "sources": [
        {
          "uris": [
            "gs://bucket/mask_file.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "data_band",
      "tilesetId": "data_tileset"
    },
    {
      "id": "qa_band",
      "tilesetId": "data_tileset"
    }
  ],
  "maskBands": [
    {
      "tilesetId": "mask_tileset",
      "bandIds": ["data_band"]
    }
  ]
}

पिछले उदाहरण में, हम data_tileset टाइलसेट के दो बैंड के साथ काम कर रहे हैं. हालांकि, हम सिर्फ़ एक बैंड (data_band) पर मास्क लागू कर रहे हैं. ऐसा इसलिए, क्योंकि उपलब्ध कराए गए सिर्फ़ एक maskBands सूची ऑब्जेक्ट के bandIds फ़ील्ड में इसकी जानकारी दी गई है.

ध्यान दें कि maskBands में बताए गए टाइलसेट के आखिरी बैंड का इस्तेमाल ही मास्क बैंड के तौर पर किया जाता है.

पिरामिडिंग की नीति

जब Earth Engine, डेटा डालने के दौरान इमेज पिरामिड बनाता है, तो उसे 2x2-पिक्सल ग्रिड को बार-बार एक पिक्सल में बदलना पड़ता है. इससे पिक्सल की वैल्यू में कुछ बदलाव होता है. डिफ़ॉल्ट रूप से, पिक्सल वैल्यू का औसत निकाला जाता है. ज़्यादातर मामलों में ऐसा करना सही होता है, जब रास्टर बैंड कम या ज़्यादा लगातार डेटा दिखाता है. हालांकि, दो स्थितियों में डिफ़ॉल्ट वैल्यू पर भरोसा करने से गलत नतीजे मिल सकते हैं. ऐसे में, बैंड की परिभाषा में pyramidingPolicy फ़ील्ड को सेट करना ज़रूरी है. अगर इसे सेट नहीं किया जाता है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू "MEAN" मान ली जाती है.

रास्टर इमेज को अलग-अलग कैटगरी में बांटने के लिए (उदाहरण के लिए, लैंड कवर को अलग-अलग कैटगरी में बांटने के लिए), पिक्सल को पिरामिड करने का सबसे सही तरीका यह है कि चार वैल्यू में से ज़्यादातर वैल्यू को लेकर अगली वैल्यू बनाई जाए. इसके लिए, "MODE" पिरामिडिंग नीति का इस्तेमाल किया जाता है:

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/landcover.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "landcover",
      "pyramidingPolicy": "MODE"
    }
  ]
}

ऐसे रास्टर बैंड जहां "MEAN" या "MODE" का कोई मतलब नहीं होता (उदाहरण के लिए, बिटपैक किए गए पिक्सल), वहां "SAMPLE" पिरामिडिंग नीति का इस्तेमाल किया जाना चाहिए. "SAMPLE" हमेशा हर 2x2 ग्रिड से ऊपर बाएं हाथ के पिक्सल की वैल्यू लेता है. नीचे दिए गए उदाहरण में, "MEAN" पिरामिडिंग नीति को एक बैंड को असाइन किया गया है. यह बैंड, लगातार वैरिएबल ("NDVI") और डेटा के "QA" बैंड के लिए "SAMPLE" को दिखाता है.

{
  "name": "projects/earthengine-legacy/assets/users/username/some_folder/some_id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/ndvi.tif"
          ]
        }
      ]
    }
  ],
  "bands": [
    {
      "id": "NDVI",
      "tilesetBandIndex": 0,
      "pyramidingPolicy": "MEAN"
    },
    {
      "id": "QA",
      "tilesetBandIndex": 1,
      "pyramidingPolicy": "SAMPLE"
    }
  ]
}

शुरू और खत्म होने का समय

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

शुरू और खत्म होने के समय का मतलब आम तौर पर, निगरानी का समय होता है, न कि सोर्स फ़ाइल के बनने का समय.

खत्म होने के समय को एक्सक्लूसिव बाउंड्री के तौर पर माना जाता है, ताकि इसे आसानी से समझा जा सके. उदाहरण के लिए, ठीक एक दिन तक चलने वाली ऐसेट के लिए, शुरू और खत्म होने के समय के तौर पर, लगातार दो दिनों की आधी रात का समय इस्तेमाल करें. जैसे, 1980-01-31T00:00:00 और 1980-02-01T00:00:00. अगर ऐसेट की कोई अवधि नहीं है, तो खत्म होने का समय, शुरू होने के समय के बराबर सेट करें. मेनिफ़ेस्ट में समय को ISO 8601 स्ट्रिंग के तौर पर दिखाएं. हमारा सुझाव है कि तारीख की वैल्यू को आसान बनाने के लिए, यह मान लें कि खत्म होने का समय शामिल नहीं है. उदाहरण के लिए, रोज़ाना की ऐसेट के लिए अगले दिन की आधी रात.

उदाहरण:

{
  "name": "projects/some-project-id/assets/some-asset-id",
  "tilesets": [
    {
      "sources": [
        {
          "uris": [
            "gs://bucket/img_20190612.tif"
          ]
        }
      ]
    }
  ],
  "startTime": "1980-01-31T00:00:00Z",
  "endTime": "1980-02-01T00:00:00Z"
}

मेनिफ़ेस्ट स्ट्रक्चर का रेफ़रंस

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

{
  "name": <string>,
  "tilesets": [
    {
      "dataType": <string>,
      "id": <string>,
      "crs": <string>,
      "sources": [
        {
          "uris": [
            <stringn>>
          ],
          "affineTransform": {
            "scaleX": <double>,
            "shearX": <double>,
            "translateX": <double>,
            "shearY": <double>,
            "scaleY": <double>,
            "translateY": <double>
          }
        }
      ]
    }
  ],
  "bands": [
    {
      "id": <string>,
      "tilesetId": <string>,
      "tilesetBandIndex": <int32>,
      "missingData": {
        "values": [<doublen>>]
      },
      "pyramindingPolicy": <string>
    }
  ],
  "maskBands": [
    {
      "tilesetId": <string>,
      "bandIds": [
        <stringn>>
      ]
    }
  ],
  "footprint": {
    "points": [
      {
        "x": <double>,
        "y": <doublen>>
      }
    ],
    "bandId": <string>
  },
  "missingData": {
     "values": [<double>]
  },
  "pyramidingPolicy": <string>,
  "uriPrefix": <string>,
  "startTime": {
    "seconds": <integer>
  },
  "endTime": {
    "seconds": <integer>
  },
  "properties": {
    <unspecified>
  }
}

मेनिफ़ेस्ट फ़ील्ड की परिभाषाएं

नाम

string

बनाई जाने वाली ऐसेट का नाम. name का फ़ॉर्मैट "projects/*/assets/**" है (उदाहरण के लिए, "projects/earthengine-legacy/assets/users/USER/ASSET").

tilesets

list

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

tilesets[i].dataType

string

इससे डेटा के न्यूमेरिक डेटा टाइप के बारे में पता चलता है. डिफ़ॉल्ट रूप से, यह GDAL रिपोर्ट का टाइप होता है. इस मामले में, इसे तय करने की ज़रूरत नहीं होती.

डेटा टाइप वैल्यू
जानकारी उपलब्ध नहीं है "DATA_TYPE_UNSPECIFIED"
8-बिट वाला साइन किया गया इंटिजर "INT8"
8-बिट अनसाइंड इंटीजर "UINT8"
16-बिट का साइन वाला इंटिजर "INT16"
16-बिट अनसाइंड इंटिजर "UINT16"
32-बिट साइंड इंटिजर "INT32"
32-बिट अनसाइंड इंटिजर "UINT32"
32-बिट फ़्लोट "FLOAT32"
64-बिट फ़्लोट "FLOAT64"

tilesets[i].id

string

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

tilesets[i].crs

string

पिक्सल ग्रिड का कोऑर्डिनेट रेफ़रंस सिस्टम. इसे जहां तक हो सके स्टैंडर्ड कोड (उदाहरण के लिए, EPSG कोड) के तौर पर और अन्य मामलों में डब्ल्यूकेटी फ़ॉर्मैट में बताया जाता है.

tilesets[i].sources

list

डिक्शनरी की एक सूची, जिसमें इमेज फ़ाइल और उसकी साइडकार फ़ाइलों की प्रॉपर्टी के बारे में बताया गया हो. ज़्यादा जानकारी के लिए, यहां दिए गए sources डिक्शनरी एलिमेंट फ़ील्ड देखें.

tilesets[i].sources[j].uris

list

शामिल किए जाने वाले डेटा के यूआरआई की सूची. सिर्फ़ Google Cloud Storage यूआरआई का इस्तेमाल किया जा सकता है. हर यूआरआई को इस फ़ॉर्मैट में डालना ज़रूरी है: gs://bucket-id/object-id. मुख्य ऑब्जेक्ट, सूची का पहला एलिमेंट होना चाहिए. इसके बाद, साइडकार को सूची में शामिल किया जाना चाहिए. अगर सेट किया गया है, तो हर यूआरआई के पहले ImageManifest.uriPrefix जोड़ा जाता है.

tilesets[i].sources[j].affineTransform

dictionary

एक वैकल्पिक अफ़ाइन ट्रांसफ़ॉर्म. इसे सिर्फ़ तब इस्तेमाल किया जाना चाहिए, जब uris (इसमें कोई भी साइडकार शामिल है) से मिला डेटा, पिक्सल को प्लेस करने के लिए काफ़ी न हो. इसे इन कुंजियों के साथ डिक्शनरी के तौर पर दिया जाता है: "scaleX", "shearX", "translateX", "shearY", "scaleY", "translateY". ज़्यादा जानकारी के लिए, यह रेफ़रंस देखें.

की और वैल्यू के उदाहरण:

{
  "scaleX": 0.1,
  "shearX": 0.0,
  "translateX": -180.0,
  "shearY": 0.0,
  "scaleY": -0.1,
  "translateY": 90.0
}

बैंड

list

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

bands[i].id

string

बैंड का आईडी (नाम).

bands[i].tilesetId

string

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

bands[i].tilesetBandIndex

int32

बैंड से जुड़े टाइलसेट से, शून्य से शुरू होने वाला बैंड इंडेक्स.

bands[i].missingData.values

list

वैल्यू की सूची (डबल टाइप), जो बैंड में मौजूद डेटा को नहीं दिखाती.

bands[i].pyramidingPolicy

string

पिरामिड स्कीम से जुड़ी नीति. ज़्यादा जानकारी के लिए, यह लिंक देखें. विकल्पों में शामिल हैं:

  • "MEAN" (डिफ़ॉल्ट)
  • "MODE"
  • "SAMPLE"

maskBands

list

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

maskBands[i].tilesetId

string

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

maskBands[i].bandIds

list of strings

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

फ़ुटप्रिंट

dictionary

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

footprint.points

list

इमेज में मौजूद सभी मान्य पिक्सल के फ़ुटप्रिंट को तय करने वाले पॉइंट की सूची. किसी पॉइंट को "x" और "y" कुंजियों वाली डिक्शनरी से तय किया जाता है. इन कुंजियों में फ़्लोट वैल्यू होती हैं. बिंदुओं की सूची से एक रिंग के बारे में पता चलता है. यह रिंग, एक सामान्य पॉलीगॉन का बाहरी हिस्सा बनाती है. इस पॉलीगॉन में, इमेज के सभी मान्य पिक्सल के केंद्र शामिल होने चाहिए. यह एक लीनियर रिंग होनी चाहिए: आखिरी पॉइंट, पहले पॉइंट के बराबर होना चाहिए. निर्देशांक, bandId के तय किए गए बैंड के प्रोजेक्शन में होते हैं.

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

उदाहरण के लिए, सभी चार मान्य पिक्सल वाली 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
  }
]

footprint.bandId

string

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

missingData.values

list

वैल्यू की एक सूची (डबल टाइप) जो इमेज के सभी बैंड में मौजूद डेटा को नहीं दिखाती. यह उन सभी बैंड पर लागू होता है जिनके लिए missingData तय नहीं किया गया है.

pyramidingPolicy

string

पिरामिड स्कीम से जुड़ी नीति. अगर कोई जानकारी नहीं दी गई है, तो डिफ़ॉल्ट रूप से "MEAN" नीति लागू होती है. यह उन सभी बैंड पर लागू होता है जिनके लिए कोई बैंड तय नहीं किया गया है. ज़्यादा जानकारी के लिए, यह लिंक देखें. विकल्पों में शामिल हैं:

  • "MEAN" (डिफ़ॉल्ट)
  • "MODE"
  • "SAMPLE"

uriPrefix

string

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

startTime

integer

ऐसेट से जुड़ा टाइमस्टैंप, अगर कोई है. आम तौर पर, यह वह समय होता है जब सैटलाइट से ली गई तस्वीर ली गई थी. किसी समयावधि से जुड़ी एसेट के लिए, जैसे कि एक महीने या साल की औसत वैल्यू, यह टाइमस्टैंप उस समयावधि की शुरुआत से जुड़ा होता है. इसे Epoch (01-01-1970) के बाद से सेकंड और (ज़रूरी नहीं) नैनोसेकंड के तौर पर बताया जाता है. इसे यूटीसी टाइम ज़ोन में माना जाता है.

endTime

integer

किसी समयावधि से जुड़ी ऐसेट के लिए, जैसे कि एक महीने या साल की औसत वैल्यू, यह टाइमस्टैंप उस समयावधि के खत्म होने से जुड़ा होता है. हालांकि, इसमें वह समयावधि शामिल नहीं होती. इसे Epoch (01-01-1970) के बाद से सेकंड और (ज़रूरी नहीं) नैनोसेकंड के तौर पर बताया जाता है. इसे यूटीसी टाइम ज़ोन में माना जाता है.

प्रॉपर्टी

dictionary

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

सीमाएं

JSON मेनिफ़ेस्ट का साइज़

JSON मेनिफ़ेस्ट फ़ाइल का साइज़ 10 एमबी से ज़्यादा नहीं होना चाहिए. अगर आपको कई फ़ाइलें अपलोड करनी हैं, तो डेटासेट के बारे में बताने के लिए ज़रूरी वर्णों की संख्या कम करने के तरीकों पर विचार करें. उदाहरण के लिए, uriPrefix फ़ील्ड का इस्तेमाल करें, ताकि uris सूची में मौजूद हर यूआरआई के लिए, Google Cloud बकेट पाथ देने की ज़रूरत न पड़े. अगर साइज़ को और कम करना है, तो फ़ाइल के नामों को छोटा करें.

इमेज फ़ाइल फ़ॉर्मैट

हर इमेज फ़ाइल, TIFF इमेज होनी चाहिए. अगर मेनिफ़ेस्ट में सीआरएस की जानकारी नहीं दी गई है, तो फ़ाइल GeoTIFF फ़ॉर्मैट में होनी चाहिए और उसमें सीआरएस एम्बेड होना चाहिए.

TIFF फ़ाइलों को DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP या ZSTD की मदद से कंप्रेस किया जा सकता है.

बड़ी फ़ाइलों को अपलोड करने का सबसे अच्छा अनुभव पाने के लिए सुझाव:

  • सबसे सही विकल्प: ZSTD, स्पीड और कंप्रेशन के बीच अच्छा संतुलन बनाता है.
  • इस्तेमाल न करें: LZMA, अच्छी तरह से कंप्रेस करने के बावजूद बहुत धीमा हो सकता है.
  • कंप्रेस नहीं की गई फ़ाइलें: इनका साइज़ बड़ा होता है और इन्हें अपलोड होने में ज़्यादा समय लगता है.
  • लॉसी कंप्रेशन (जैसे, JPEG): इससे पिक्सल वैल्यू में बदलाव हो सकता है. जब तक आपको अपने डेटा पर पड़ने वाले असर की जानकारी न हो, तब तक फ़ाइल कंप्रेस करने के लिए, क्वालिटी पर असर न डालने वाले तरीके (जैसे, DEFLATE, LZMA, LZW, ZSTD) का इस्तेमाल करें.