سؤالات متداول

سؤالات عمومی

مشکلی دارم، به کمک نیاز دارم!

سؤالی را با دنبال کردن این راهنما پست کنید، و تا حد امکان اطلاعات ارائه دهید (به راهنمای Stack Overflow برای پرسیدن سؤالات خوب مراجعه کنید). این معمولاً یعنی:

  • ارسال پیوند به اسکریپت در Code Editor (برای دریافت آن، روی دکمه «دریافت پیوند» کلیک کنید)

  • هم‌رسانی کردن دارایی‌های موردنیاز برای اجرای اسکریپت

  • برای تکلیف‌های دسته‌ای ناموفق، شناسه تکلیف ناموفق را گزارش کنید. شناسه تکلیف این‌گونه است: 4C25GIJBMB52PXTEJTF4JLGL. می‌توانید آن‌ها را در برگه «تکلیف» «ویرایشگر کد» پیدا کنید. بیشتر بدانید.

کجا می‌توانم درباره معماری Earth Engine مطالعه کنم؟

این مقاله را ببینید: Gorelick et al. 2017.

صفحه‌های EDU و منابع آموزشی را ببینید.

این دوره رایگان EE توسط اوجاوال گاندی را ببینید که شامل ویدیویی با مقدمه‌ای بر سنجش از دور است.

برنامه‌نویسی Earth Engine

برخی‌از خطاهای رایج کدنویسی چیست؟

راهنمای اشکال‌زدایی را ببینید.

چرا خطای «... تابع نیست» را دریافت می‌کنم؟

این خطا زمانی رخ می‌دهد که Earth Engine نتواند روش فراخوانده‌شده را پیدا کند. دلایل رایج زیر را بررسی کنید:

املا یا حساسیت به حروف بزرگ و کوچک: روش‌ها به حروف بزرگ و کوچک حساس هستند. املا را با مرجع میانای برنامه‌سازی کاربردی مطابقت دهید.

Error: img.normalizedDiff(...) -> Correct: img.normalizedDifference(...)

تبدیل نوع ازقلم‌افتاده: مقادیر برگردانده‌شده از توابعی مثل .get() نمونه‌های عمومی ee.ComputedObject هستند و باید به‌طور صریح تبدیل شوند. تبدیل نوع شیء ناشناخته را ببینید.

Error: dict.get('val').add(5) -> Correct: ee.Number(dict.get('val')).add(5)

ترکیب روش‌های کارخواه و سرور: مطمئن شوید که از روش‌های استاندارد JavaScript یا Python (مانند .push() یا .append()) در اشیاء Earth Engine استفاده نمی‌کنید. از ترکیب کردن عملکردهای کارخواه و سرور خودداری کنید را ببینید.

Error: list.push(4) or list.append(4) -> Correct: list.add(4)

روش‌های غیرقابل‌دسترس: اگر شیء به‌درستی تایپ شده است و روش در اسناد وجود دارد یا قبلاً کار می‌کرده است اما اکنون کار نمی‌کند، اشکال را گزارش کنید.

چرا نمی‌توانم از ریاضیات پایه مثل ee.Image("image") * 2 استفاده کنم؟

در EE نباید اشیاء یا عملیات سمت سرور و سمت کارخواه را باهم ترکیب کنید. همه عملیات روی اشیای EE در سمت سرور انجام می‌شود. هیچ‌کدام از محاسبات سمت کارخواه کاری را که شما می‌خواهید انجام نخواهند داد. برای جزئیات بیشتر، این صفحه را ببینید.

چگونه می‌توانم از حلقه‌های for یا دستورهای if/else استفاده کنم؟

برنامه‌نویسی Earth Engine بااستفاده از زبان تابعی انجام می‌شود، بنابراین حلقه‌ها و عملیات شرطی باید بااستفاده از مفاهیم معادل مانند map یا filter بیان شوند. برای جزئیات بیشتر، این صفحه را ببینید.

چگونه برچسب‌های نوشتاری را در تصویر یا ویدیو نشان دهم؟

پشتیبانی داخلی برای برچسب‌های نوشتاری وجود ندارد، اما می‌توانید:

  • از بسته JS شخص ثالث استفاده کنید. مشاهده مثال
  • از بسته Python طرف سوم geemap استفاده کنید.
  • استفاده از QGIS برای وارد کردن تصاویر EE بااستفاده از افزونه EE QGIS

آیا می‌توانم از پالت‌های رنگ استاندارد استفاده کنم؟

از بسته JS طرف سوم ee-palettes استفاده کنید.

چگونه می‌توانم وب‌سایت خودم را که از Earth Engine استفاده می‌کند ایجاد کنم؟

از برنامه‌های Earth Engine برای برنامه‌های پایه استفاده کنید. در موارد پیچیده‌تر، می‌توانید برنامه‌های App Engine با پشتیبانی EE بسازید.

شناسه‌های Map چگونه کار می‌کنند؟

شناسه‌های نقشه (که در سراسر API با نام mapid شناخته می‌شوند) کلیدهایی هستند که به کارخواهان اجازه می‌دهند کاشی‌های نقشه را واکشی کنند. هر شناسه یک درهم‌سازی است که با ارائه عبارت تصویر به نقطه پایانی getMapId ایجاد شده است. شناسه‌های حاصل کلیدهایی هستند که هم به عبارت تصویر و هم به اعتبارنامه‌های کاربر اشاره می‌کنند که برای تولید کاشی‌ها در مرحله بعدی استفاده خواهند شد.

درخواست کاشی‌های نقشه شامل مشخص کردن مکان کاشی (x،‏ y،‏ zoom) و همچنین mapid (کلید تصویر و اطلاعات کاربری) است. از همان شناسه می‌توان برای بار کردن کاشی‌های نقشه متعدد استفاده کرد. هیچ محدودیتی برای استفاده مجدد از کلیدهای mapid وجود ندارد، اما این کلیدها پس‌از چند ساعت منقضی می‌شوند. ما چارچوب زمانی مشخصی را برای مدت‌زمان ماندگاری آن‌ها منتشر نمی‌کنیم، اما هر کدی که می‌نویسید باید دربرابر انقضای شناسه مقاوم باشد.

