تصدير مربّعات الخريطة

للحصول على معلومات حول التصدير إلى تنسيقات أخرى، بما في ذلك الصور والفيديوهات والجداول (بيانات المتجهات)، يُرجى الاطّلاع على تصدير البيانات.

نظرة عامة

لعرض بيانات الصور (البيانات النقطية) على خريطة على الإنترنت، يمكنك تصدير مربّعات الخريطة باستخدام Export.map.toCloudStorage(). تصدِّر هذه الدالة هرمًا من مربّعات الخريطة إلى حزمة Cloud Storage، حيث يمكن عرضها بشكل علني أو خاص. ويكون مفيدًا عندما تكون بيانات الصورة كبيرة جدًا بحيث لا يمكن تراكبها كصورة واحدة. تستخدم هذه المربّعات إحداثيات مربّعات "خرائط Google" وهي مناسبة للعرض باستخدام "منصة خرائط Google" (واجهات برمجة تطبيقات "خرائط Google") وGoogle Earth للويب ومنصات الخرائط الأخرى. ويمكن معاينة المربّعات بسهولة في "خرائط Google" أو Google Earth باستخدام ملفات HTML المقدَّمة كجزء من عملية التصدير.

هناك عدد من الإعدادات والخطوات الخاصة بالتصدير، والتي قد تكون أو لا تكون ضرورية، اعتمادًا على الطريقة التي تخطط بها لاستخدام المربعات أو نشرها. تتطلّب بعض منصات الخرائط أن تكون المربّعات متاحة للجميع، بينما يمكن استخدام المربّعات الخاصة في بعض المنصات الأخرى. في حال استخدام إحدى واجهات برمجة التطبيقات في "خرائط Google"، ستحتاج على الأرجح إلى مفتاح واجهة برمجة تطبيقات في "منصة خرائط Google". إذا كنت تعرض مربّعات على Google Earth أو منصات خرائط أخرى، ستحتاج على الأرجح إلى ضبط خيارات "مستوى الوصول" و"الوصول إلى JS" (CORS) المناسبة، استنادًا إلى الطريقة التي تخطّط لاستخدام المربّعات بها. يُرجى الاطّلاع على قسم الإرشادات الخاصة بالمنصة أدناه لمعرفة الإعدادات المطلوبة.

تصدير مربّعات الخريطة إلى Cloud Storage

يصدِّر المثال التالي مربّعات من صورة Landsat لمنطقة في كاليفورنيا.

أداة تعديل الرموز (JavaScript)

// --- Example Export Map Tiles - basic ---
// Specify area to clip/export, setup image and preview on map.
var exportRegion = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2);
var landsatImage = ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111')
  .select(['B4', 'B3', 'B2'])
  .visualize({min: 0.02, max: 0.4, gamma: 1.2})
  .clip(exportRegion);
Map.addLayer(landsatImage, {}, 'landsatImage');
Map.centerObject(exportRegion);

// Set up Export task.
Export.map.toCloudStorage({
  image: landsatImage,
  description: 'mapTilesForEE',
  bucket: 'yourBucketName',  // replace with your GCS bucket name
  fileFormat: 'auto',
  maxZoom: 13,
  region: exportRegion,
  writePublicTiles: true
});

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# --- Example Export Map Tiles - basic ---
# Specify area to clip/export, setup image and preview on map.
export_region = ee.Geometry.BBox(-122.9, 37.1, -121.2, 38.2)
landsat_image = (
    ee.Image('LANDSAT/LC09/C02/T1_TOA/LC09_044034_20220111')
    .select(['B4', 'B3', 'B2'])
    .visualize(min=0.02, max=0.4, gamma=1.2)
    .clip(export_region)
)
m = geemap.Map()
m.add_layer(landsat_image, {}, 'landsatImage')
m.center_object(export_region)
display(m)

# Set up Export task.
task = ee.batch.Export.map.toCloudStorage(
    image=landsat_image,
    description='mapTilesForEE',
    bucket='yourBucketName',  # replace with your GCS bucket name
    fileFormat='auto',
    maxZoom=13,
    region=export_region,
    writePublicTiles=True,
)
task.start()

