इस तरीके का इस्तेमाल करके, किसी ऐसेट को अपडेट किया जा सकता है. अपडेट करने की कार्रवाई से जुड़ी कई पाबंदियां हैं:
- ऐसेट के सिर्फ़
title,description,startTime,endTime, औरpropertiesफ़ील्ड अपडेट किए जा सकते हैं. updateMaskमें"properties"का नाम बदलने से, ऐसेट की सभी उपयोगकर्ता-परिभाषित प्रॉपर्टी,assetमें मौजूद प्रॉपर्टी से बदल जाती हैं.updateMaskमें"title","description","startTime"या"endTime"के नाम का इस्तेमाल करने औरassetमें कोई वैल्यू न देने पर, वह फ़ील्ड अनसेट हो जाता है.updateMaskमें प्रॉपर्टी का नाम देकर, उन्हें अपडेट किया जा सकता है. जैसे,"properties.my_property_name". प्रॉपर्टी की वैल्यू,asset.propertiesमें मौजूद वैल्यू के हिसाब से सेट की जाएगी. अगरasset.propertiesमें कोई वैल्यू मौजूद नहीं है या वैल्यू मौजूद है, लेकिन वहNullValueहै, तो ऐसे में प्रॉपर्टी को ऐसेट से हटा दिया जाएगा.- प्रॉपर्टी को सिर्फ़ स्ट्रिंग या संख्या वाली वैल्यू पर सेट किया जा सकता है. इसके अलावा,
NullValueतय करके उन्हें मिटाया जा सकता है. updateMaskको खाली रखने पर, ऐसेट के सभी टाइमस्टैंप और प्रॉपर्टी,assetमें मौजूद वैल्यू से बदल दी जाएंगी.
एचटीटीपी अनुरोध
PATCH https://earthengine.googleapis.com/v1/{asset.name=projects/*/assets/**}
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
| पैरामीटर | |
|---|---|
asset.name |
ऐसेट का नाम. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
|---|
{ "asset": { "cloudStorageLocation": { "uris": [ string ] }, "featureViewAssetLocation": { "assetOptions": { object ( |
| फ़ील्ड | |
|---|---|
asset.type |
ऐसेट का टाइप. |
asset.id |
एसेट का आईडी. यह |
asset.updateTime |
ऐसेट में पिछली बार बदलाव किए जाने का समय. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
asset.properties |
ऐसेट से जुड़ी मुख्य/वैल्यू प्रॉपर्टी. |
asset.startTime |
अगर ऐसेट से जुड़ा कोई टाइमस्टैंप है, तो वह. उदाहरण के लिए, सैटलाइट इमेज लिए जाने का समय. जिन ऐसेट के लिए समय का इंटरवल तय किया जाता है उनके लिए यह टाइमस्टैंप, उस इंटरवल की शुरुआत के समय का होता है. जैसे, एक महीने या साल की औसत वैल्यू. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
asset.endTime |
जिन ऐसेट के लिए समयसीमा तय होती है उनके लिए यह टाइमस्टैंप, उस समयसीमा के खत्म होने का समय होता है. जैसे, एक महीने या एक साल की औसत वैल्यू. यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
asset.geometry |
अगर ऐसेट से जुड़ा कोई स्पैटियल फ़ुटप्रिंट है, तो उसे GeoJSON ज्यामिति ऑब्जेक्ट के तौर पर दिखाया जाता है. इसके बारे में ज़्यादा जानने के लिए, RFC 7946 देखें. |
asset.bands[] |
इमेज ऐसेट के डेटा बैंड के बारे में जानकारी. इमेज के अलावा अन्य ऐसेट के लिए, इसे शामिल नहीं किया जाता. |
asset.sizeBytes |
पत्ती वाली ऐसेट (जैसे, इमेज) का साइज़, बाइट में. |
asset.featureCount |
अगर लागू हो, तो ऐसेट में मौजूद सुविधाओं की संख्या. |
asset.quota |
फ़ोल्डर ऐसेट से जुड़ा कोटा, अगर कोई है. यह कोड, उपयोगकर्ता के मालिकाना हक वाली टॉप-लेवल की फ़ोल्डर ऐसेट के लिए दिखाया जाता है. जैसे, "users/*" या "projects/*". |
asset.tilesets[] |
इस इमेज के साथ काम करने वाले टाइलसेट. यह सिर्फ़ बाहरी इमेज के लिए मौजूद होता है. इनके पिक्सल, Earth Engine के मालिकाना हक वाले स्टोरेज से नहीं लिए जाते हैं. |
updateMask |
अपडेट मास्क, यह तय करता है कि ऐसेट के किन फ़ील्ड को अपडेट करना है. यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नामों की कॉमा लगाकर अलग की गई लिस्ट है. उदाहरण: |
| रास्टर टाइल कहां और कैसे सेव की जाती हैं, इस बारे में जानकारी. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा: | |
asset.cloudStorageLocation |
समर्थन नहीं होना या रुकना. इसके बजाय, |
asset.featureViewAssetLocation |
EE में इस FeatureView की जगह. |
| एक-दूसरे से अलग फ़ील्ड के आखिर में. | |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में EarthEngineAsset का एक इंस्टेंस शामिल किया जाता है.
अनुमति पाने के लिंक
इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/cloud-platform
ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.