یک جدول وارد می کند.
درخواست HTTP
POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:import
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
project | شناسه پروژه یا شماره پروژه پروژه Google Cloud Platform که باید به عنوان مصرف کننده سرویس برای این درخواست در نظر گرفته شود. قالب مجوز نیاز به مجوز IAM زیر در
|
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"tableManifest": {
object ( |
فیلدها | |
---|---|
tableManifest | مانیفست جدول |
description | نام کار قابل خواندن برای انسان. |
overwrite | اجازه بازنویسی یک دارایی موجود را می دهد یا خیر. |
requestId | یک رشته منحصر به فرد که برای شناسایی درخواست های تکراری استفاده می شود. اگر بیش از یک درخواست توسط یک کاربر با همان |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از 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 ( |
فیلدها | |
---|---|
name | نام دارایی که باید ایجاد شود. |
properties | ویژگی های اضافی دارایی نام ویژگی "system:time_start" و "system:time_end" منسوخ شده است. به جای آن از فیلدهای |
uriPrefix | پیشوند اختیاری به همه |
sources[] | منابعی که این جدول را تشکیل می دهند. |
startTime | مهر زمانی مرتبط با دارایی، در صورت وجود، به عنوان مثال زمانی که یک تصویر ماهواره ای گرفته شده است. برای دارایی هایی که با یک بازه زمانی مطابقت دارند، مانند مقادیر متوسط در طول یک ماه یا سال، این مهر زمانی با شروع آن بازه مطابقت دارد. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: |
endTime | برای دارایی هایی که با یک بازه زمانی مطابقت دارند، مانند مقادیر متوسط در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی (انحصاری) است. از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثالها: |
csvColumnDataTypeOverrides | به جای آن از columnDataTypeOverrides استفاده کنید. یک شی حاوی لیستی از |
columnDataTypeOverrides | یک نقشه از نام ستون تا نوع مورد استفاده برای آن ستون. ستونهایی که در اینجا مشخص نشدهاند، نوع خود را استنباط میکنند، بهطوریکه ستونهای عددی تبدیل به اعداد، ستونهای WKT تبدیل به هندسه و غیره میشوند. یک شی حاوی لیستی از |
memo | فیلد 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[] | URI داده هایی که باید وارد شوند. در حال حاضر فقط URI های Google Cloud Storage پشتیبانی می شوند. هر URI باید در قالب زیر مشخص شود: "gs://bucket-id/object-id". شی اصلی باید اولین عنصر لیست باشد، فایل های sidecar از مسیر فایل شی اصلی استنباط می شوند. در حال حاضر فقط یک URI پشتیبانی می شود. اگر بیش از یک URI مشخص شده باشد، خطای |
charset | نام مجموعه نویسه پیشفرض برای رمزگشایی رشتهها. اگر خالی باشد، مجموعه نویسه "utf-8" به طور پیش فرض در نظر گرفته می شود. |
maxErrorMeters | حداکثر خطای مجاز در متر هنگام تبدیل هندسه بین سیستم های مختصات. اگر خالی باشد، حداکثر خطا به طور پیش فرض 1 متر است. |
maxVertices | حداکثر تعداد رئوس اگر صفر نباشد، هندسه به قطعات ناهمگون فضایی تقسیم می شود که هر کدام زیر این حد هستند. |
crs | کد پیشفرض CRS یا رشته WKT که سیستم مرجع مختصات هر هندسهای را مشخص میکند که هندسه مشخصی ندارد. اگر خالی بماند، پیشفرض EPSG خواهد بود:4326: https://epsg.io/4326 . فقط برای منابع CSV/TFRecord. |
geodesic | استراتژی پیشفرض برای تفسیر یالهایی در هندسه که در غیر این صورت یک یال ندارند. اگر نادرست باشد، لبه ها در برآمدگی مستقیم هستند. اگر درست باشد، لبهها برای دنبال کردن کوتاهترین مسیر روی سطح زمین خمیده میشوند. وقتی خالی باشد، اگر «crs» یک سیستم مختصات پیشبینیشده باشد، پیشفرض نادرست است. فقط برای منابع CSV/TFRecord. |
primaryGeometryColumn | ستون هندسه برای استفاده به عنوان هندسه اولیه یک ردیف زمانی که بیش از یک ستون هندسی وجود دارد. اگر خالی رها شود و بیش از یک ستون هندسی وجود داشته باشد، اولین ستون هندسه ای که با آن مواجه می شویم استفاده می شود. فقط برای منابع CSV/TFRecord. |
xColumn | نام ستون مختصات x عددی برای استنتاج هندسه نقطه. اگر yColumn نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه ای با مقادیر x,y در سیستم مختصات داده شده در 'crs' ساخته می شود. اگر خالی بماند و «crs» یک سیستم مختصات پیشبینیشده را مشخص نکند ، «طول جغرافیایی» پیشفرض است. اگر خالی بماند و 'crs' یک سیستم مختصات پیش بینی شده را مشخص کند ، به طور پیش فرض روی "" قرار می گیرد و هندسه نقطه ای ایجاد نمی شود. یک ستون هندسه نقطهای ایجاد شده {xColumn}_{yColumn}_N نامیده میشود که در آن N بهگونهای اضافه میشود که اگر ستونی به نام {xColumn}_{yColumn} از قبل وجود داشته باشد، {xColumn}_{yColumn}_N منحصربهفرد است. فقط برای منابع CSV/TFRecord. |
yColumn | نام ستون مختصات عددی y برای استنتاج هندسه نقطه. اگر xColumn نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه ای با مقادیر x,y در سیستم مختصات داده شده در 'crs' ساخته می شود. اگر خالی بماند و «crs» یک سیستم مختصات پیشبینیشده را مشخص نکند ، بهطور پیشفرض روی «طول جغرافیایی» میشود. اگر خالی بماند و 'crs' یک سیستم مختصات پیش بینی شده را مشخص کند ، به طور پیش فرض روی "" قرار می گیرد و هندسه نقطه ای ایجاد نمی شود. یک ستون هندسه نقطهای ایجاد شده {xColumn}_{yColumn}_N نامیده میشود که در آن N بهگونهای اضافه میشود که اگر ستونی به نام {xColumn}_{yColumn} از قبل وجود داشته باشد، {xColumn}_{yColumn}_N منحصربهفرد است. فقط برای منابع CSV/TFRecord. |
dateFormat | قالبی که با آن می توان فیلدهای رمزگذاری تاریخ را تجزیه کرد. الگوی قالب باید همانگونه باشد که در http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html توضیح داده شده است. اگر خالی بماند، تاریخ ها به عنوان رشته وارد می شوند. فقط برای منابع CSV/TFRecord. |
csvDelimiter | هنگام دریافت فایلهای CSV، از یک کاراکتر به عنوان جداکننده بین مقادیر ستون در یک ردیف استفاده میشود. اگر خالی بماند، پیشفرض روی «،» است. فقط برای منابع CSV. |
csvQualifier | هنگام دریافت فایلهای CSV، نویسهای که مقادیر ستونها را احاطه میکند (معروف به «کاراکتر نقل قول»). اگر خالی بماند، پیشفرض روی """ است. فقط برای منابع CSV. اگر یک مقدار ستون توسط واجد شرایط احاطه نشده باشد، فضای سفید پیشرو و انتهایی کوتاه می شود. به عنوان مثال: ...، تست،... <== این مقدار واجد شرایط نیست به مقدار رشته تبدیل می شود: "test" <== فضای خالی حذف می شود جایی که: ..." test"،... <== این مقدار با quotes واجد شرایط است به مقدار رشته تبدیل می شود: "test" <== فضای خالی باقی می ماند! |