ایجاد این شناسه‌ها شامل ذخیره مقدار کمی داده و اعتبارسنجی اعتبارنامه‌ها است، بنابراین بهتر است تا حد امکان از آن‌ها مجدداً استفاده شود. هیچ سهمیه میانای برنامه‌سازی کاربردی به‌طور خاص با نقطه پایانی getMapId مرتبط نیست، اما هر گردش کاری که شامل ایجاد اشیاء mapid با نرخی نزدیک به نرخ واکشی کاشی‌ها باشد احتمالاً اشتباهی انجام می‌دهد. Earth Engine هیچ نقطه پایانی میانای برنامه‌سازی کاربردی برای برداشتن، فهرست کردن، یا مدیریت این شناسه‌ها ندارد، زیرا این‌ها منابع گذرا هستند.

چرا ee.Algorithms.If() هم حالت درست و هم حالت نادرست را چاپ می‌کند؟

function a() { print("true"); }
function b() { print("false"); }
// Prints 'true' and 'false'.
ee.Algorithms.If(true, a(), b());

الگوریتم If() درست مانند هر الگوریتم دیگری در Earth Engine کار می‌کند، به این صورت که همه آرگومان‌های آن باید قبل‌از اجرای خود الگوریتم ارزیابی شوند. الگوریتم هر دو نتیجه trueCase و falseCase را دریافت می‌کند و سپس یکی را براساس آرگومان condition انتخاب و برمی‌گرداند، اما هر دو مسیر باید اجرا شوند تا آن مقادیر در وهله اول به الگوریتم منتقل شوند.

خطای «اندازه پایه‌بار درخواست از حد مجاز بیشتر است» را دریافت می‌کنم

درخواست بسیار بزرگی را می‌خواهید به Earth Engine ارسال کنید. این اتفاق معمولاً زمانی رخ می‌دهد که کد از تعداد زیادی حلقه «for» در سمت کارخواه استفاده می‌کند یا FeatureCollection را از تعداد زیادی شیء هندسی می‌سازد. در حالت دوم، به‌جای ایجاد چنین هندسه‌هایی در اسکریپت خود، یک فایل CSV حاوی آن‌ها تولید کنید و آن را در یک دارایی جدول بارگذاری کنید.

تفاوت ee.Image.clip() و ee.Filter.bounds() چیست؟

این رشته GIS Stack Exchange را ببینید. تابع ee.Image.clip() پیکسل‌هایی را که با ee.Geometry یا ee.Feature داده‌شده تلاقی ندارند ماسک می‌کند و آن‌ها را در تجسم‌ها شفاف می‌کند و در محاسبات مستثنی می‌کند. می‌توانید آن را به‌عنوان برش دادن پیکسل‌ها از تصویر تصور کنید.

تابع ee.Filter.bounds() ee.Image شیء را براساس تقاطع تصویر با ee.Geometry یا ee.Feature از ee.ImageCollection فیلتر می‌کند. از آن برای محدود کردن دامنه تحلیل فقط به تصاویری که با منطقه مشخصی تلاقی دارند استفاده می‌شود، که به بهینه‌سازی عبارت‌ها کمک می‌کند.

چگونه پیکسل‌های تصویر را به مجموعه‌های عارضه تبدیل کنیم، به‌طوری‌که هر پیکسل یک عارضه باشد؟

از تابع ee.Image.sample() استفاده کنید. نمونه‌های استفاده را در صفحه مرجع میانای برنامه‌سازی کاربردی تابع ببینید.

تفاوت ee.ImageCollection.merge() و ee.ImageCollection.combine() چیست؟

تابع ee.ImageCollection.merge() همه تصاویر دو مجموعه را در یک مجموعه ادغام می‌کند، صرف‌نظر از اینکه تصاویر مربوطه دارای باندها، فراداده‌ها، CRS، یا مقیاس منطبق باشند یا نه. این مجموعه ترکیبی از دو مجموعه است. روش combine() باندهای تصاویر منطبق را از دو مجموعه در یک مجموعه واحد ترکیب می‌کند. تصاویر منطبق شناسه یکسانی دارند (ویژگی system:index). این یک اتصال داخلی از دو مجموعه براساس شناسه تصویر است، که در آن باندهای تصاویر منطبق ترکیب می‌شوند. برای تصاویر منطبق، باندهای تصویر ثانویه به تصویر اولیه اضافه می‌شوند (رونویسی اختیاری است). اگر تصویر منطبقی وجود نداشته باشد، مجموعه خالی برگردانده می‌شود.

چگونه مجموعه‌های تصویر را در چندین بازه زمانی فیلتر کنیم؟

این رشته GIS Stack Exchange را ببینید. یا merge() چند مجموعه را باهم یا از ee.Filter.or() استفاده کنید.

چگونه می‌توانم یک جعبه مرزی در اطراف یک نقطه مشخص ایجاد کنم؟

// Buffer the point by a chosen radius and then get the bounding box.
var LNG = -117.298;
var LAT = 45.162;
var point = ee.Geometry.Point([LNG, LAT]);
var buffer = point.buffer(30000); // half of box width as buffer input
var box = buffer.bounds(); // draw a bounding box around the buffered point
Map.centerObject(box);
Map.addLayer(point);
Map.addLayer(box);

// Map the buffer and bounds procedure over a point feature collection.
var pointCol = ee.FeatureCollection([
  ee.Feature(ee.Geometry.Point([LNG + 1, LAT])),
  ee.Feature(ee.Geometry.Point([LNG - 1, LAT]))
]);
var boxCol = pointCol.map(function(feature) {
  var box = feature.buffer(30000).bounds();
  return feature.setGeometry(box.geometry());
});
Map.addLayer(boxCol);

Data Catalog

می‌توانید مجموعه داده X را اضافه کنید؟

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

همچنین می‌توانید داده‌ها را در پوشه اصلی Earth Engine بارگذاری کنید. به وارد کردن داده‌های شطرنجی و وارد کردن داده‌های جدول مراجعه کنید.

مجموعه داده موجود نسخه جدیدی دارد

بااستفاده از راهنمای درخواست مجموعه داده، اشکال مجموعه داده را ثبت کنید و مشخص کنید که درخواست به‌روزرسانی مجموعه داده را دارید.

مجموعه داده موجود به‌روز نشده است یا دارایی‌های آن موجود نیست

