ייצוא של משבצות מפה

במאמר ייצוא נתונים מוסבר איך לייצא לפורמטים אחרים, כולל תמונות, סרטונים וטבלאות (נתונים וקטוריים).

סקירה כללית

כדי להציג נתוני תמונה (נתוני רסטר) במפה אונליין, אפשר לייצא משבצות מפה באמצעות Export.map.toCloudStorage(). הפונקציה הזו מייצאת פירמידה של משבצות מפה לקטגוריה של Cloud Storage, ומשם אפשר להציג אותה באופן ציבורי או פרטי. האפשרות הזו שימושית כשנתוני התמונה גדולים מדי מכדי להוסיף אותם כשכבת-על כתמונה אחת. האריחים האלה משתמשים בקואורדינטות של קטע במפה של מפות Google, ואפשר להציג אותם באמצעות Google Maps Platform (Maps APIs), ‏Google Earth לאינטרנט ופלטפורמות מיפוי אחרות. אפשר לראות בקלות תצוגה מקדימה של המשבצות במפות Google או ב-Earth באמצעות קובצי HTML שסופקו כחלק מהייצוא.

יש כמה הגדרות ושלבים לייצוא, שיכול להיות שיהיו נחוצים או לא, בהתאם לאופן שבו אתם מתכננים להשתמש במשבצות או לפרסם אותן. בחלק מפלטפורמות המיפוי, המשבצות צריכות להיות נגישות לכולם, ובחלק מהן אפשר להשתמש במשבצות פרטיות. אם אתם משתמשים באחד מממשקי ה-API של מפות Google, סביר להניח שאתם צריכים מפתח API של Google Maps Platform. אם אתם מציגים משבצות ב-Google Earth או בפלטפורמות מיפוי אחרות, סביר להניח שתצטרכו להגדיר את האפשרויות המתאימות של רמת הגישה וגישת JS‏ (CORS), בהתאם לאופן שבו אתם מתכננים להשתמש במשבצות. בקטע הנחיות ספציפיות לפלטפורמה שבהמשך מפורטות ההגדרות הנדרשות.

ייצוא של משבצות מפה ל-Cloud Storage

בדוגמה הבאה מייצאים משבצות מתמונה של Landsat לאזור בקליפורניה.

Code Editor (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 מפורט מידע על API בשפת Python ועל השימוש ב-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) לא מוגדרת כך שתאפשר לאפליקציות אינטרנט לגשת אליהן. כלומר, אפשר לראות את המשבצות האלה בתצוגות המקדימות של מפות Google ו-Google Earth, אבל הן לא יועילו בפלטפורמות אחרות שדורשות גישה ל-JS. ההנחה היא שאתם הבעלים של קטגוריית הפלט. אם יש לכם הרשאת כתיבה בקטגוריית הפלט שצוינה (אבל אתם לא הבעלים), הגדירו את writePublicTiles כ-false כדי להשתמש ב-ACL שמוגדר כברירת מחדל לאובייקטים בקטגוריית הפלט.

כדי לפתוח את המשבצות לגישה ציבורית של כל אפליקציות האינטרנט, צריך להוסיף את bucketCorsUris: ['*'] לפרמטרים של המשימה. חשוב לזכור שגישה ציבורית מלאה ל-JS עלולה להיות לא רצויה אם יש סיכון שצדדים שלישיים ישתמשו במשבצות שלכם ויגרמו לעלויות בענן. כדי להגביל את הגישה, אפשר להגביל את הגישה של JS רק לאפליקציות אינטרנט בדומיינים או בכתובות URL ספציפיים. שימו לב שהגדרות הגישה של JS (CORS) חלות ברמת הקטגוריה כולה, ולא ברמת התיקייה או האובייקט.

אפשר להגדיר רשימות ACL ו-CORS באמצעות הפרמטרים writePublicTiles ו-bucketCorsUris בהתאמה, או מתיבת הדו-שיח של משימת הייצוא, כמו שמוצג בהמשך:

