لتحميل ملف Shapefile من "محرر الرموز"، انقر على الزر
، ثم اختَر
ملفات Shapefile ضمن قسم تحميل
الجدول. سيظهر مربّع حوار تحميل مشابه لشكل
الرقم 1. انقر على الزر SELECT (اختيار) وانتقِل إلىملف Shapefile أو أرشيف Zip يحتوي على ملف Shapefile في نظام الملفات المحلي. عند اختيار
ملف .shp، احرص على اختيار ملفات .dbf و.shx و .prj ذات الصلة. سيستخدم Earth
Engine تلقائيًا إحداثيات WGS84 (خط الطول وخط العرض) في حال عدم تقديم ملف .prj. في حال تحميل أرشيف Zip، تأكَّد من أنّه يحتوي على ملف Shapefile واحد فقط
(مجموعة من .shp و.dbf و.shx و.prj وما إلى ذلك) وليس به أسماء ملفات مكرّرة. تأكَّد من أنّ أسماء الملفات
لا تتضمّن نقاطًا أو فواصل إضافية. (ستتضمّن أسماء الملفات نقطة واحدة قبل
الإضافة).
امنح الجدول معرّف مادة عرض مناسبًا (غير متوفّر حاليًا) في
مجلد المستخدم. انقر على تحميل لبدء عملية التحميل.
الشكل 1. مربّع حوار تحميل Shapefile في "أداة إدارة مواد العرض" يُرجى العلم أنّ ملفات shp .وdbf.
وshx .مطلوبة. تكون ملفات Sidecar الأخرى اختيارية. إذا لم يتم
تقديم ملف .prj، سيتم استخدام WGS84.
تحميل ملف CSV
لتحميل ملف CSV من "محرر الرموز"، فعِّل علامة التبويب مواد العرض، ثم انقر على
الزر واختَر
ملف CSV ضمن قسم تحميل الجدول. سيظهر مربّع حوار upload (تحميل)
مشابه للشكل 2. انقر على الزر اختيار وانتقِل
إلى ملف .csv على نظام الملفات المحلي. أدخِل اسمًا فريدًا وذا صلة لرقم تعريف مادة العرض في الجدول.
انقر على "حسنًا"
لبدء عملية التحميل.
الشكل 2: مربّع حوار تحميل ملف CSV في "أداة إدارة مواد العرض"
يجب أن يحتوي ملف CSV على صف لكلّ ميزة وعدد الأعمدة الذي يساوي عدد
المواقع أو المتغيّرات لمجموعة الميزات. إذا كانت العناصر مكانية، يجب أن يكون لها
موقع جغرافي محدّد إما من خلال سلسلة هندسية (GeoJSON أو WKT) أو سمتَي موضع x وy.
إذا كان ملف CSV مُصدَّرًا من نظام معلومات جغرافي أو أداة بيانات مكانية مثل GDAL/OGR، يجب أن يكون عمود الشكل الهندسي مُعدًّا بشكلٍ مناسب
ومُعنوَنًا.
بدلاً من ذلك، يمكن تحديد عمودَين للإحداثيَين x وy يمثّلان مواقع النقاط
في تطبيق جدول بيانات وتصديرهما
بتنسيق CSV مع أي متغيّرات أخرى.
خيارات متقدّمة
في قسم الخيارات المتقدّمة في مربّع حوار التحميل، اطّلِع على الإعدادات التلقائية وغيِّرها. يمكن تحسين أداء Earth Engine من خلال تقسيم الأشكال الهندسية
التي تحتوي على عدد كبير من الرؤوس. لا يسمح Earth Engine بعناصر تحتوي على أكثر من مليون نقطة. أثناء تحميل الجدول، ستقسّم أداة Earth Engine تلقائيًا الأشكال الهندسية التي
تحتوي على أكثر من مليون رأس. يمكنك تحديد قيمة أقل لتحسين أداء عرض المخطّط المتجه.
سيحاول Earth Engine رصد عمود هندسي أساسي ويفترض أنّ إسقاط
البيانات هو WGS84 ما لم يتم تحديد خلاف ذلك. يتم تحديد الحالة الجيوديسية للأشكال الهندسية
من خلال تفسير الحواف التلقائي لطريقة الإسقاط
المحدّدة (مثل استخدام WGS84 للأشكال الهندسية الجيوديسية)، ولكن يمكن إلغاء ذلك في
قائمة "الإعدادات المتقدّمة". إذا كانت هندسة بياناتك تتألف من نقاط محدّدة بواسطة عمودَي x وy
، احرص على تسمية العمودَين المعنيّين "خط الطول" و "خط العرض" أو تحديد
أسماء عمودَي x وy ضمن الإعدادات المتقدّمة.
تتبُّع مستوى تقدُّم عملية التحميل
بعد بدء تحميل جدول، تتم إضافة مهمة "نقل مواد العرض" إلى "مدير المهام"، والذي يمكن العثور عليه
ضمن علامة التبويب المهام على يسار "محرر الرموز". يمكنك التحقّق من حالة التحميل
بالنقر على ؟ رمز يظهر عند تمرير مؤشر الماوس فوق
المهمة لإلغاء عملية تحميل، انقر على رمز الدائرة الدوّارة
بجانب مهمة
التحميل. بعد اكتمال عملية نقل البيانات، ستتحول خلية المهمة إلى اللون الأزرق وستظهر مادة العرض
في مجلد المستخدم ضمن علامة التبويب مواد العرض مع
رمز table_chart.
حدود تحميل الجداول
عند تحميل الجداول، يكون الحد الأقصى لعدد العناصر في الجدول هو 100 مليون. الحد الأقصى
لعدد المواقع في ميزة هو 1,024. تضمن هذه الحدود إمكانية
البحث عن مادة العرض الناتجة بكفاءة. بالإضافة إلى ذلك، تتضمّن كل ميزة الحد الأقصى لعدد النقاط كما هو موضح في قسم "الخيارات المتقدّمة" أعلاه.
تحميل مادة عرض جدول إلى نصك البرمجي
لإنشاء FeatureCollection في النص البرمجي من مادة عرض جدول، استورِده كما هو описан في صفحة إدارة مواد العرض.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUpload Shapefiles or CSV files as table assets to Earth Engine using the Asset Manager or command line interface.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your vector data is in \u003ccode\u003eEPSG:4326\u003c/code\u003e projection before uploading to avoid unintended coordinate transformations.\u003c/p\u003e\n"],["\u003cp\u003eCSV files representing geospatial features must have a geometry column (GeoJSON or WKT) or columns named "longitude" and "latitude" for point locations.\u003c/p\u003e\n"],["\u003cp\u003eLarge geometries with over 1 million vertices will be automatically split by Earth Engine during upload, and you can adjust this limit in Advanced Options.\u003c/p\u003e\n"],["\u003cp\u003eMonitor upload progress and manage tasks in the Task Manager, and access uploaded table assets as \u003ccode\u003eFeatureCollection\u003c/code\u003e objects in your scripts.\u003c/p\u003e\n"]]],["Datasets in Shapefile or CSV format can be uploaded using the Asset Manager or command line interface. When uploading, specify a unique asset ID. Shapefiles require .shp, .dbf, and .shx files; a .prj file is recommended to avoid WGS84 default coordinates. CSV files should include a geometry string or x and y position properties. Geometries with over 1 million vertices will automatically split. Upload progress can be tracked in the Task Manager. Table uploads have a limit of 100 million features and 1,024 properties per feature.\n"],null,["# Importing Table Data\n\nUploading table assets\n----------------------\n\nYou can use the [Asset Manager](/earth-engine/guides/asset_manager) or\n[command line interface (CLI)](/earth-engine/guides/command_line#upload) to upload datasets in\nthe Shapefile or CSV format. (See [Importing Raster Data](/earth-engine/guides/image_upload) for details\non importing rasters using the Code Editor or CLI.) Your uploaded assets are initially\nprivate, but can be shared as described in the [Sharing\nAssets Section](/earth-engine/guides/asset_manager#sharing-assets).\n| **Warning:** All vector data in Earth Engine is stored in a spherical coordinate system (specifically, `EPSG:4326`). When data is uploaded, the resultant coordinate transformation may have unintended consequences that include change of geometry type (e.g. from polygon to linestring or point) or incorrect georeferencing. To minimize the possibility of unintended changes, first reproject vector data to `EPSG:4326` before uploading.\n\n### Upload a Shapefile\n\nTo upload a Shapefile from the Code Editor, click the\nbutton, then select\n**Shape files** under the **Table\nUpload** section. An upload dialog similar to\nFigure 1 will be presented. Click the **SELECT** button and navigate to a\nShapefile or Zip archive containing a Shapefile on your local file system. When selecting a\n.shp file, be sure to select the related .dbf, .shx and .prj files. Earth\nEngine will default to WGS84 (longitude, latitude) coordinates if a .prj file is not\nprovided. If you are uploading a Zip archive, make sure it contains only one Shapefile\n(set of .shp, .dbf, .shx, .prj, etc.) and no duplicate filenames. Make sure filenames\ndo not include additional periods or dots. (Filenames will include a single period before\nthe extension.)\n\nGive the table an appropriate asset ID (which doesn't already exist) in your\nuser folder. Click **UPLOAD** to start the upload.\nFigure 1. The Asset Manager Shapefile upload dialog. Note that the .shp, .dbf, and .shx files are required. The other sidecar files are optional. If the .prj file is not provided, WGS84 is assumed.\n\n### Upload a CSV file\n\nTo upload a CSV from the Code Editor, activate the **Assets** tab, then click\nthe button and select\n**CSV file** under the **Table Upload** section. An upload dialog\nsimilar to Figure 2 will be presented. Click the **SELECT** button and navigate\nto a .csv file on your local file system. Give the table a unique, relevant asset ID name.\nClick OK\nto start the upload.\nFigure 2. The Asset Manager CSV file upload dialog.\n\nThe CSV file should contain a row for each feature and as many columns as there are\nproperties or variables for the feature set. If features are geospatial, they must have a\ngeolocation defined by either a geometry string (GeoJSON, WKT) or x and y position properties.\nIf the CSV file is an export from a GIS or geospatial data tool such as GDAL/OGR, a properly\nformatted and named geometry column should already exist.\nAlternatively, two columns for x and y coordinates representing point locations can be\ndefined in a spreadsheet application and exported\nas CSV format along with any other variables.\n\nAdvanced Options\n----------------\n\n\nIn the **Advanced options** section of the upload dialog, view and change\ndefault settings. Performance of Earth Engine can be improved by splitting up geometries\nthat have a large number of vertices. Earth Engine does not allow features with more than 1\nmillion vertices. During table upload, Earth Engine will automatically split geometries that\nhave more than 1 million vertices. You can specify a lower value to improve vector\nrendering performance.\n\nEarth Engine will attempt to detect a primary geometry column and assumes the data\nprojection is WGS84 unless otherwise specified. The geodesic state of the geometries are\ndetermined by the default edge interpretation of the\ngiven projection (e.g. WGS84 uses geodesic geometries), but this can be overridden in the\nAdvanced settings menu. If the geometry of your data are points defined by x and y\ncolumns, be sure to name the respective columns \"longitude\" and \"latitude\" or specify the\nx and y column names under Advanced settings.\n| **Note:** Mixed datatype columns (e.g. numbers and strings) will default to string upon ingestion. This is an important consideration when preparing a table in a spreadsheet application, where it is common to denote missing data as NA, Null, None, --, etc. In the case of missing data, leave the \"cell\" empty.\n\nTracking upload progress\n------------------------\n\n\nAfter starting a table upload, an 'Asset ingestion' task is added to the Task Manager, found\nunder the **Tasks** tab at the right side of the Code Editor. Check the upload\nstatus by clicking on the **?** icon that appears when hovering over the\ntask. To cancel an upload, click on the spinning icon\nnext to the\ntask. Once the ingestion is complete, the task cell will turn blue and the asset will appear\nin your user folder under the **Assets** tab with\na table_chart icon.\n\nTable Upload Limits\n-------------------\n\n\nWhen uploading tables, the maximum number of features in the table is 100 million. The maximum\nnumber of properties on a feature is 1,024. These limits ensure that the resulting asset can\nbe queried efficiently. Additionally, each feature has a maximum number of vertices as\nexplained in the \"Advanced Options\" section above.\n\nLoading a table asset to your script\n------------------------------------\n\nTo create a `FeatureCollection` in your script from a table asset, import it as\ndescribed on the [Managing Assets](/earth-engine/guides/asset_manager#importing-assets-to-your-script)\npage."]]
، ثم اختَر
ملفات Shapefile ضمن قسم تحميل
الجدول. سيظهر مربّع حوار تحميل مشابه لشكل
الرقم 1. انقر على الزر SELECT (اختيار) وانتقِل إلىملف Shapefile أو أرشيف Zip يحتوي على ملف Shapefile في نظام الملفات المحلي. عند اختيار
ملف .shp، احرص على اختيار ملفات .dbf و.shx و .prj ذات الصلة. سيستخدم Earth
Engine تلقائيًا إحداثيات WGS84 (خط الطول وخط العرض) في حال عدم تقديم ملف .prj. في حال تحميل أرشيف Zip، تأكَّد من أنّه يحتوي على ملف Shapefile واحد فقط
(مجموعة من .shp و.dbf و.shx و.prj وما إلى ذلك) وليس به أسماء ملفات مكرّرة. تأكَّد من أنّ أسماء الملفات
لا تتضمّن نقاطًا أو فواصل إضافية. (ستتضمّن أسماء الملفات نقطة واحدة قبل
الإضافة).
بجانب مهمة
التحميل. بعد اكتمال عملية نقل البيانات، ستتحول خلية المهمة إلى اللون الأزرق وستظهر مادة العرض
في مجلد المستخدم ضمن علامة التبويب مواد العرض مع
رمز .