يُرجى العِلم أنّ هذا الإجراء يؤدي إلى إنشاء دليل جديد في حزمة Cloud Storage المحدّدة، ويتم تسميته وفقًا للمَعلمة description تلقائيًا. يمكنك تغيير اسم الدليل أو تحديد أدلة فرعية باستخدام المَعلمة path. يمكنك استخدام ملفَي index.html وearth.html في دليل الإخراج لمعاينة المربّعات في "خرائط Google" أو Google Earth.

خيارات قوائم التحكّم بالوصول (ACL) ومشاركة الموارد المتعدّدة المصادر (CORS)

يضبط المثال أعلاه قوائم التحكّم بالوصول (ACL) الخاصة بالمربّعات لجعلها متاحة للجميع من خلال طلب مباشر، ولكنّه لا يضبط إعدادات الوصول إلى JS في الحزمة (إعدادات CORS) للسماح لتطبيقات الويب بالوصول إليها. هذا يعني أنّه يمكن عرض هذه المربّعات التي تم تصديرها في معاينات الخرائط وEarth، ولكنّها لن تكون مفيدة للمنصات الأخرى التي تتطلّب الوصول إلى JS. يُفترض أنّك مالك حزمة الإخراج. إذا كنت كاتبًا في حزمة الإخراج المحدّدة (ولست المالك)، اضبط writePublicTiles على false لاستخدام قائمة التحكّم بالوصول التلقائية إلى العناصر في حزمة الإخراج.

إذا أردت إتاحة المربّعات للوصول العام من خلال جميع تطبيقات الويب، أضِف bucketCorsUris: ['*'] إلى مَعلمات المهمة. يُرجى العِلم أنّ إتاحة الوصول إلى JavaScript بشكل علني بالكامل قد لا يكون مرغوبًا فيه عندما يكون هناك خطر من استخدام جهات خارجية للمربّعات وتحمُّل تكاليف السحابة الإلكترونية. للحدّ من ذلك، يمكنك حصر إمكانية الوصول إلى JS على تطبيقات الويب في نطاقات أو عناوين URL محدّدة فقط. يُرجى العِلم أنّه يتم تطبيق إعدادات الوصول إلى JS (CORS) على مستوى الحزمة بالكامل، وليس على مستوى المجلد أو العنصر.

يمكن ضبط قوائم التحكّم بالوصول (ACL) ومشاركة الموارد المتعدّدة المصادر (CORS) باستخدام المَعلمتَين writePublicTiles وbucketCorsUris على التوالي، أو من مربّع حوار مهمة التصدير كما هو موضّح أدناه:

مربّع حوار Export.map
مربّع حوار مهمة "Export.map.toCloudStorage()"
  • إذن العرض/التنزيل: إذا أردت الوصول إلى المربّعات (مثلاً من "أداة تعديل الرموز" أو "تطبيقات Earth Engine")، عليك ضبطها على "متاحة للجميع".
  • الوصول إلى JS يجب أن يسمح المستودع الذي يتم تصدير الخريطة إليه بإمكانية القراءة إذا كنت تريد أن تتمكّن "أداة تعديل الرموز" أو "تطبيقات Earth Engine" أو تطبيقات الويب الأخرى من الوصول إلى المربّعات. يجب ضبط إعدادات الطلبات من مصدر خارجي (CORS) هذه على مستوى الحزمة. لتسهيل الأمر، يتيح لك مربّع حوار التصدير في Earth Engine ضبط إعدادات CORS لحزمتك في وقت التصدير.
  • ملاحظة: يتم تطبيق إعدادات الوصول إلى JS / CORS على مستوى الحزمة، وليس على مستوى المجلد أو العنصر، لذا فإن تغيير الإعدادات سيؤدي إلى تعديلها لجميع المجلدات والعناصر في الحزمة. يمكنك الاطّلاع على مزيد من المعلومات في مستندات سياسة مشاركة الموارد المتعدّدة المصادر (CORS) في Cloud Storage، بما في ذلك كيفية عرض إعدادات سياسة مشاركة الموارد المتعدّدة المصادر (CORS) الحالية لحزمة معيّنة.

قائمة المَعلمات

في ما يلي قائمة بجميع مَعلمات مهمة تصدير مربّعات الخريطة، مع عرض اسم المَعلمة (الوسيطة) في الرمز البرمجي، والحقل المقابل في مربّع حوار المهمة (إذا كان ذلك منطبقًا). يُرجى العِلم أنّ بعض الحقول يستبعد بعضها بعضًا (مثل maxzoom وscale). لمزيد من التفاصيل، يمكنك الاطّلاع على مستندات Export.map .