قبل‌از گزارش مشکل، درصورت امکان، بررسی کنید که دارایی‌های انتخاب‌شده واقعاً در سایت ارائه‌دهنده مجموعه داده وجود داشته باشند. برای جزئیات بیشتر، راهنمای تصاویر مفقود را ببینید.

اگر با فیلتر کردن ImageCollection به‌دنبال دارایی هستید، مطمئن شوید فیلترهایتان خیلی محدودکننده نباشد.

به‌طور خاص، توجه داشته باشید که:

  • ‫Sentinel-2 SR (داده‌های سطح ۲) توسط ESA برای صحنه‌های اولیه سطح ۱ تولید نشده است.

  • Landsat قبل‌از سال ۲۰۰۰ پوشش جهانی ندارد.

مجموعه داده موجود مقادیر اشتباهی دارد

در تالار گفتمان توسعه‌دهندگان پست کنید. متنی را اضافه کنید که روی وضوح اصلی دارایی بزرگ‌نمایی کند و به‌وضوح نشان دهد کدام مقادیر اشتباه است. توضیح دهید دقیقاً کجا مقدار جایگزین را مشاهده کردید.

کجا می‌توانم درباره مجموعه‌داده‌ها سؤال کنم؟

برای سؤالات درباره مجموعه‌داده‌های NASA، به تالار گفتمان داده‌های زمین NASA مراجعه کنید.

برای سؤالات مربوط به جعبه‌ابزارهای فعال در مجموعه‌داده‌های کوپرنیک، به تالارهای گفتمان S1، S2، و S3 مراجعه کنید.

کاتالوگ EE چقدر بزرگ است؟

از اکتبر ۲۰۲۳، این کاتالوگ حاوی بیش‌از ۱۰۰۰ مجموعه داده است. اندازه آن روی دیسک بیش‌از ۹۰ پتابایت است (با درنظر گرفتن فشرده‌سازی بدون اتلاف).

داده‌ها در EE چند وقت یک‌بار به‌روزرسانی می‌شوند؟

معمولاً همه مجموعه‌داده‌های جاری حداقل روزی یک‌بار به‌روز می‌شوند (هرچند همه این مجموعه‌داده‌ها هر روز داده‌های جدید ندارند). برخی‌از مجموعه‌داده‌ها چند بار در روز به‌روزرسانی می‌شوند. بااین‌حال، هیچ خط‌مشی‌ای وجود ندارد که حضور جدیدترین دارایی‌ها را در کاتالوگ تضمین کند.

چگونه می‌توانم محتوای کاتالوگ EE را به‌صورت برنامه‌نویسی مشاهده کنم؟

فهرست مجموعه داده‌ها در قالب STAC به سطل Google Cloud Storage gs://earthengine-stac صادر می‌شود. فایل ورودی catalog.json است.

آیا می‌توانم از داده‌ها یا تصاویر Google Maps برای تجزیه‌وتحلیل استفاده کنم؟

Google داده‌های نقشه پایه را برای تجزیه‌وتحلیل پروانه نمی‌دهد یا نمی‌فروشد.

چگونه می‌توانم تاریخ جذب یک دارایی را پیدا کنم؟

ویژگی دارایی 'system:version' مُهر زمان استخراج است که به‌صورت میکروثانیه از تاریخ یونیکس قالب‌بندی شده است. در اینجا مثالی آورده شده است که مُهر زمان دریافت تصویر Landsat را به قالبی قابل‌خواندن برای انسان تبدیل می‌کند.

var image = ee.Image('LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508');
print('Ingest date', ee.Date(image.getNumber('system:version').divide(1000)));

آیا «کاتالوگ Earth Engine» فراداده JSON-LD دارد؟

بله، فراداده JSON-LD در صفحه‌های HTML کاتالوگ جاسازی شده است. برای مثال، صفحه Sentinel-2 حاوی بلوک زیر است:

<script type="application/ld+json">
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [{
      "@type": "ListItem",
      "position": 1,
      "name": "Earth Engine Data Catalog",
      "item": "https://developers.google.com/earth-engine/datasets"
    },{
      "@type": "ListItem",
      "position": 2,
      "name": "Harmonized Sentinel-2 MSI: MultiSpectral Instrument, Level-1C",
      "item": "https://developers.google.com/earth-engine/datasets/catalog/COPERNICUS_S2_HARMONIZED"
    }]
  }
  </script>

لندست

الگوریتم simpleComposite چگونه پیاده‌سازی می‌شود؟

پیاده‌سازی سمت سرور معادل این کد جاوا اسکریپت است.

چگونه می‌توانم از داده‌های بازتاب سطحی Landsat ترکیب‌های بدون ابر ایجاد کنم؟

داده‌های Landsat Level 2 (بازتاب سطحی) چندین باند کیفی دارند که می‌توان از آن‌ها برای پوشاندن ابرها و دیگر مصنوعات تصویری ناخواسته استفاده کرد. نمونه‌ای از استفاده از این باندها برای پردازش تصاویر Landsat 8 SR و ایجاد یک ترکیب بدون ابر میانه در این پست GIS Stack Exchange ارائه شده است. از همین روش برای ساختن ترکیب بدون ابر برای استفاده در نمونه‌های طبقه‌بندی تحت نظارت در «راهنمای توسعه‌دهنده» استفاده می‌شود.

Is cross-sensor Landsat surface reflectance harmonization needed?

روی و همکاران، 2016 included an analysis of reflectance differences between Landsat 7-8 TOA and surface reflectance. آن‌ها ضرایب OLS و RMA را منتشر کردند تا خوانندگان بتوانند مقادیر بازتاب داده‌های یک حسگر را به حسگر دیگر تبدیل کنند. در خط آخر مقاله آمده است: «اگرچه تفاوت‌های حسگر بسیار کوچک است، اما بسته به کاربرد داده‌های Landsat ممکن است تأثیر قابل‌توجهی داشته باشد.» اما این تحلیل براساس داده‌های پیش‌از جمع‌آوری بود.