תיבת הדו-שיח Export.map
תיבת הדו-שיח של המשימה Export.map.toCloudStorage().
  • גישה לצפייה או להורדה. אם אתם רוצים גישה כלשהי (למשל, מעורך הקוד או מאפליקציות של Earth Engine), תצטרכו להגדיר את המשבצות כ"נגישות לכולם".
  • גישה ל-JS. כדי שעורך הקוד, אפליקציות של Earth Engine או אפליקציות אינטרנט אחרות יוכלו לגשת למשבצות, צריך לאפשר קריאה בקטגוריה שאליה מייצאים את המפה. צריך לקבוע את ההגדרות האלה של בקשות CORS ברמת הקטגוריה. לנוחותכם, תיבת הדו-שיח של הייצוא ב-Earth Engine מאפשרת להגדיר את ה-CORS לקטגוריה בזמן הייצוא.
  • הערה: הגדרות הגישה ל-JS או ל-CORS חלות ברמת הקטגוריה, ולא ברמת התיקייה או האובייקט. לכן, שינוי ההגדרות יעדכן אותן בכל התיקיות והאובייקטים בקטגוריה. מידע נוסף זמין במסמכי התיעוד של Cloud Storage CORS, כולל איך להציג את הגדרות ה-CORS הנוכחיות של קטגוריה.

רשימת פרמטרים

בהמשך מופיעה רשימה של כל הפרמטרים של משימת ייצוא של משבצות מפה, עם שם הפרמטר (הארגומנט) בקוד והשדה המתאים בתיבת הדו-שיח של המשימה (אם רלוונטי). שימו לב שחלק מהשדות הם בלעדיים (למשל, maxzoom ו-scale). פרטים נוספים זמינים במסמכי התיעוד של Export.map.

ארגומנט בקוד שדה בתיבת הדו-שיח של המשימה הערות
תמונה לא רלוונטי התמונה שרוצים לייצא כאריחים. חייב להיות Image, לא ImageCollection.
תיאור שם המשימה שם המשימה, בפורמט שקריא לאנשים. ברירת המחדל היא "myExportMapTask". השם הזה משמש גם כשם התיקייה של המשבצות, אם הפרמטר "path" (קידומת פלט) לא צוין.
bucket שם הקטגוריה ב-GCS קטגוריית היעד לכתיבה.
fileFormat פורמט קובץ פורמט הקובץ של משבצות המפה, אחד מהבאים: "auto",‏ "png" או "jpg". ברירת המחדל היא "auto", כלומר משבצות אטומות יקודדו כ-"jpg" ומשבצות עם שקיפות יקודדו כ-"png".
נתיב קידומת של פלט המחרוזת שמשמשת כנתיב של הפלט. התו "/" בסוף הוא אופציונלי. ברירת המחדל היא תיאור המשימה (שם המשימה)
writePublicTiles רמת גישה לצפייה או להורדה אם לכתוב משבצות ציבוריות במקום להשתמש ב-ACL שמוגדר כברירת מחדל לאובייקטים בקטגוריה. ערך ברירת המחדל הוא true, והמפעיל הוא הבעלים (OWNER) של הקטגוריה.
maxZoom רזולוציה מקסימלית וזום מקסימלי רמת הזום המקסימלית של משבצות המפה לייצוא.
שינוי קנה המידה רזולוציה מקסימלית וקנה מידה מקסימלי הרזולוציה המקסימלית של התמונה במטרים לפיקסל, כחלופה ל-"maxZoom". קנה המידה יומר לרמת הזום המקסימלית המתאימה ביותר בקו המשווה.
minZoom רזולוציה מקסימלית וזום מינימלי רמת הזום המינימלית האופציונלית של משבצות המפה לייצוא. ברירת המחדל היא אפס.
אזור לא רלוונטי ‫LinearRing,‏ Polygon או קואורדינטות שמייצגות את האזור לייצוא. פרטים נוספים זמינים במסמכי התיעוד.
skipEmptyTiles לא רלוונטי אם הערך הוא True, המערכת לא כותבת משבצות מפה ריקות (כלומר, שקופות לחלוטין). ברירת המחדל היא False.
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, צריך להגדיר את Access Level (רמת הגישה) ל-Publicly Accessible (נגישה לכולם), ואת JS Access Level (רמת הגישה ל-JS) (בתיבת הדו-שיח של המשימה) ל-Add Earth Engine Access (הוספת גישה ל-Earth Engine) או ל-Add Public Access (הוספת גישה לכולם). אפשר גם להגדיר את הפרמטרים האלה בקוד:

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

