Method: projects.table.import

یک جدول وارد می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
project

string

شناسه پروژه یا شماره پروژه پروژه Google Cloud Platform که باید به عنوان مصرف کننده سرویس برای این درخواست در نظر گرفته شود. قالب projects/{project-id} است.

مجوز نیاز به مجوز IAM زیر در project منبع مشخص شده دارد:

  • 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/ / "). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال "پروژه‌ها/میراث زمینی/دارایی/کاربران/فو/بار"). همه دارایی‌های دیگر تحت پروژه "عمومی-خاکی" قرار دارند (مثلاً "پروژه‌ها/خارجی-عمومی/دارایی‌ها/LANDSAT").

properties

object ( Struct format)

ویژگی های اضافی دارایی نام ویژگی "system:time_start" و "system:time_end" منسوخ شده است. به جای آن از فیلدهای startTime و endTime استفاده کنید.

uriPrefix

string

پیشوند اختیاری به همه uri های تعریف شده در این مانیفست اضافه می شود.

sources[]

object ( TableSource )

منابعی که این جدول را تشکیل می دهند.

startTime

string ( Timestamp format)

مهر زمانی مرتبط با دارایی، در صورت وجود، به عنوان مثال زمانی که یک تصویر ماهواره ای گرفته شده است. برای دارایی هایی که با یک بازه زمانی مطابقت دارند، مانند مقادیر متوسط ​​در طول یک ماه یا سال، این مهر زمانی با شروع آن بازه مطابقت دارد.

از RFC 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)

برای دارایی هایی که با یک بازه زمانی مطابقت دارند، مانند مقادیر متوسط ​​در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی (انحصاری) است.

از RFC 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

فیلد Freeform برای ذخیره یادداشت های کاربر. در بلع استفاده نمی شود.

منبع جدول

یک فایل جدول

نمایندگی 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

URI داده هایی که باید وارد شوند. در حال حاضر فقط URI های Google Cloud Storage پشتیبانی می شوند. هر URI باید در قالب زیر مشخص شود: "gs://bucket-id/object-id". شی اصلی باید اولین عنصر لیست باشد، فایل های sidecar از مسیر فایل شی اصلی استنباط می شوند. در حال حاضر فقط یک URI پشتیبانی می شود. اگر بیش از یک URI مشخص شده باشد، خطای INALID_ARGUMENT برگردانده می شود.

charset

string

نام مجموعه نویسه پیش‌فرض برای رمزگشایی رشته‌ها. اگر خالی باشد، مجموعه نویسه "utf-8" به طور پیش فرض در نظر گرفته می شود.

maxErrorMeters

number

حداکثر خطای مجاز در متر هنگام تبدیل هندسه بین سیستم های مختصات. اگر خالی باشد، حداکثر خطا به طور پیش فرض 1 متر است.

maxVertices

integer

حداکثر تعداد رئوس اگر صفر نباشد، هندسه به قطعات ناهمگون فضایی تقسیم می شود که هر کدام زیر این حد هستند.

crs

string

کد پیش‌فرض CRS یا رشته WKT که سیستم مرجع مختصات هر هندسه‌ای را مشخص می‌کند که هندسه مشخصی ندارد. اگر خالی بماند، پیش‌فرض EPSG خواهد بود:4326: https://epsg.io/4326 . فقط برای منابع CSV/TFRecord.

geodesic

boolean

استراتژی پیش‌فرض برای تفسیر یال‌هایی در هندسه که در غیر این صورت یک یال ندارند. اگر نادرست باشد، لبه ها در برآمدگی مستقیم هستند. اگر درست باشد، لبه‌ها برای دنبال کردن کوتاه‌ترین مسیر روی سطح زمین خمیده می‌شوند. وقتی خالی باشد، اگر «crs» یک سیستم مختصات پیش‌بینی‌شده باشد، پیش‌فرض نادرست است. فقط برای منابع CSV/TFRecord.

primaryGeometryColumn

string

ستون هندسه برای استفاده به عنوان هندسه اولیه یک ردیف زمانی که بیش از یک ستون هندسی وجود دارد.

اگر خالی رها شود و بیش از یک ستون هندسی وجود داشته باشد، اولین ستون هندسه ای که با آن مواجه می شویم استفاده می شود. فقط برای منابع CSV/TFRecord.

xColumn

string

نام ستون مختصات x عددی برای استنتاج هندسه نقطه. اگر yColumn نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه ای با مقادیر x,y در سیستم مختصات داده شده در 'crs' ساخته می شود. اگر خالی بماند و «crs» یک سیستم مختصات پیش‌بینی‌شده را مشخص نکند ، «طول جغرافیایی» پیش‌فرض است. اگر خالی بماند و 'crs' یک سیستم مختصات پیش بینی شده را مشخص کند ، به طور پیش فرض روی "" قرار می گیرد و هندسه نقطه ای ایجاد نمی شود.

یک ستون هندسه نقطه‌ای ایجاد شده {xColumn}_{yColumn}_N نامیده می‌شود که در آن N به‌گونه‌ای اضافه می‌شود که اگر ستونی به نام {xColumn}_{yColumn} از قبل وجود داشته باشد، {xColumn}_{yColumn}_N منحصربه‌فرد است. فقط برای منابع CSV/TFRecord.

yColumn

string

نام ستون مختصات عددی y برای استنتاج هندسه نقطه. اگر xColumn نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه ای با مقادیر x,y در سیستم مختصات داده شده در 'crs' ساخته می شود. اگر خالی بماند و «crs» یک سیستم مختصات پیش‌بینی‌شده را مشخص نکند ، به‌طور پیش‌فرض روی «طول جغرافیایی» می‌شود. اگر خالی بماند و 'crs' یک سیستم مختصات پیش بینی شده را مشخص کند ، به طور پیش فرض روی "" قرار می گیرد و هندسه نقطه ای ایجاد نمی شود.

یک ستون هندسه نقطه‌ای ایجاد شده {xColumn}_{yColumn}_N نامیده می‌شود که در آن N به‌گونه‌ای اضافه می‌شود که اگر ستونی به نام {xColumn}_{yColumn} از قبل وجود داشته باشد، {xColumn}_{yColumn}_N منحصربه‌فرد است. فقط برای منابع 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" <== فضای خالی حذف می شود

جایی که: ..." test"،... <== این مقدار با quotes واجد شرایط است به مقدار رشته تبدیل می شود: "test" <== فضای خالی باقی می ماند!