بهبودهای ایجادشده درطول پردازش مجدد «مجموعه ۱» و «مجموعه ۲» ممکن است بر رابطه بین حسگرها تأثیر بگذارد، اما تا جایی که می‌دانیم، هیچ تحلیلی مشابه روی و همکاران (۲۰۱۶) برای داده‌های «مجموعه ۱» یا «مجموعه ۲» انجام نشده است. باوجود نبود تجزیه‌وتحلیل رسمی، به‌نظر می‌رسد اجماع عمومی بین کاربران تأثیرگذار Landsat وجود دارد که هیچ اصلاحی برای داده‌های «مجموعه ۲»، «سطح ۲» (بازتاب سطحی) لازم نیست. برای مثال، در پاسخ به پرسشی درباره نیاز به هماهنگ‌سازی «مجموعه ۲، سطح ۲»، مایک وولدر از «تیم علمی لندست» اشاره کرد که بسته به ماهیت کاربرد موردنظر (ازجمله نقشه‌برداری پوشش زمین و تشخیص تغییر)، محصولات بازتاب سطحی «مجموعه ۲» بسیار مناسب و قابل‌اعتماد هستند و نیازی به تنظیم بین‌حسگری ندارند.

چگونه می‌توانم ابرها و سایه‌های ابر را در تصاویر MSS ماسک کنم؟

واحد msslib طرف سوم برای «ویرایشگر کد جاوا اسکریپت» شامل پیاده‌سازی الگوریتم MSScvm و همچنین سایر عملکردهای مفید برای کاوش و آماده‌سازی داده‌های MSS است.

مدیریت داده‌ها

مالک داده‌هایی که بارگذاری می‌کنم کیست؟

طبق شرایط خدمات Earth Engine، مشتریان مالک داده‌هایی هستند که در Earth Engine بارگذاری می‌کنند.

نمی‌توانم داده‌ها را بارگذاری کنم!

وضعیت تکلیف بارگذاری را در پانل «تکالیف» در گوشه بالا سمت چپ ویرایشگر کد بررسی کنید. همچنین می‌توانید صفحه تکلیف اختصاصی را مشاهده کنید.

اگر تکلیفی وجود ندارد، احتمالاً سعی کرده‌اید فایل خود را ازطریق «ویرایشگر کد» بارگذاری کنید، اما به‌دلیل مشکل شبکه، بارگذاری فایل هرگز تکمیل نشده است، بنابراین تکلیف هرگز ایجاد نشده است. از مرورگر یا رایانه دیگری استفاده کنید.

اگر تکلیف ناموفقی وجود دارد، خطایی را که نشان می‌دهد بررسی کنید. اگر پیام خطای خاصی وجود ندارد، ابتدا با اجرای gdalinfo برای فایل‌های شطرنجی یا ogr2ogr برای فایل‌های برداری، بررسی کنید که فایل شما خراب نباشد. این فرمان‌ها سعی می‌کنند همه داده‌ها را از فایل‌های منبع بخوانند و اگر فایل‌ها خراب باشند، خطاها را نمایش دهند.

نمونه فراخوانی gdalinfo:

gdalinfo -mm -stats -checksum file.tif

نمونه فراخوانی ogr2ogr که in.shp را به out.csv تبدیل می‌کند:

ogr2ogr -lco GEOMETRY=AS_WKT -f CSV out.csv in.shp

اگر فایل معتبر به‌نظر می‌رسد، شناسه تکلیف ناموفق را به‌صورت نوشتار (نه به‌صورت نماگرفت) در فهرست پستی توسعه‌دهندگان پست کنید. شناسه تکلیف این قالب را دارد: 4C25GIJBMB52PXTEJTF4JLGL. درصورت امکان، فایل منبع را به‌صورت عمومی قابل‌خواندن کنید. اگر فایل خصوصی است، آن را فقط با earthengine@google.com هم‌رسانی کنید تا تیم Earth Engine بتواند آن را بررسی کند. اگر هم‌رسانی فایل منبع ممکن نیست، حداقل خروجی gdalinfo -mm -stats -checksum را ارائه دهید.

اگر Earth Engine از تصویرسازی خاصی پشتیبانی نکند، باید قبل‌از بارگذاری، داده‌ها را بااستفاده از، برای مثال، gdalwarp دوباره تصویرسازی کنید.

چگونه می‌توانم فایلی را در NetCDF یا قالب شطرنجی پشتیبانی‌نشده دیگری بارگذاری کنم؟

فقط GeoTIFF را می‌توان در Earth Engine بارگذاری کرد. دیگر قالب‌های سازگار با GDAL را می‌توان بااستفاده از gdal_translate به GeoTIFF تبدیل کرد. مثال:

gdal_translate -co COMPRESS=DEFLATE file.nc file.tif

توجه داشته باشید که برخی‌از فایل‌های NetCDF یا HDF از چندین زیرمجموعه داده تشکیل شده‌اند که می‌توان آن‌ها را با gdalinfo پیدا کرد. در این مورد، فرمان gdal_translate به این شکل خواهد بود (به مسیر بین علامت‌های نقل‌قول توجه کنید):

gdal_translate HDF4_EOS:EOS_GRID:"/tmp/MCD12Q1.A2001001.h00v08.005.2011055224312.hdf":MOD12Q1:Land_Cover_Type_1 file.tif

فایل‌های NetCDF گاهی‌اوقات فاقد طرحی هستند که GDAL تشخیص دهد. در این صورت باید تصویر و گستره فضایی را در خط فرمان gdal_translate تنظیم کنید. مثال:

gdal_translate -a_srs EPSG:4326 -a_ullr -180 90 180 -90 file.nc file.tid

از چه الگوریتم‌های فشرده‌سازی‌ای می‌توانم برای GeoTIFFهای بارگذاری‌شده استفاده کنم؟

برای بارگذاری، GeoTIFF را می‌توان با DEFLATE،‏ JPEG،‏ JPEG-XL/JXL،‏ LERC،‏ LERC_DEFLATE،‏ LERC_ZSTD،‏ LZMA،‏ LZW،‏ WEBP، یا ZSTD فشرده کرد. COGs that Earth Engine reads in place (with ee.Image.loadGeoTIFF() or as COG-backed assets) can use DEFLATE, JPEG, LZW, PACKBITS, ZSTD, or no compression (see COG best practices). ZSTD انتخاب کلی خوبی است زیرا سریع از حالت فشرده خارج می‌شود و درعین‌حال فشرده‌سازی خوبی برای اکثر تصاویر ارائه می‌دهد.