אחרי שמייצאים את המשבצות, אפשר לגשת אליהן ב-Earth Engine.

Code Editor (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 מפורט מידע על API בשפת Python ועל השימוש ב-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 באמצעות ממשק ה-API של JavaScript בפלטפורמה של מפות Google, כמו בדוגמה הזו: index.html. בייצוא בסיסי, המשבצות של מפת הבסיס יהיו אפורות ויופיע עליהן סימן מים עם הכיתוב "למטרות פיתוח בלבד". כדי להימנע מכך ולהציג משבצות מפה בסיסיות רגילות של Google, צריך ליצור מפתח API ולכלול אותו בהגדרות הייצוא.

אם תספקו מפתח API בזמן הייצוא, דף התצוגה המקדימה הזה יהיה גלוי לכולם, תוכלו להטמיע אותו בדפים אחרים והצופים לא יצטרכו להיות משתמשים רשומים ב-Earth Engine.

Code Editor (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 מפורט מידע על API בשפת Python ועל השימוש ב-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 ל-Publicly Accessible (נגיש לכולם), כדי שתוכלו להשתמש באריחים ב-Google Earth בלי קובץ התצוגה המקדימה (שמשתמש בשרת proxy אם לאריחים אין את הגדרות הגישה של JS או CORS הנדרשות).

כדי להוריד קובץ KML שמכיל קישור לנתונים, לוחצים על סמל האפשרויות הנוספות (3 נקודות) ב-Google Earth ובוחרים באפשרות "ייצוא כקובץ KML". הערה: קובץ ה-KML שנוצר בדרך הזו לא תואם ל-Google Earth Pro (הגרסה של Earth למחשב).

Code Editor (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 מפורט מידע על API בשפת Python ועל השימוש ב-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 Platform (Maps APIs)

כדי ליצור קבוצה של משבצות מפה שמוכנות לפרסום באופן ציבורי דרך הפלטפורמה של מפות Google, צריך שיהיה לכם מפתח API או ליצור אחד, ולוודא שרמת הגישה מוגדרת כ"נגישה לכולם". בהתאם לאופן שבו האפליקציה של Maps API ניגשת למשבצות, יכול להיות שתצטרכו גם להגדיר "רמת גישה ל-JS" שמתאימה לאתר שלכם. אחרי שמייצאים את המשבצות, הפלט בכרטיסייה Task של עורך הקוד מספק כתובת URL למשבצות עם המשתנים המתאימים לשימוש עם Google Maps API, לדוגמה: https://storage.googleapis.com/my_bucket/my_test_tiles/{Z}/{X}/{Y}

Code Editor (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 מפורט מידע על API בשפת Python ועל השימוש ב-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 בספריית הייצוא (ראו למעלה).

Code Editor (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 מפורט מידע על API בשפת Python ועל השימוש ב-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 של פלט ממשימת ייצוא של משבצות.

כדי להשתמש בזה ב-Earth באינטרנט, צריך ליצור תכונה של שכבת-על של משבצות ולהוסיף את כתובת ה-URL הזו בתור "כתובת ה-URL של שכבת-העל". אם קבוצת הנתונים לא גלובלית ואתם רוצים להימנע משגיאות בבקשות לאריחים שלא קיימים, פתחו את הקטע Overlay Options (אפשרויות שכבת-על) והתאימו את ארבעת הפרמטרים של Tile Coverage (כיסוי אריחים) כך שיתאימו להיקף האריחים שייצאתם.

אריחי מפה שמוצגים ב-Earth באינטרנט
משבצות מפה שמוצגות ב-Earth באינטרנט.

פרסום בפלטפורמות מיפוי אחרות

כשמייצאים משבצות לשימוש בפלטפורמות או באפליקציות אחרות, ההגדרות הנדרשות תלויות באופן שבו הן ניגשות למשבצות. כדי שהמשבצות יהיו נגישות לכמה שיותר אנשים, מגדירים את רמת הגישה ל-"Publicly Accessible" (נגישה לכולם) ואת רמת הגישה ל-JS ל-"Publicly Accessible" (נגישה לכולם).



יצירת מפתח API לפלטפורמה של מפות Google

אם אתם מתכננים להשתמש באריחי המפה שלכם בפלטפורמה של מפות Google, או אם אתם רוצים לראות תצוגה מקדימה שלהם במפות Google בלי מפת הבסיס שמוגבלת למפתחים, תצטרכו ליצור מפתח API לפלטפורמה של מפות Google או להשתמש במפתח קיים, ולכלול אותו בהגדרות הייצוא או להוסיף אותו לאתרים לאחר מכן. לא צריך לעשות את זה כדי להשתמש ב-Google Earth.

כשמייצאים משבצות מפה מ-Earth Engine, אנחנו יוצרים דף HTML לדוגמה שמאוחסן בספריית הפלט, כדי שתוכלו לראות תצוגה מקדימה של המשבצות באמצעות Google Maps Platform JavaScript API. בזמן הייצוא אפשר לספק מפתח API של הפלטפורמה של מפות Google, שישמש לקריאות ל-API של מציג הדוגמאות.

כדי ליצור מפתח API של Google Maps Platform עכשיו, צריך לבצע את ארבעת השלבים הבאים:

  • לוחצים על הכפתור "יצירת מפתח API לפלטפורמה של מפות Google" שבהמשך.
  • בוחרים את פרויקט הענן עבור מפתח ה-API ולוחצים על 'הבא'.
  • לוחצים על כדי להעתיק את המפתח החדש, ומדביקים אותו בתיבת הדו-שיח Export map ב-Code Editor.
  • (מומלץ) לוחצים על הקישור קונסולה לממשקי API מתחת למפתח החדש כדי להגדיר הגבלות על הגורם המפנה. פרטים נוספים זמינים במאמר בנושא הגבלות על הפניות ועל אפליקציות.

יצירת מפתח API לפלטפורמה של מפות Google

כאן כותבים את שם הפרויקט המפתח מוכן

הוספת הגבלות על הגורמים המפנים למפתח API

כשמוסיפים מפתח API, הגבלות על גורמים מפנים מבטיחות שרק האפליקציות המיועדות יוכלו להשתמש במפתח. אתם יכולים להגדיר או לערוך את ההגבלות על מפנים בכל שלב. פשוט נכנסים לדף Credentials במסוף Cloud ופועלים לפי השלבים הבאים:

  • מוודאים ששם הפרויקט הנכון נבחר בתפריט הנפתח שבחלק העליון של המסך.
  • לוחצים על מפתח ה-API של הפלטפורמה של מפות Google שנוצר למעלה כדי לראות את פרטי המפתח.
  • בוחרים באפשרות HTTP referrers (websites) ומציינים את הקטגוריה של Cloud Storage שצוינה ב-Export.map.toCloudStorage, באמצעות התבנית הבאה: https://storage.googleapis.com/{bucket}/*
  • לוחצים על 'שמירה'. האינדיקטור "שמירה…" אמור להופיע.
הוספת מפנים