یک جدول را وارد میکند.
درخواست HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:import
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
project | شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرفکننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن مجوزدهی به مجوز 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 .
جدول مانیفست
توضیح میدهد که چگونه سرویس EarthEngine باید از مجموعهای از فایلها، جدولی تشکیل دهد.
| نمایش JSON |
|---|
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object ( |
| فیلدها | |
|---|---|
name | نام دارایی که قرار است ایجاد شود. |
properties | ویژگیهای اضافی دارایی. نامهای ویژگی "system:time_start" و "system:time_end" منسوخ شدهاند. به جای آنها از فیلدهای |
uriPrefix | پیشوند اختیاری به تمام |
sources[] | منابعی که این جدول را تشکیل میدهند. |
startTime | مهر زمانی مرتبط با دارایی، در صورت وجود، مثلاً زمانی که یک تصویر ماهوارهای گرفته شده است. برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند مقادیر میانگین در طول یک ماه یا سال، این مهر زمانی مربوط به شروع آن بازه زمانی است. از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
endTime | برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند میانگین مقادیر در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی است (به طور انحصاری). از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
csvColumnDataTypeOverrides | به جای آن از columnDataTypeOverrides استفاده کنید. یک شیء شامل لیستی از جفتهای |
columnDataTypeOverrides | نگاشتی از نام ستون به نوع مورد استفاده برای آن ستون. ستونهایی که در اینجا مشخص نشدهاند، نوعشان استنباط خواهد شد، به طوری که ستونهای عددی به اعداد، ستونهای WKT به هندسه و غیره تبدیل میشوند. یک شیء شامل لیستی از جفتهای |
memo | فیلد Freeform برای ذخیره یادداشتهای کاربر. در ingestion استفاده نمیشود. |
جدول منبع
یک فایل جدولی.
| نمایش 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) دادههایی که باید وارد شوند. در حال حاضر فقط آدرسهای اینترنتی ذخیرهسازی ابری گوگل پشتیبانی میشوند. هر آدرس اینترنتی باید با فرمت زیر مشخص شود: "gs://bucket-id/object-id". شیء اصلی باید اولین عنصر لیست باشد، فایلهای sidecar از مسیر فایل شیء اصلی استنباط میشوند. در حال حاضر فقط یک آدرس اینترنتی (URI) پشتیبانی میشود. اگر بیش از یک آدرس اینترنتی مشخص شود، خطای |
charset | نام مجموعه کاراکتر پیشفرض برای رمزگشایی رشتهها. در صورت خالی بودن، مجموعه کاراکتر "utf-8" به طور پیشفرض در نظر گرفته میشود. |
maxErrorMeters | حداکثر خطای مجاز بر حسب متر هنگام تبدیل هندسه بین سیستمهای مختصات. در صورت خالی بودن، حداکثر خطا به طور پیشفرض ۱ متر است. |
maxVertices | حداکثر تعداد رئوس. اگر صفر نباشد، هندسه به قطعاتی از نظر مکانی مجزا تقسیم میشود که هر کدام زیر این حد هستند. |
crs | کد پیشفرض CRS یا رشته WKT که سیستم مرجع مختصات هر هندسهای را که سیستم مرجع مختصات مشخصی ندارد، مشخص میکند. اگر خالی گذاشته شود، پیشفرض EPSG:4326 خواهد بود: https://epsg.io/4326 . فقط برای منابع CSV/TFRecord. |
geodesic | استراتژی پیشفرض برای تفسیر لبهها در هندسهای که لبهی دیگری برای آنها مشخص نشده است. اگر نادرست باشد، لبهها در تصویر مستقیم هستند. اگر درست باشد، لبهها منحنی هستند تا کوتاهترین مسیر را روی سطح زمین دنبال کنند. وقتی خالی باشد، اگر 'crs' یک سیستم مختصات تصویر شده باشد، پیشفرض روی نادرست است. فقط برای منابع CSV/TFRecord. |
primaryGeometryColumn | ستون هندسی که به عنوان هندسه اصلی یک ردیف استفاده میشود، زمانی که بیش از یک ستون هندسی وجود دارد. اگر خالی گذاشته شود و بیش از یک ستون هندسی وجود داشته باشد، اولین ستون هندسی که با آن مواجه میشوید استفاده میشود. فقط برای منابع CSV/TFRecord. |
xColumn | نام ستون مختصات x عددی برای استنتاج هندسه نقطه. اگر ستون y نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه با مقادیر x و y در سیستم مختصات داده شده در 'crs' ساخته خواهد شد. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص نکند ، به طور پیشفرض روی "طول جغرافیایی" قرار میگیرد. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص کند ، به طور پیشفرض روی "" قرار میگیرد و هیچ هندسه نقطهای ایجاد نمیشود. یک ستون هندسه نقطهای تولید شده، {xColumn}_{yColumn}_N نام خواهد داشت که در آن N به گونهای اضافه میشود که {xColumn}_{yColumn}_N در صورتی که ستونی با نام {xColumn}_{yColumn} از قبل وجود داشته باشد، منحصر به فرد باشد. فقط برای منابع CSV/TFRecord. |
yColumn | نام ستون مختصات y عددی برای استنتاج هندسه نقطه. اگر xColumn نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه با مقادیر x، y در سیستم مختصات داده شده در 'crs' ساخته خواهد شد. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص نکند ، به طور پیشفرض روی "latitude" تنظیم میشود. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص کند ، به طور پیشفرض روی "" تنظیم میشود و هیچ هندسه نقطهای ایجاد نمیشود. یک ستون هندسه نقطهای تولید شده، {xColumn}_{yColumn}_N نام خواهد داشت که در آن N به گونهای اضافه میشود که {xColumn}_{yColumn}_N در صورتی که ستونی با نام {xColumn}_{yColumn} از قبل وجود داشته باشد، منحصر به فرد باشد. فقط برای منابع 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" <== فضای خالی حذف میشود که در آن: ...، "test"،... <== این مقدار با علامت نقل قول مشخص میشود و به مقدار رشتهای تبدیل میشود: "test" <== فاصله باقی میماند! |
یک جدول را وارد میکند.
درخواست HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:import
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
project | شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرفکننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن مجوزدهی به مجوز 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 .
جدول مانیفست
توضیح میدهد که چگونه سرویس EarthEngine باید از مجموعهای از فایلها، جدولی تشکیل دهد.
| نمایش JSON |
|---|
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object ( |
| فیلدها | |
|---|---|
name | نام دارایی که قرار است ایجاد شود. |
properties | ویژگیهای اضافی دارایی. نامهای ویژگی "system:time_start" و "system:time_end" منسوخ شدهاند. به جای آنها از فیلدهای |
uriPrefix | پیشوند اختیاری به تمام |
sources[] | منابعی که این جدول را تشکیل میدهند. |
startTime | مهر زمانی مرتبط با دارایی، در صورت وجود، مثلاً زمانی که یک تصویر ماهوارهای گرفته شده است. برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند مقادیر میانگین در طول یک ماه یا سال، این مهر زمانی مربوط به شروع آن بازه زمانی است. از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
endTime | برای داراییهایی که مربوط به یک بازه زمانی هستند، مانند میانگین مقادیر در طول یک ماه یا سال، این مهر زمانی مربوط به پایان آن بازه زمانی است (به طور انحصاری). از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
csvColumnDataTypeOverrides | به جای آن از columnDataTypeOverrides استفاده کنید. یک شیء شامل لیستی از جفتهای |
columnDataTypeOverrides | نگاشتی از نام ستون به نوع مورد استفاده برای آن ستون. ستونهایی که در اینجا مشخص نشدهاند، نوعشان استنباط خواهد شد، به طوری که ستونهای عددی به اعداد، ستونهای WKT به هندسه و غیره تبدیل میشوند. یک شیء شامل لیستی از جفتهای |
memo | فیلد Freeform برای ذخیره یادداشتهای کاربر. در ingestion استفاده نمیشود. |
جدول منبع
یک فایل جدولی.
| نمایش 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) دادههایی که باید وارد شوند. در حال حاضر فقط آدرسهای اینترنتی ذخیرهسازی ابری گوگل پشتیبانی میشوند. هر آدرس اینترنتی باید با فرمت زیر مشخص شود: "gs://bucket-id/object-id". شیء اصلی باید اولین عنصر لیست باشد، فایلهای sidecar از مسیر فایل شیء اصلی استنباط میشوند. در حال حاضر فقط یک آدرس اینترنتی (URI) پشتیبانی میشود. اگر بیش از یک آدرس اینترنتی مشخص شود، خطای |
charset | نام مجموعه کاراکتر پیشفرض برای رمزگشایی رشتهها. در صورت خالی بودن، مجموعه کاراکتر "utf-8" به طور پیشفرض در نظر گرفته میشود. |
maxErrorMeters | حداکثر خطای مجاز بر حسب متر هنگام تبدیل هندسه بین سیستمهای مختصات. در صورت خالی بودن، حداکثر خطا به طور پیشفرض ۱ متر است. |
maxVertices | حداکثر تعداد رئوس. اگر صفر نباشد، هندسه به قطعاتی از نظر مکانی مجزا تقسیم میشود که هر کدام زیر این حد هستند. |
crs | کد پیشفرض CRS یا رشته WKT که سیستم مرجع مختصات هر هندسهای را که سیستم مرجع مختصات مشخصی ندارد، مشخص میکند. اگر خالی گذاشته شود، پیشفرض EPSG:4326 خواهد بود: https://epsg.io/4326 . فقط برای منابع CSV/TFRecord. |
geodesic | استراتژی پیشفرض برای تفسیر لبهها در هندسهای که لبهی دیگری برای آنها مشخص نشده است. اگر نادرست باشد، لبهها در تصویر مستقیم هستند. اگر درست باشد، لبهها منحنی هستند تا کوتاهترین مسیر را روی سطح زمین دنبال کنند. وقتی خالی باشد، اگر 'crs' یک سیستم مختصات تصویر شده باشد، پیشفرض روی نادرست است. فقط برای منابع CSV/TFRecord. |
primaryGeometryColumn | ستون هندسی که به عنوان هندسه اصلی یک ردیف استفاده میشود، زمانی که بیش از یک ستون هندسی وجود دارد. اگر خالی گذاشته شود و بیش از یک ستون هندسی وجود داشته باشد، اولین ستون هندسی که با آن مواجه میشوید استفاده میشود. فقط برای منابع CSV/TFRecord. |
xColumn | نام ستون مختصات x عددی برای استنتاج هندسه نقطه. اگر ستون y نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه با مقادیر x و y در سیستم مختصات داده شده در 'crs' ساخته خواهد شد. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص نکند ، به طور پیشفرض روی "طول جغرافیایی" قرار میگیرد. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص کند ، به طور پیشفرض روی "" قرار میگیرد و هیچ هندسه نقطهای ایجاد نمیشود. یک ستون هندسه نقطهای تولید شده، {xColumn}_{yColumn}_N نام خواهد داشت که در آن N به گونهای اضافه میشود که {xColumn}_{yColumn}_N در صورتی که ستونی با نام {xColumn}_{yColumn} از قبل وجود داشته باشد، منحصر به فرد باشد. فقط برای منابع CSV/TFRecord. |
yColumn | نام ستون مختصات y عددی برای استنتاج هندسه نقطه. اگر xColumn نیز مشخص شده باشد و هر دو ستون حاوی مقادیر عددی باشند، یک ستون هندسه نقطه با مقادیر x، y در سیستم مختصات داده شده در 'crs' ساخته خواهد شد. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص نکند ، به طور پیشفرض روی "latitude" تنظیم میشود. اگر خالی بماند و 'crs' سیستم مختصات تصویر شده را مشخص کند ، به طور پیشفرض روی "" تنظیم میشود و هیچ هندسه نقطهای ایجاد نمیشود. یک ستون هندسه نقطهای تولید شده، {xColumn}_{yColumn}_N نام خواهد داشت که در آن N به گونهای اضافه میشود که {xColumn}_{yColumn}_N در صورتی که ستونی با نام {xColumn}_{yColumn} از قبل وجود داشته باشد، منحصر به فرد باشد. فقط برای منابع 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" <== فضای خالی حذف میشود که در آن: ...، "test"،... <== این مقدار با علامت نقل قول مشخص میشود و به مقدار رشتهای تبدیل میشود: "test" <== فاصله باقی میماند! |