برای اعمال فشرده‌سازی ZSTD هنگام استفاده از gdal_translate، این گزینه‌ها را اضافه کنید. اگر داده‌ها مقادیر ممیز شناور دارند، PREDICTOR را به ۳ تغییر دهید. (برای فایل‌هایی که قصد دارید به‌جای بارگذاری، به‌عنوان COG ثبت کنید، راهنمای ثبت COG را ببینید.)

gdal_translate in.tif out.tif \
  -co BIGTIFF=YES \
  -co TILED=YES \
  -co BLOCKXSIZE=512 \
  -co BLOCKYSIZE=512 \
  -co COMPRESS=ZSTD \
  -co PREDICTOR=2 \
  -co ZSTD_LEVEL=16 \
  -co INTERLEAVE=BAND \
  -co NUM_THREADS=ALL_CPUS

دریافت شطرنجی من چند روز است که درحال اجرا است و تمام نشده است.

بااستفاده از gdalinfo، بررسی کنید که آیا فایل شما گزینه GDAL زیر را دارد یا نه: INTERLEAVE=PIXEL. برای فایل‌هایی که این گزینه و باندهای زیادی دارند، ممکن است فرایند انتقال هیچ‌وقت تمام نشود چون چیدمان این فایل‌ها باعث می‌شود خواندن بسیار کند انجام شود.

قبل‌از بارگذاری، این فایل‌ها را به طرح‌بندی باند درهم‌آمیخته تبدیل کنید:

gdal_translate -co "INTERLEAVE=BAND" src.tif dst.tif

این امر برای درون‌گذاری اعمال می‌شود؛ دارایی‌های COG-backed از هر دو درهم‌گذاری پشتیبانی می‌کنند (به فایل‌های تک‌باندی درمقابل چندباندی مراجعه کنید).

شطرنجی‌های بارگذاری‌شده من با نقشه پایه مطابقت ندارد.

اگر داده‌ها کمی از نقشه پایه فاصله داشته باشد، احتمالاً تصویر دارای مبنای نادرستی است (فرض درباره شکل زمین). این اتفاق اغلب با طرح سه‌بعدی سینوسی رخ می‌دهد که نمی‌تواند به‌طور کامل در فراداده GDAL کدبندی شود. وقتی می‌دانید تصویر هدف باید چه باشد (مثلاً SR-ORG:6974 برای فایل‌هایی که از تصویر سینوسی MODIS استفاده می‌کنند)، پرچم --crs را درطول بارگذاری خط فرمان یا فیلد crs مانیفست بارگذاری تنظیم کنید.

اگر داده‌ها به‌شدت تحریف‌شده یا در مکان کاملاً اشتباهی به‌نظر می‌رسند، احتمالاً تبدیل همگرایی یا تصویرسازی اشتباه است.

شطرنجی من فقط در نیم‌کره شرقی نشان داده می‌شود.

احتمالاً شطرنجی جهانی بارگذاری کرده‌اید که محدوده طول جغرافیایی [0, 360] را دربرمی‌گیرد. بااین‌حال، Earth Engine نیاز دارد که شطرنجی‌ها در محدوده [-180, 180] باشند. نیمه‌های چپ و راست شطرنجی را قبل‌از انتقال جابه‌جا کنید. این پیشنهادهای GIS Stack Exchange را ببینید.

چرا تصویر طبقه‌بندی من که وارد شده است لکه‌دار به‌نظر می‌رسد؟

احتمالاً از خط‌مشی هرمی پیش‌فرض MEAN استفاده کرده‌اید. برای تصاویر طبقه‌بندی، باید از خط‌مشی هرمی MODE استفاده شود. برای تصاویر QA/bitmask، باید از خط‌مشی هرمی SAMPLE استفاده شود.

خطای زیر را دریافت می‌کنم: مقدار No data (بدون داده) ‎-۱۲۸.۰ را نمی‌توان روی باند شماره ۰ از نوع Short<0, 255> اعمال کرد.

GDAL نمی‌تواند با باندهای تک‌بایتی به‌عنوان حاوی اعداد صحیح علامت‌دار رفتار کند، بنابراین چنین باندهایی را به‌عنوان اعداد صحیح بدون علامت می‌خواند. این کار با مقادیر منفی بدون داده تداخل دارد.

اگر مقادیر شما درواقع عدد صحیح علامت‌دار است، از بارگذاری مانیفست استفاده کنید و این را به بخش مجموعه کاشی حاوی فایلتان اضافه کنید: data_type: "INT8"

اگر مقادیر شما اعداد صحیح بدون علامت هستند، فایل شما مقدار nodata بدی دارد. می‌توانید آن را هنگام بارگذاری با مقدار داده صحیح (یا مقداری که هرگز رخ نمی‌دهد، درصورت وجود) لغو کنید. همچنین می‌توانید از gdal_translate -a_nodata برای تغییر مقدار nodata یا از gdal_edit.py -unsetnodata برای برداشتن آن استفاده کنید.

چگونه می‌توانم فایلی را در GeoJSON یا قالب برداری پشتیبانی‌نشده دیگری بارگذاری کنم؟

از ogr2ogr برای ترجمه قالب‌های سازگار با OGR به CSV یا SHP استفاده کنید. مثال:

or2ogr -f "ESRI Shapefile" file.shp file.kml

توجه داشته باشید که در بارگذاری‌های CSV، ستون هندسی می‌تواند حاوی GeoJSON باشد.

می‌خواهم بااستفاده از Python داده بارگذاری کنم یا چندین فایل را به‌طور هم‌زمان بارگذاری کنم.

از بارگذاری خط فرمان استفاده کنید. برای چنین بارگذاری‌هایی، فایل‌های منبع باید ابتدا در یک مخزن GCS (Google Cloud Storage) قرار داده شوند. اگر در محدوده سطح رایگان بمانید، استفاده از GCS هزینه‌ای ندارد - صفحه قیمت‌گذاری را ببینید.

می‌خواهم موزاییک شطرنجی بزرگی را که به کاشی‌های زیادی تقسیم شده است بارگذاری کنم.

اگر همه فایل‌ها تصویر و اندازه پیکسل یکسانی دارند، فقط آن‌ها را باهم در یک دارایی بارگذاری کنید — به‌طور خودکار موزاییکی می‌شوند.