الوسيطة في الرمز البرمجي حقل في مربّع حوار المهمة ملاحظات
الصورة timing fixed in amara الصورة المطلوب تصديرها كمربّعات يجب أن تكون صورة، وليس مجموعة صور (ImageCollection).
الوصف اسم المهمة اسم المهمة الذي يمكن لشخص عادي قراءته القيمة التلقائية هي "myExportMapTask". يُستخدم هذا أيضًا كاسم مجلد للمربّعات، إذا لم يتم تحديد مَعلمة "path" (بادئة الإخراج).
دلو اسم حزمة GCS مجموعة البيانات الوجهة التي تريد الكتابة إليها
fileFormat تنسيق الملف تنسيق ملف مربّعات الخريطة، وهو أحد التنسيقات التالية: "auto" أو "png" أو "jpg". يتم ضبطه تلقائيًا على "تلقائي"، ما يعني أنّه سيتم ترميز المربّعات غير الشفافة على أنّها "jpg" وسيتم ترميز المربّعات الشفافة على أنّها "png".
المسار بادئة النتائج السلسلة المستخدَمة كمسار للناتج يُعدّ استخدام الشرطة المائلة "/" في نهاية عنوان URL اختياريًا. يتم ضبطه تلقائيًا على وصف المهمة (اسم المهمة)
writePublicTiles مستوى الوصول للعرض/التنزيل ما إذا كان سيتم كتابة مربّعات علنية بدلاً من استخدام قائمة التحكّم بالوصول (ACL) التلقائية إلى العناصر في الحزمة يتم ضبط القيمة التلقائية على "صحيح"، ويتم ضبط المستدعي على "مالك" الحزمة.
maxZoom أقصى دقة وأقصى تكبير الحد الأقصى لمستوى التكبير في مربّعات الخريطة المطلوب تصديرها
تحجيم الحد الأقصى للدقة والحد الأقصى للمقياس الحد الأقصى لدقة الصورة بالمتر لكل بكسل، كبديل عن "maxZoom" سيتم تحويل المقياس إلى مستوى التكبير الأقصى الأكثر ملاءمةً عند خط الاستواء.
minZoom الحد الأقصى للدقة والحد الأدنى للتكبير الحد الأدنى الاختياري لمستوى التكبير في مربّعات الخريطة المطلوب تصديرها وتكون القيم التلقائية صفرًا.
المنطقة timing fixed in amara تمثّل هذه السمة LinearRing أو مضلّعًا أو إحداثيات تمثّل المنطقة المطلوب تصديرها. يُرجى الاطّلاع على المستندات لمزيد من التفاصيل.
skipEmptyTiles timing fixed in amara إذا كانت القيمة صحيحة، يتم تخطّي كتابة مربّعات الخريطة الفارغة (أي الشفافة بالكامل). الخيار التلقائي هو "خطأ".
mapsApiKey مفتاح Maps API يُستخدَم في index.html لإعداد Google Maps API. يؤدي ذلك إلى إزالة رسالة "لأغراض التطوير فقط" من الخريطة.
bucketCorsUris إضافة إذن الوصول إلى JS (والموقع الإلكتروني المسموح به) قائمة بالنطاقات (مثل https://code.earthengine.google.com) التي يُسمح لها باسترداد المربّعات التي تم تصديرها عبر JavaScript (CORS).

تغيير الحجم والتكبير/التصغير

في المثال السابق، تم ضبط maxZoom على 13. تتوافق مستويات التكبير مع شبكات وحدات بكسل مختلفة الأحجام يتم من خلالها عرض خريطة عالمية. (لمزيد من التفاصيل، يُرجى الاطّلاع على مرجع إحداثيات البكسل ). بسبب انحناء الأرض، تختلف درجة دقة وحدات البكسل عند مستوى تكبير معيّن حسب خط العرض. وعلى وجه التحديد، ينخفض عدد الأمتار لكل بكسل بمقدار cos(latitude). يعرض الجدول التالي الأمتار لكل بكسل، عند كل مستوى تكبير، عند خط الاستواء لإسقاط ميركاتور من Google:

مستوى التكبير أو التصغير حجم البكسل (عند خط الاستواء) مستوى التكبير أو التصغير حجم البكسل (عند خط الاستواء)
0 ‫156 كلم 10 ‫152 متر
1 ‫78 كلم 11 ‫76 متر
2 ‫39 كم 12 ‫38 متر
3 ‫20 كم 13 ‫19 متر
4 ‫10 كم 14 ‫9.6 متر
5 ‫4.9 كلم 15 ‫4.8 مليون
6 ‫2.4 كلم 16 ‫2.4 متر
7 ‫1.2 كلم 17 ‫1.2 م
8 ‫611 متر 18 ‫0.6 متر
9 ‫305 متر 19 ‫0.3 متر
20 ‫0.15 متر

لاحظ من الجدول السابق أن maxZoom المحددة في المثال تتوافق مع 19 مترًا عند خط الاستواء، وأصغر عند خطوط العرض الأعلى. وهذا أقل من الدقة الاسمية التي تبلغ 30 ثانية قوسية لكل بكسل لصورة الإدخال. ونتيجةً لذلك، يمكن تكبير الخريطة المعروضة في ملف الإخراج index.html إلى أن تصبح وحدات البكسل بالدقة الأصلية مرئية في الخريطة. لتقييد عرض الخريطة على دقة البكسل الأصلية، اضبط maxZoom على قيمة تتوافق مع الدقة الأصلية أو أقل.



الإرشادات الخاصة بالمنصة

في ما يلي عدد من المنصات التي قد تحتاج فيها إلى عرض مربّعات الخريطة واستخدامها. يشير كل قسم إلى الإعدادات المطلوبة لكي تعمل المربّعات مع تلك المنصة، ونسخة من نموذج الرمز البرمجي مع المَعلمات اللازمة.

استخدام مربّعات الخريطة في Earth Engine (أداة تعديل الرموز أو تطبيقات EE)

إذا أردت تصدير مربّعات الخريطة فقط لإعادة استخدامها في Google Earth Engine أو تطبيقات EE، اضبط "مستوى الوصول" على "متاح للجميع"، واضبط "مستوى الوصول إلى JS" (في مربّع حوار المهمة) على "إضافة إمكانية الوصول إلى Earth Engine" أو "إضافة إمكانية الوصول العلني". بدلاً من ذلك، يمكنك ضبط هذه المَعلمات في الرمز:

writePublicTiles: true,
bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app']

بعد تصدير المربّعات، ستصبح متاحة في Earth Engine.

أداة تعديل الرموز (JavaScript)

// --- Export Map Tiles for use in EE ---
// Use image setup code from example at top of the page.
// Set up Export task.
Export.map.toCloudStorage({
  image: landsatImage,
  description: 'mapTilesForEE',
  bucket: 'yourBucketName',  // replace with your GCS bucket name
  fileFormat: 'auto',
  maxZoom: 13,
  region: exportRegion,
  writePublicTiles: true,
  bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app']
});

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# --- Export Map Tiles for use in EE ---
# Use image setup code from example at top of the page.
# Set up Export task.
task = ee.batch.Export.map.toCloudStorage(
    image=landsat_image,
    description='mapTilesForEE',
    bucket='yourBucketName',  # replace with your GCS bucket name
    fileFormat='auto',
    maxZoom=13,
    region=export_region,
    writePublicTiles=True,
    bucketCorsUris=[
        'https://code.earthengine.google.com',
        'https://*.earthengine.app',
    ],
)
task.start()

الاطّلاع على نسخة تجريبية من "خرائط Google"

لمعاينة مربّعات الخريطة على "خرائط Google"، انتقِل إلى مجلد الإخراج في Google Cloud Storage، وافتح ملف "index.html" في المتصفّح. سيؤدي ذلك إلى فتح خريطة بملء الصفحة تعرض المربّعات على "خرائط Google" باستخدام Javascript API في "منصة خرائط Google"، مثل: index.html. ستؤدي عملية التصدير الأساسية إلى ظهور مربّعات خريطة أساسية باللون الرمادي وعليها علامة مائية "لأغراض التطوير فقط". لتجنُّب ذلك وعرض مربّعات الخريطة الأساسية العادية من Google، يمكنك إنشاء مفتاح واجهة برمجة تطبيقات وتضمينه في إعدادات التصدير.

إذا قدّمت مفتاح واجهة برمجة التطبيقات في وقت التصدير، ستكون صفحة المعاينة هذه قابلة للعرض بشكل علني، ويمكن تضمينها في صفحات أخرى، ولا تتطلّب أن يكون المشاهد مستخدمًا مسجَّلاً في Earth Engine.

أداة تعديل الرموز (JavaScript)

// --- Export Map Tiles for use with Map Preview ---
// Use image setup code from example at top of the page.
// Set up Export task.
Export.map.toCloudStorage({
  image: landsatImage,
  description: 'mapTilesForMapPreview',
  bucket: 'yourBucketName',  // replace with your GCS bucket name
  fileFormat: 'auto',
  maxZoom: 13,
  region: exportRegion,
  writePublicTiles: true,
  mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key
});

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# --- Export Map Tiles for use with Map Preview ---
# Use image setup code from example at top of the page.
# Set up Export task.
task = ee.batch.Export.map.toCloudStorage(
    image=landsat_image,
    description='mapTilesForMapPreview',
    bucket='yourBucketName',  # replace with your GCS bucket name
    fileFormat='auto',
    maxZoom=13,
    region=export_region,
    writePublicTiles=True,
    mapsApiKey='fakeMapsApiKey012345',  # replace with a valid API Key
)
task.start()

الاطّلاع على معاينة Google Earth

لمعاينة مربّعات الخريطة في Google Earth على الويب، تأكَّد من تصدير المربّعات مع ضبط مستوى الوصول على "متاحة للجميع". بعد ذلك، انتقِل إلى مجلد الإخراج على Google Cloud Storage، وافتح ملف "earth.html" في المتصفّح، مثل هذا الملف: earth.html ، وانقر على الزر "فتح في Google Earth" الذي يظهر. سيؤدي ذلك إلى فتح Google Earth وعرض مربّعاتك على الخريطة الثلاثية الأبعاد. من أفضل الممارسات أيضًا ضبط مستوى "الوصول إلى JS" على "متاح للجميع"، ما يتيح لك استخدام المربّعات في Google Earth بدون ملف المعاينة (الذي يستخدم خادمًا وكيلاً إذا لم تكن المربّعات تتضمّن إعدادات "الوصول إلى JS" أو CORS اللازمة).

لتنزيل ملف KML يحتوي على رابط لبياناتك، انقر على قائمة النقاط الثلاث في Google Earth واختَر "التصدير كملف KML". ملاحظة: ملف KML الذي يتم إنشاؤه بهذه الطريقة غير متوافق مع Google Earth Pro (إصدار Google Earth المخصّص لأجهزة الكمبيوتر).

أداة تعديل الرموز (JavaScript)

// --- Export Map Tiles for use with Earth Preview ---
// Use image setup code from example at top of the page.
// Set up Export task.
Export.map.toCloudStorage({
  image: landsatImage,
  description: 'mapTilesForEarthPreview',
  bucket: 'yourBucketName',  // replace with your GCS bucket name
  fileFormat: 'auto',
  maxZoom: 13,
  region: exportRegion,
  writePublicTiles: true,
  bucketCorsUris: []  // leaving blank is ok for Earth Preview only
  // for direct use in Earth, set to: ['https://earth.google.com']
  // or set to public: ['*'] (risk of misuse)
});

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# --- Export Map Tiles for use with Earth Preview ---
# Use image setup code from example at top of the page.
# Set up Export task.
task = ee.batch.Export.map.toCloudStorage(
    image=landsat_image,
    description='mapTilesForEarthPreview',
    bucket='yourBucketName',  # replace with your GCS bucket name
    fileFormat='auto',
    maxZoom=13,
    region=export_region,
    writePublicTiles=True,
    bucketCorsUris=[],  # leaving blank is ok for Earth Preview only
    # for direct use in Earth, set to: ['https://earth.google.com']
    # or set to public: ['*'] (risk of misuse)
)
task.start()

النشر باستخدام "منصة خرائط Google"‏ (Maps API)

لإنشاء مجموعة من مربّعات الخريطة الجاهزة للنشر بشكل علني من خلال "منصة خرائط Google"، يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات أو أن تنشئ مفتاحًا، وأن تتأكّد من ضبط مستوى الوصول على "متاح للجميع". استنادًا إلى كيفية وصول تطبيق Maps API إلى المربّعات، قد تحتاج أيضًا إلى ضبط "مستوى وصول JS" مناسب لموقعك الإلكتروني. بعد تصدير المربّعات، يوفّر الناتج في علامة التبويب "المهام" في أداة تعديل الرموز عنوان URL للمربّعات مع المتغيّرات المناسبة للاستخدام مع Google Maps API، على سبيل المثال: https://storage.googleapis.com/my_bucket/my_test_tiles/{Z}/{X}/{Y}

أداة تعديل الرموز (JavaScript)

// --- Export Map Tiles for use with Maps Platform APIs ---
// Use image setup code from example at top of the page.
// Set up Export task.
Export.map.toCloudStorage({
  image: landsatImage,
  description: 'mapTilesForMapsPlatform',
  bucket: 'yourBucketName',  // replace with your GCS bucket name
  fileFormat: 'auto',
  maxZoom: 13,
  region: exportRegion,
  writePublicTiles: true,
  bucketCorsUris: ['*'],  // '*' = All domains = risk of misuse
  // For better protection, specify the domain(s) where the
  // tiles will be used, eg: ['https://mysite.mydomain.com']
  mapsApiKey: 'fakeMapsApiKey012345' // replace with a valid API Key
});

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# --- Export Map Tiles for use with Maps Platform APIs ---
# Use image setup code from example at top of the page.
# Set up Export task.
task = ee.batch.Export.map.toCloudStorage(
    image=landsat_image,
    description='mapTilesForMapsPlatform',
    bucket='yourBucketName',  # replace with your GCS bucket name
    fileFormat='auto',
    maxZoom=13,
    region=export_region,
    writePublicTiles=True,
    bucketCorsUris=['*'],  # '*' = All domains = risk of misuse
    # For better protection, specify the domain(s) where the
    # tiles will be used, eg: ['https://mysite.mydomain.com']
    mapsApiKey='fakeMapsApiKey012345',  # replace with a valid API Key
)
task.start()

النشر على Google Earth (على الويب)

لإنشاء مجموعة من مربّعات الخريطة لنشرها بشكل علني من خلال Google Earth، عليك ضبط "مستوى الوصول" على "متاح للجميع" وضبط "مستوى الوصول إلى JS" للسماح بـ "https://earth.google.com" (أو "متاح للجميع"). بعد التصدير، يمكنك معاينتها في Google Earth باستخدام ملف earth.html في دليل التصدير (انظر أعلاه).

أداة تعديل الرموز (JavaScript)

// --- Export Map Tiles for use with Google Earth web ---
// Use image setup code from example at top of the page.
// Set up Export task.
Export.map.toCloudStorage({
  image: landsatImage,
  description: 'mapTilesForEarthWeb',
  bucket: 'yourBucketName',  // replace with your GCS bucket name
  fileFormat: 'auto',
  maxZoom: 13,
  region: exportRegion,
  writePublicTiles: true,
  bucketCorsUris: ['https://earth.google.com']
  // ['*'] will also work, but risks misuse
});

إعداد Python

يُرجى الاطّلاع على صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# --- Export Map Tiles for use with Google Earth web ---
# Use image setup code from example at top of the page.
# Set up Export task.
task = ee.batch.Export.map.toCloudStorage(
    image=landsat_image,
    description='mapTilesForEarthWeb',
    bucket='yourBucketName',  # replace with your GCS bucket name
    fileFormat='auto',
    maxZoom=13,
    region=export_region,
    writePublicTiles=True,
    bucketCorsUris=['https://earth.google.com'],
    # ['*'] will also work, but risks misuse
)
task.start()

بعد تصدير المربّعات، يمكنك إضافتها إلى مشروع في إصدار الويب من Google Earth. توفّر المخرجات في علامة التبويب "المهام" (Tasks) في أداة تعديل الرموز (الموضّحة أدناه) عنوان URL للمربّعات مع المتغيّرات المناسبة للاستخدام في Google Earth، على سبيل المثال: https://storage.googleapis.com/my_bucket/my_test_tiles/$[level]/$[x]/$[y]

عناوين URL الناتجة من مهمة تصدير المربّعات
عناوين URL الناتجة من مهمة تصدير المربّعات

لاستخدام هذه الميزة في إصدار الويب من Google Earth، أنشئ ميزة "تراكب المربّعات" وأضِف عنوان URL هذا كـ "عنوان URL للتراكب". إذا لم تكن مجموعة البيانات عالمية وأردت تجنُّب أخطاء طلبات المربّعات غير المتوفّرة، تأكَّد من فتح قسم "خيارات التراكب" وضبط مَعلمات "تغطية المربّعات" الأربع لتتطابق مع نطاقات المربّعات التي تم تصديرها.

مربّعات الخريطة المعروضة في إصدار الويب من Google Earth
مربّعات الخريطة المعروضة في إصدار الويب من Google Earth

النشر على منصات خرائط أخرى

عند تصدير المربّعات لاستخدامها مع منصات أو تطبيقات أخرى، ستعتمد الإعدادات اللازمة على كيفية وصولها إلى المربّعات. لإتاحة الوصول إلى المربّعات على أوسع نطاق ممكن، اضبط "مستوى الوصول" على "متاح للجميع"، واضبط "مستوى الوصول إلى JS" على "متاح للجميع".



إنشاء مفتاح واجهة برمجة تطبيقات في "منصة خرائط Google"

إذا كنت تخطّط لاستخدام مربّعات الخريطة مع "منصة خرائط Google"، أو أردت معاينتها على "خرائط Google" بدون الخريطة الأساسية المخصّصة للمطوّرين، ستحتاج إلى الحصول على مفتاح واجهة برمجة تطبيقات "منصة خرائط Google" أو إنشائه، وإما تضمينه في إعدادات التصدير أو إضافته إلى المواقع الإلكترونية بعد ذلك. وهذا ليس ضروريًا للاستخدام مع Google Earth.

عند تصدير مربّعات الخريطة من Earth Engine، ننشئ نموذج صفحة HTML مخزَّن في دليل الإخراج لكي تتمكّن من معاينة المربّعات باستخدام واجهة برمجة التطبيقات JavaScript في "منصة خرائط Google". يمكنك اختياريًا تقديم مفتاح واجهة برمجة تطبيقات "منصة خرائط Google" في وقت التصدير، وسيتم استخدامه لطلبات البيانات من واجهة برمجة التطبيقات في عارض النماذج.

لإنشاء مفتاح واجهة برمجة تطبيقات في "منصة خرائط Google" الآن، اتّبِع الخطوات الأربع التالية:

  • انقر على الزر "إنشاء مفتاح واجهة برمجة تطبيقات لمنصة خرائط Google" أدناه.
  • اختَر مشروعًا على السحابة الإلكترونية لمفتاح واجهة برمجة التطبيقات، ثم انقر على "التالي".
  • انقر على لنسخ المفتاح الجديد، والصِقه في مربّع حوار "تصدير الخريطة" في "أداة تعديل الرموز".
  • (إجراء يُنصح به) انقر على رابط API Console تحت المفتاح الجديد لضبط قيود المُحيل. يمكنك الاطّلاع على القيود المفروضة على المُحيل والتطبيق لمزيد من التفاصيل.

إنشاء مفتاح واجهة برمجة تطبيقات "منصة خرائط Google"

يُرجى إدخال اسم المشروع المفتاح جاهز

إضافة قيود على المُحيل إلى مفتاح واجهة برمجة التطبيقات

عند إضافة مفتاح واجهة برمجة التطبيقات، تضمن قيود المُحيل أنّه لا يمكن إلا للتطبيقات المحدّدة استخدام مفتاحك. يمكنك ضبط قيود المُحيل أو تعديلها في أي وقت من خلال الانتقال إلى صفحة بيانات الاعتماد في Cloud Console واتّباع الخطوات التالية:

  • تأكَّد من اختيار اسم المشروع الصحيح في القائمة المنسدلة في أعلى الشاشة.
  • انقر على مفتاح واجهة برمجة التطبيقات في "منصة خرائط Google" الذي تم إنشاؤه أعلاه لعرض تفاصيل المفتاح.
  • اختَر مُحيلو HTTP (المواقع الإلكترونية)، وحدِّد حزمة Cloud Storage المحدّدة في Export.map.toCloudStorage باستخدام النموذج التالي: https://storage.googleapis.com/{bucket}/*
  • انقر على "حفظ". من المفترض أن يظهر المؤشر "جارٍ الحفظ...".
إضافة المُحيلين