Method: projects.table.import

टेबल इंपोर्ट करता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
project

string

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

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

  • earthengine.assets.create

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

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

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

object (TableManifest)

टेबल मेनिफ़ेस्ट.

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 देखें.

TableManifest

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

JSON के काेड में दिखाना
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "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 के आगे जोड़ा जाने वाला वैकल्पिक प्रीफ़िक्स.

sources[]

object (TableSource)

इस टेबल में शामिल सोर्स.

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".

csvColumnDataTypeOverrides
(deprecated)

map (key: string, value: enum (CsvColumnDataType))

इसके बजाय, columnDataTypeOverrides का इस्तेमाल करें.

ऐसा ऑब्जेक्ट जिसमें "key": value पेयर की सूची होती है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

columnDataTypeOverrides

map (key: string, value: enum (ColumnDataType))

कॉलम के नाम से उस कॉलम के लिए इस्तेमाल किए जाने वाले टाइप का मैप. जिन कॉलम के लिए यहां कोई टाइप नहीं बताया गया है उनके टाइप का अनुमान लगाया जाएगा. जैसे, संख्या वाले कॉलम संख्याओं में बदल जाएंगे, WKT कॉलम ज्यामिति में बदल जाएंगे वगैरह.

ऐसा ऑब्जेक्ट जिसमें "key": value पेयर की सूची होती है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

memo

string

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

TableSource

टेबल फ़ाइल.

JSON के काेड में दिखाना
{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}
फ़ील्ड
uris[]

string

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

charset

string

स्ट्रिंग को डिकोड करने के लिए इस्तेमाल किए जाने वाले डिफ़ॉल्ट कोड के बने अक्षरों का नाम. अगर यह खाली है, तो डिफ़ॉल्ट रूप से, "utf-8" को कोडिंग के तौर पर माना जाता है.

maxErrorMeters

number

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

maxVertices

integer

वर्टेक्स की ज़्यादा से ज़्यादा संख्या. अगर यह वैल्यू शून्य नहीं है, तो ज्यामिति को अलग-अलग हिस्सों में बांटा जाएगा. हालांकि, हर हिस्से का साइज़ इस सीमा से कम होगा.

crs

string

डिफ़ॉल्ट सीआरएस कोड या WKT स्ट्रिंग, जो किसी ऐसी ज्यामिति के कोऑर्डिनेट रेफ़रंस सिस्टम के बारे में बताती है जिसके लिए कोई कोड नहीं दिया गया है. इसे खाली छोड़ने पर, डिफ़ॉल्ट रूप से EPSG:4326: https://epsg.io/4326 सेट हो जाएगा. सिर्फ़ CSV/TFRecord सोर्स के लिए.

geodesic

boolean

ज्यामिति में किनारों को समझने के लिए डिफ़ॉल्ट रणनीति, जब उनके लिए कोई अन्य रणनीति तय न की गई हो. अगर यह वैल्यू false है, तो प्रोजेक्शन में किनारे सीधे होते हैं. अगर यह सही है, तो पृथ्वी की सतह पर सबसे छोटे रास्ते का पालन करने के लिए, किनारों को घुमाया जाता है. अगर 'crs' प्रोजेक्ट किया गया कोऑर्डिनेट सिस्टम है, तो खाली रहने पर यह डिफ़ॉल्ट रूप से गलत पर सेट होता है. सिर्फ़ CSV/TFRecord सोर्स के लिए.

primaryGeometryColumn

string

एक से ज़्यादा ज्यामिति कॉलम होने पर, पंक्ति की मुख्य ज्यामिति के तौर पर इस्तेमाल किया जाने वाला ज्यामिति कॉलम.

अगर इसे खाली छोड़ा जाता है और एक से ज़्यादा ज्यामिति कॉलम मौजूद होते हैं, तो पहले ज्यामिति कॉलम का इस्तेमाल किया जाता है. सिर्फ़ CSV/TFRecord सोर्स के लिए.

xColumn

string