اگر فایل‌ها تصویرسازی‌ها یا اندازه‌های پیکسل متفاوتی داشته باشند، نمی‌توان آن‌ها را به‌صورت موزاییکی در یک دارایی شطرنجی واحد قرار داد. به‌جای آن، هر کاشی را به‌عنوان دارایی جداگانه در همان ImageCollection بارگذاری کنید که می‌تواند بااستفاده از ImageCollection.mosaic() موزاییک شود.

می‌خواهم موزاییکی را بارگذاری کنم و خطاهایی درباره کاشی‌های نامطابق دریافت می‌کنم.

کاشی‌های موزاییک‌های شطرنجی Earth Engine باید تصویر و اندازه پیکسل یکسانی داشته باشند. علاوه‌براین، کاشی‌ها باید دقیقاً روی مرزهای پیکسل تراز شوند.

می‌خواهم فایلی را از سطل GCS بارگذاری کنم، اما Earth Engine نمی‌تواند آن را پیدا کند.

ممکن است از «حساب‌های Google» متفاوتی برای بارگذاری GCS و برای متصل شدن به Earth Engine استفاده کرده باشید. مطمئن شوید فایل GCS توسط حسابی که برای اتصال به Earth Engine استفاده می‌کنید قابل‌خواندن باشد. اگر ورود به سیستم چندگانه در مرورگر باعث سردرگمی می‌شود، در پنجره ناشناس مرورگر به Earth Engine متصل شوید.

می‌خواهم دارایی‌های زیادی را به‌طور هم‌زمان صادر کنم.

باید هر تصویر را جداگانه صادر کنید.

می‌خواهم با یک فرمان، Folder یا ImageCollection را جابه‌جا یا حذف کنم.

earthengine rm -r پوشه یا مجموعه و همه موارد موجود در آن را حذف می‌کند، اما هر بار یک دارایی را حذف می‌کند، بنابراین حذف مجموعه بزرگ ممکن است ساعت‌ها طول بکشد. برای سریع‌تر شدن، فرزندان را به‌طور موازی از یک اسکریپت حذف کنید و سپس والد را حذف کنید (به کار با مجموعه‌های بزرگ مراجعه کنید)؛ همین رویکرد برای هر مجموعه یا پوشه مسطح کار می‌کند. پوشه‌ای که حاوی پوشه‌ها یا مجموعه‌های دیگر است باید از پایین به بالا خالی شود، زیرا تا زمانی که محفظه خالی نشود نمی‌توان آن را حذف کرد. برای جابه‌جایی، از mv به همان روش استفاده کنید.

می‌خواهم مستقیماً از خارج از EE به داده‌های Earth Engine دسترسی داشته باشم.

QGIS دارای افزونه Earth Engine است.

GDAL دارای درایور Earth Engine است.

سیستم‌های دیگر می‌توانند از REST API در EE استفاده کنند.

می‌خواهم بخشی از دارایی Earth Engine خود را بدون بازجذب کامل آن به‌روز کنم.

به‌روزرسانی داده‌های شطرنجی یا برداری بارگذاری‌شده در EE امکان‌پذیر نیست. فقط ویژگی‌های فراداده دارایی را می‌توان به‌روزرسانی کرد. استثنا دارایی‌های COG-backed است که می‌توانید با ثبت مجدد آن‌ها با فعال کردن بازنویسی، آن‌ها را به فایل Cloud Storage به‌روزشده ارجاع دهید.

درحال ازدست دادن دسترسی به حسابم هستم. با دارایی‌هایم چه کار کنم؟

اگر خط‌مشی‌های حساب اصلی اجازه انتقال داده را می‌دهد، لطفاً دارایی‌هایتان را با حساب دیگری هم‌رسانی کنید، سپس دارایی‌ها را کپی کنید تا حساب جدید مالک آن‌ها شود. اگر دارایی‌های زیادی برای انتقال وجود دارد، از ابزار کپی خط فرمان استفاده کنید.

اگر حسابی حذف شود، دارایی‌های متعلق به آن دیگر دردسترس نخواهند بود.

تصویر صادرشده من در جای اشتباهی قرار دارد.

برای برخی‌از طرح‌نماها، مانند سینوسی یا مخروطی، فایل‌های GeoTIFF گاهی اوقات نمی‌توانند همه پارامترهای طرح‌نمای لازم را ذخیره کنند. این امر منجر به ایجاد فایل صادرشده‌ای می‌شود که هنگام مشاهده در ابزارهای GIS رایانه یا بازجذب در EE در مکان اشتباهی ظاهر می‌شود.

برای رفع این مشکل، پارامتر صادر کردن crs را مشخص کنید که به‌خوبی با فایل‌های GeoTIFF کار می‌کند—برای مثال، از کد EPSG برای منطقه UTM حاوی منطقه موردعلاقه خود استفاده کنید.

دارایی‌های مجموعه عارضه صادرشده ویژگی‌هایی را که تنظیم کرده‌ام حفظ نمی‌کنند.

هیچ تابع Export.table.* ویژگی‌های سطح جدول را در خروجی حفظ نمی‌کند. برای بسیاری از قالب‌های خروجی (مانند CSV،‏ GeoJSON)، چنین فراداده‌ای پشتیبانی نمی‌شود. تابع Export.table.toAsset می‌تواند از ویژگی‌های سطح جدول پشتیبانی کند، اما درحال‌حاضر این کار را نمی‌کند.

جدول‌هایی که با قالب CSV به Drive صادر می‌شوند به قالب XLSX تبدیل می‌شوند.

بسته به تنظیمات Google Drive شما، جدول‌های CSV که از Earth Engine صادر می‌کنید ممکن است به فایل‌های XLSX تبدیل شوند و تأثیرات ناخواسته‌ای مانند تبدیل نوع داده داشته باشند. برای اصلاح رفتار صادر کردن‌های بعدی، این مراحل را دنبال کنید.

  1. در Google Drive در وب، روی چرخ‌دنده «تنظیمات» در بالا سمت چپ کلیک کنید.
  2. روی «تنظیمات» کلیک کنید.
  3. به «تبدیل فایل‌های بارگذاری‌شده به قالب ویرایشگر سندنگار Google» پیمایش کنید و آن را پاک کنید.

GeoTIFFهای بهینه‌شده ابری (COG)

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

دارایی COG-backed را هم‌رسانی کردم، اما مشارکت‌کنندگان من خطای اجازه دریافت می‌کنند.

دارایی COG-backed اشاره‌گری به فایل‌های موجود در مخزن Cloud Storage شما است، بنابراین مشارکت‌کنندگان به دسترسی خواندن برای هم دارایی Earth Engine و هم مخزن نیاز دارند. در سطل، نقش‌های Storage Object Viewer و Storage Bucket Viewer را به آن‌ها اعطا کنید؛ خطای اجازه در دارایی‌ای که درغیراین‌صورت می‌توانند ببینند معمولاً به‌معنای نبود یکی از این دو است. به پیکربندی اجازه‌ها مراجعه کنید.

از کدام مکان دسته Cloud Storage باید برای ذخیره کردن دارایی‌های COG استفاده کنم؟

فقط چند مکان در ایالات متحده پشتیبانی می‌شود و Earth Engine درخواست‌های ثبت و خواندن را برای گروه‌های ذخیره‌سازی در هر جای دیگری رد می‌کند. مکان‌های دسته پشتیبانی‌شده را ببینید.

فایل COG را در Cloud Storage جایگزین کردم. چرا دارایی بار نمی‌شود یا هنوز داده‌های قدیمی را نشان می‌دهد؟

وقتی COG ثبت می‌کنید، Earth Engine تولید شیء (نسخه) فایل را سنجاق می‌کند، بنابراین رونویسی فایل در محل، دارایی را به‌روز نمی‌کند. دارایی را با همان نام و با فعال کردن رونویسی دوباره ثبت کنید؛ لازم نیست ابتدا آن را حذف کنید. به‌روزرسانی، جایگزینی، و حذف دارایی‌های COG-backed را ببینید.

چگونه می‌توانم بفهمم دارایی COG-backed من به کدام نسخه از فایل اشاره می‌کند؟

فراداده دارایی (ee.data.getAsset()) نسل سنجاق‌شده را به‌عنوان پسوند در URI فایل نشان می‌دهد. تولیدات شیء را ببینید.

اگر فایل COG را در Cloud Storage حذف کنم اما دارایی Earth Engine را حذف نکنم، یا برعکس، چه اتفاقی می‌افتد؟

آن‌ها مستقل هستند. با حذف دارایی Earth Engine، فایل‌هایتان در Cloud Storage دست‌نخورده باقی می‌ماند و با حذف فایل، دارایی در جای خود باقی می‌ماند اما معمولاً پیکسل‌های آن غیرقابل‌خواندن می‌شود. چرخه‌های حیات مستقل را ببینید.

سریع‌ترین راه برای حذف یا جایگزین کردن ImageCollection بزرگ COG-backed چیست؟

در Earth Engine API، حذف دسته‌ای یا بازگشتی وجود ندارد و earthengine rm -r دارایی‌ها را یکی‌یکی حذف می‌کند. اگر تصاویر را جایگزین می‌کنید، آن‌ها را با فعال کردن بازنویسی به‌جای حذف کردن دوباره ثبت کنید؛ اگر حذف می‌کنید، از یک اسکریپت موازی‌سازی کنید. برای رویکرد و اسکریپت، کار با مجموعه‌های بزرگ را ببینید.

چرا ثبت COG من در برگه «تکالیف» نشان داده نمی‌شود؟

ثبت COG یک فراخوانی همگام API است که فقط فراداده فایل را نمایه می‌کند، نه یک کار دریافت دسته‌ای، بنابراین تکلیفی ایجاد نمی‌کند. به‌محض بازگشت تماس، دارایی در برگه دارایی‌ها دردسترس قرار می‌گیرد. ارسال درخواست ثبت‌نام را ببینید.

آیا می‌توانم چند فایل COG را در یک دارایی Earth Engine ترکیب کنم؟

فقط وقتی هر فایل حاوی باندهای مختلفی از یک صحنه باشد: هر فایل را به‌عنوان مجموعه کاشی خودش در مانیفست فهرست کنید و باندها را به مجموعه‌های کاشی نگاشت کنید. نمی‌توانید فایل‌های مجاور فضایی را در یک دارایی با پشتیبانی COG موزاییک کنید؛ هر فایل را به‌عنوان تصویر خودش در ee.ImageCollection ثبت کنید و mosaic() را فراخوانی کنید. محدودیت‌های مانیفست را ببینید.

دارایی‌های COG-backed از کدام طرح‌های فشرده‌سازی، اندازه‌های کاشی، و انواع پیکسل می‌توانند استفاده کنند؟

برای طرح‌های فشرده‌سازی، اندازه‌های کاشی، و انواع داده‌های پیکسلی پشتیبانی‌شده، روال‌های مطلوب برای آماده‌سازی COGهای خارجی را ببینید. فایل‌های با قالب‌های فشرده‌سازی که Earth Engine نمی‌تواند مستقیماً به‌عنوان COG بخواند همچنان می‌توانند به‌عنوان دارایی‌های استاندارد بارگذاری شوند.

خطای «فراداده TIFF در ۱۰۰۰۰۰۰۰ بایت اول خوانده نشد» را دریافت می‌کنم.

Earth Engine هنگام بار کردن یا ثبت کردن فایل فقط ابتدای آن را می‌خواند؛ تصاویر بزرگ با کاشی‌های زیاد و فایل‌های ناقص از این حد فراتر می‌روند. برای اطلاع از محدودیت و نحوه رعایت آن، انتخاب ابعاد فایل را ببینید.

وقتی فایل تغییر می‌کند، ee.Image.loadGeoTIFF() چه تفاوتی با دارایی ثبت‌شده دارد؟

ee.Image.loadGeoTIFF() هر نسخه‌ای از فایل را که در هر درخواست محاسبه یا کاشی نقشه فعلی باشد می‌خواند، بنابراین جایگزین‌ها را انتخاب می‌کند (به‌طور نامساوی در نقشه، زیرا کاشی‌های نقشه رندرشده در حافظه نهان باقی می‌مانند). دارایی ثبت‌شده همیشه نسلی را که با آن ثبت شده است پین می‌کند و برای دیدن فایل جدید باید دوباره ثبت شود، اما درعوض ردپا و فراداده آن نمایه‌سازی می‌شود که باعث می‌شود در مجموعه‌های بزرگ قابل‌استفاده باشد. خواندن COG از Cloud Storage را ببینید.