पॉइंट की ज्यामिति का पता लगाने के लिए, अंकों वाले x-कोऑर्डिनेट कॉलम का नाम. अगर yColumn भी तय किया गया है और दोनों कॉलम में संख्या वाली वैल्यू हैं, तो 'crs' में दिए गए निर्देशांक सिस्टम में x,y वैल्यू के साथ पॉइंट ज्यामिति कॉलम बनाया जाएगा. अगर इसे खाली छोड़ दिया जाता है और 'crs' में प्रोजेक्ट किए गए निर्देशांक सिस्टम की जानकारी नहीं दी जाती है, तो यह डिफ़ॉल्ट रूप से "देशांतर" पर सेट हो जाता है. अगर इसे खाली छोड़ दिया जाता है और 'crs' में प्रोजेक्ट किए गए निर्देशांक सिस्टम की जानकारी दी जाती है, तो यह डिफ़ॉल्ट रूप से "" पर सेट हो जाता है और कोई पॉइंट ज्यामिति जनरेट नहीं होती.

जनरेट किए गए पॉइंट की ज्यामिति वाले कॉलम का नाम {xColumn}_{yColumn}_N होगा. इसमें N को इस तरह जोड़ा जाएगा कि {xColumn}_{yColumn}_N यूनीक हो. ऐसा तब किया जाएगा, जब {xColumn}_{yColumn} नाम का कॉलम पहले से मौजूद हो. सिर्फ़ CSV/TFRecord सोर्स के लिए.

yColumn

string

पॉइंट की ज्यामिति का पता लगाने के लिए, अंकों वाले y कॉर्डिनेट कॉलम का नाम. अगर xColumn भी तय किया गया है और दोनों कॉलम में संख्या वाली वैल्यू हैं, तो 'crs' में दिए गए निर्देशांक सिस्टम में x,y वैल्यू के साथ पॉइंट ज्यामिति कॉलम बनाया जाएगा. अगर इसे खाली छोड़ दिया जाता है और 'crs' में प्रोजेक्ट किए गए निर्देशांक सिस्टम की जानकारी नहीं दी जाती है, तो यह डिफ़ॉल्ट रूप से "अक्षांश" पर सेट हो जाता है. अगर इसे खाली छोड़ दिया जाता है और 'crs' में प्रोजेक्ट किए गए निर्देशांक सिस्टम की जानकारी दी जाती है, तो यह डिफ़ॉल्ट रूप से "" पर सेट हो जाता है और कोई पॉइंट ज्यामिति जनरेट नहीं होती.

जनरेट किए गए पॉइंट की ज्यामिति वाले कॉलम का नाम {xColumn}_{yColumn}_N होगा. इसमें N को इस तरह जोड़ा जाएगा कि {xColumn}_{yColumn}_N यूनीक हो. ऐसा तब किया जाएगा, जब {xColumn}_{yColumn} नाम का कॉलम पहले से मौजूद हो. सिर्फ़ CSV/TFRecord सोर्स के लिए.

dateFormat

string

तारीखों को कोड में बदलने वाले फ़ील्ड को पार्स करने के लिए इस्तेमाल किया जाने वाला फ़ॉर्मैट. फ़ॉर्मैट पैटर्न, http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html पर बताए गए फ़ॉर्मैट पैटर्न जैसा होना चाहिए. अगर इस फ़ील्ड को खाली छोड़ दिया जाता है, तो तारीखों को स्ट्रिंग के तौर पर इंपोर्ट किया जाएगा. सिर्फ़ CSV/TFRecord सोर्स के लिए.

csvDelimiter

string

CSV फ़ाइलों को डालते समय, एक पंक्ति में कॉलम वैल्यू के बीच डेलिमिटर के तौर पर इस्तेमाल किया जाने वाला एक वर्ण. अगर इसे खाली छोड़ा जाता है, तो डिफ़ॉल्ट रूप से ',' सेट हो जाता है. यह सिर्फ़ CSV सोर्स के लिए है.

csvQualifier

string

CSV फ़ाइलों को डालते समय, कॉलम की वैल्यू को घेरने वाला वर्ण (इसे "कोट वर्ण" भी कहा जाता है). अगर इसे खाली छोड़ा जाता है, तो यह डिफ़ॉल्ट रूप से '"' पर सेट हो जाता है. यह सिर्फ़ CSV सोर्स के लिए है.

अगर कॉलम की वैल्यू को क्वालिफ़ायर से नहीं घेरा गया है, तो शुरुआत और आखिर में मौजूद खाली जगह को काट दिया जाता है. उदाहरण के लिए: ..., टेस्ट,... <== यह वैल्यू स्ट्रिंग वैल्यू बन जाती है: "test" <== स्पेस हटा दिया जाता है

where: ...," test",... <== इस वैल्यू को कोटेशन में रखकर स्ट्रिंग वैल्यू बनाई जाती है: " test" <== खाली जगह बनी रहती है!