ویرایشگر کد

نمی‌توانم به سیستم «ویرایشگر کد» وارد شوم زیرا از من می‌خواهد از حساب اشتباهی استفاده کنم.

از سیستم خارج شوید، حسابی را که برای استفاده از Earth Engine ثبت شده است در صفحه «انتخاب حساب» انتخاب کنید، و سپس همان حساب را در صفحه دوم «انتخاب حساب برای ادامه دادن به ویرایشگر کد Earth Engine» (عبارت دقیق ممکن است متفاوت باشد) دوباره انتخاب کنید.

می‌خواهم از نقشه جهانی نماگرفت بگیرم، اما تصویر مرکاتور وب را دوست ندارم.

تصویر نقشه استفاده‌شده در «ویرایشگر کد» Web Mercator ('EPSG:3857') است. این تصویرسازی اندازه اشیاء را با دور شدن از خط استوا بزرگ‌تر می‌کند و باعث می‌شود مناطق با عرض جغرافیایی بالا در مقایسه با مناطق نزدیک به خط استوا بسیار بزرگ‌تر از آنچه واقعاً هستند به‌نظر برسند. نمی‌توانید تصویرسازی بوم نقشه «ویرایشگر کد» را تغییر دهید، اما می‌توانید بااستفاده از روش ee.Image.changeProj، تصویری را در تصویرسازی موردنظرتان روی بوم «مرکاتور وب» «رنگ‌آمیزی» کنید. برای مشاهده نمونه‌ای از نمایش DEM جهانی در نقشه «ویرایشگر کد» در تصویر رابینسون، صفحه مرجع میانای برنامه‌سازی کاربردی روش را ببینید. توجه داشته باشید که این تکنیک فقط باید برای اهداف تجسم استفاده شود، زیرا ابزارهای بازرس و طراحی Code Editor همچنان در Web Mercator کار می‌کنند.

متن من ذخیره نمی‌شود (Script error: Unknown commit).

اگر هنگام ذخیره کردن اسکریپت پیام Script error: Unknown commit دریافت کردید، احتمالاً به این معنی است که مخزنی که در آن ذخیره می‌کنید همگام‌سازی نشده است. علت این وضعیت متغیر است و به‌سختی می‌توان آن را شناسایی کرد. برای حل مشکل، فهرست اسکریپت را بااستفاده از دکمه گوشه بالا سمت چپ برگه «اسکریپت» بازآوری کنید. اگر مشکل برطرف نشد، سعی کنید مخزن جدیدی از دکمه «جدید» در برگه «اسکریپت» ایجاد کنید و اسکریپتتان را در آنجا ذخیره کنید (شاید لازم باشد اسکریپت‌ها را از مخزن همگام‌سازی‌نشده به مخزن جدید منتقل کنید).

چرا خطاهای ۴۰۰ تکراری در «ویرایشگر کد» می‌بینم؟

اگر خطاهای ۴۰۰ تکراری در «ویرایشگر کد» می‌بینید، به https://myaccount.google.com/connections بروید، «ویرایشگر کد Earth Engine» را در فهرست برنامه‌ها و سرویس‌ها پیدا کنید، آن را انتخاب کنید، و سپس «حذف همه اتصال‌هایی که با ویرایشگر کد Earth Engine دارید» را انتخاب کنید و تأیید کنید. سپس «ویرایشگر کد» را باز کنید و دوباره اصالت‌سنجی کنید.

چگونه پوشه‌ها و اسکریپت‌های حذف‌شده را بازیابی کنم؟

اگر به‌طور تصادفی یک اسکریپت یا پوشه را در یک مخزن موجود حذف کنید، سابقه کامل ثبت در گزارش‌های Git در سرورهای ما حفظ می‌شود. می‌توانید پوشه‌ها یا اسکریپت‌های حذف‌شده را با شبیه‌سازی کردن مخزن به‌صورت محلی بااستفاده از ابزارهای خط فرمان استاندارد Git بازیابی کنید.

بااین‌حال، حذف کل مخزن (users/username/repository) مخزن و سابقه ثبت آن را برای همیشه از earthengine.googlesource.com برمی‌دارد و نمی‌توان آن را واگرد یا بازیابی کرد.

برای دستورالعمل‌های گام‌به‌گام درباره تولید اطلاعات کاربری Git، شبیه‌سازی مخزن، و بازیابی فایل‌ها یا پوشه‌های حذف‌شده، به راهنمای بازیابی اسکریپت و انتقال مخزن مراجعه کنید.

چگونه می‌توانم نام ریشه مخزن اسکریپت خود را تغییر دهم؟

دایرکتوری ریشه اسکریپت شما (users/username) به ثبت حساب Earth Engine اصلی شما محدود شده است. نمی‌توان نام آن را مستقیماً در پس‌بک تغییر داد زیرا انجام این کار باعث می‌شود هرگونه اسکریپت خارجی یا پروژه مشارکتی که کد مدولار شما را بااستفاده از مسیر require('users/username/repository:...') وارد می‌کند خراب شود.

اگر به فضای نام جدیدی نیاز دارید، راه حل پشتیبانی‌شده این است که کارتان را به حساب جدیدی منتقل کنید:

  1. بااستفاده از هویت Google جدیدتان، حساب Earth Engine جدیدی ثبت کنید (که ریشه users/new_username تمیزی ایجاد می‌کند).
  2. دستورالعمل‌های انتقال مخزن را دنبال کنید تا مخزن قدیمی‌تان را شبیه‌سازی کنید و سابقه کامل آن را به مخزن خالی جدید ارسال کنید.

ملاحظات مهم:

  • ماژول‌های عمومی: اگر ماژول‌های عمومی دارید که دیگران به آن‌ها متکی هستند، اکیداً توصیه می‌کنیم حساب و مخزن قدیمی‌تان را فعال نگه دارید تا گردش کار آن‌ها را مختل نکنید.
  • اسکریپت‌های خصوصی: اگر اسکریپت‌های شما کاملاً خصوصی هستند، می‌توانید عبارت‌های وارد کردن require() خود را به‌روز کنید تا به مسیر مخزن جدید ارجاع دهند و سپس مخازن قدیمی را به‌طور ایمن حذف کنید.