Pour en savoir plus sur l'exportation vers d'autres formats, y compris les images, les vidéos et les tableaux (données vectorielles), consultez la section Exporter des données.
Présentation
Pour afficher des données d'image (données raster) sur une carte en ligne, vous pouvez exporter des tuiles de carte à l'aide de Export.map.toCloudStorage(). Cette fonction exporte une pyramide de tuiles de carte vers un bucket Cloud Storage, à partir duquel elle peut être diffusée publiquement ou en privé. Elle est utile lorsque vos données d'image sont trop volumineuses pour être superposées en tant qu'image unique. Ces tuiles utilisent les coordonnées des tuiles Google Maps et peuvent être affichées à l'aide de Google Maps Platform (API Maps), de Google Earth pour le Web et d'autres plates-formes de cartographie. Les tuiles peuvent facilement être prévisualisées dans Google Maps ou Google Earth à l'aide des fichiers HTML fournis lors de l'exportation.
L'exportation comporte un certain nombre de paramètres et d'étapes qui peuvent être nécessaires ou non, en fonction de la façon dont vous prévoyez d'utiliser ou de publier vos cartes. Certaines plates-formes de cartographie exigent que les cartes soient accessibles au public, tandis que d'autres acceptent les cartes privées. Si vous utilisez l'une des API Google Maps, vous avez probablement besoin d'une clé API Google Maps Platform. Si vous diffusez des tuiles sur Google Earth ou d'autres plates-formes de cartographie, vous devrez probablement définir les options de niveau d'accès et d'accès JS (CORS) appropriées, en fonction de la façon dont vous prévoyez d'utiliser vos tuiles. Pour connaître les paramètres requis, consultez la section Consignes spécifiques à la plate-forme ci-dessous.
Exporter des tuiles de carte vers Cloud Storage
L'exemple suivant exporte des tuiles à partir d'une image Landsat pour une zone de la Californie.
Éditeur de code (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 });
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()
Notez que cela crée un répertoire dans le bucket Cloud Storage spécifié, nommé par défaut selon le paramètre description. Vous pouvez modifier le nom du répertoire ou spécifier des sous-répertoires avec le paramètre path. Vous pouvez utiliser les fichiers index.html et earth.html de votre répertoire de sortie pour prévisualiser les tuiles dans Maps ou Earth.
ACL et options CORS
L'exemple ci-dessus définit les LCA (listes de contrôle d'accès) des cartes pour les rendre accessibles au public via une requête directe, mais ne définit pas l'accès JS (paramètres CORS) du bucket pour permettre aux applications Web d'y accéder.
Cela signifie que ces tuiles exportées peuvent être consultées dans les aperçus Maps et Earth, mais qu'elles ne seront pas utiles pour les autres plates-formes qui nécessitent un accès JavaScript. Vous êtes supposé être le propriétaire du bucket de sortie.
Si vous êtes un auteur du bucket de sortie spécifié (mais pas le propriétaire), définissez writePublicTiles sur false pour utiliser la LCA d'objet par défaut du bucket de sortie.
Si vous souhaitez ouvrir vos cartes à un accès public par toutes les applications Web, ajoutez bucketCorsUris: ['*'] aux paramètres de la tâche. Notez qu'un accès JavaScript public complet peut être indésirable en cas de risque d'utilisation de vos cartes par des tiers et d'engagement de frais cloud. Pour limiter cela, vous pouvez limiter l'accès JS aux seules applications Web sur des domaines ou des URL spécifiques. Notez que les paramètres d'accès JS (CORS) sont appliqués au niveau de l'ensemble du bucket, et non au niveau du dossier ou de l'objet.
Les LCA et le CORS peuvent être définis à l'aide des paramètres writePublicTiles et bucketCorsUris, respectivement, ou à partir de la boîte de dialogue de la tâche d'exportation, comme indiqué ci-dessous:
Export.map.toCloudStorage().
- Accès en vue/téléchargement Si vous souhaitez y accéder (par exemple, depuis l'éditeur de code ou les applications Earth Engine), vous devez définir les tuiles sur "Accessibles au public".
- Accès JavaScript Le bucket dans lequel la carte est exportée doit permettre une lisibilité si vous souhaitez que l'éditeur de code, les applications Earth Engine ou d'autres applications Web aient accès aux tuiles. Ces paramètres de requêtes entre origines (CORS) doivent être configurés au niveau du bucket. Pour plus de commodité, la boîte de dialogue d'exportation Earth Engine vous permet de configurer CORS pour votre bucket au moment de l'exportation.
- REMARQUE:Les paramètres d'accès JS / CORS sont appliqués au niveau du bucket, et non au niveau du dossier ou de l'objet. Par conséquent, modifier les paramètres les met à jour pour tous les dossiers et objets du bucket. Pour en savoir plus, consultez la documentation sur le CORS dans Cloud Storage, y compris comment afficher la configuration CORS actuelle d'un bucket.
Liste des paramètres
Vous trouverez ci-dessous la liste de tous les paramètres d'une tâche d'exportation de tuiles de carte, avec le nom du paramètre (argument) dans le code et le champ correspondant dans la boîte de dialogue de la tâche (le cas échéant). Notez que certains champs s'excluent mutuellement (par exemple, "maxzoom" et "scale"). Pour en savoir plus, consultez la documentation Export.map .
| Argument dans le code | Champ dans la boîte de dialogue de la tâche | Remarques |
|---|---|---|
| image | n/a | Image à exporter sous forme de tuiles. Doit être une image, et non une ImageCollection. |
| description | Nom de la tâche | Nom lisible de la tâche. La valeur par défaut est "myExportMapTask". Il sert également de nom de dossier pour les cartes, si le paramètre "path" (préfixe de sortie) n'est pas spécifié. |
| bucket | Nom du bucket GCS | Bucket de destination dans lequel écrire. |
| fileFormat | Format de fichier | Format de fichier des tuiles de carte, parmi les options suivantes: "auto", "png" ou "jpg". La valeur par défaut est "auto", ce qui signifie que les cartes opaques seront encodées en tant que "jpg" et que les cartes transparentes seront encodées en tant que "png". |
| chemin d'accès | Préfixe de sortie | Chaîne utilisée comme chemin d'accès de la sortie. Un "/" à la fin est facultatif. Par défaut, la description de la tâche (nom de la tâche) est utilisée. |
| writePublicTiles | Afficher/Télécharger le niveau d'accès | Indique si les cartes publiques doivent être écrites au lieu d'utiliser la LCA d'objet par défaut du bucket. La valeur par défaut est "true" et l'appelant est le PROPRIÉTAIRE du bucket. |
| maxZoom | Résolution maximale et zoom maximal | Niveau de zoom maximal des tuiles de carte à exporter. |
| Google. | Résolution maximale et échelle maximale | Résolution d'image maximale en mètres par pixel, au lieu de "maxZoom". L'échelle sera convertie au niveau de zoom maximal le plus approprié à l'équateur. |
| minZoom | Résolution maximale et zoom minimal | Niveau de zoom minimal facultatif des tuiles de carte à exporter. Prend la valeur zéro par défaut. |
| région | n/a | Un LinearRing, un polygone ou des coordonnées représentant la région à exporter. Pour en savoir plus, consultez la documentation. |
| skipEmptyTiles | n/a | Si la valeur est définie sur "true", l'écriture des tuiles de carte vides (c'est-à-dire entièrement transparentes) est ignorée. Valeur par défaut : "false". |
| mapsApiKey | Clé d'API Google Maps | Utilisé dans index.html pour initialiser l'API Google Maps. Le message "À des fins de développement uniquement" est alors supprimé de la carte. |
| bucketCorsUris | Ajouter l'accès JS ("Website to allow") | Liste des domaines (par exemple, https://code.earthengine.google.com) autorisés à récupérer les tuiles exportées via JavaScript (CORS). |
Échelle et zoom
Dans l'exemple précédent, maxZoom est défini sur 13.
Les niveaux de zoom correspondent à des grilles de pixels de différentes tailles permettant d'afficher une carte globale. (Pour en savoir plus, consultez la
documentation de référence sur les coordonnées de pixel
.) En raison de la courbure de la Terre, la résolution des pixels à un niveau de zoom donné varie en fonction de la latitude. Plus précisément, les mètres par pixel diminuent d'un facteur cos(latitude). Le tableau suivant indique les mètres par pixel, à chaque niveau de zoom, à l'équateur pour la projection Google Mercator:
| Niveau de zoom | Taille des pixels (à l'équateur) | Niveau de zoom | Taille des pixels (à l'équateur) |
|---|---|---|---|
| 0 | 156 km | 10 | 152 m |
| 1 | 78 km | 11 | 76 m |
| 2 | 39 km | 12 | 38 m |
| 3 | 20 km | 13 | 19 m |
| 4 | 10 km | 14 | 9,6 m |
| 5 | 4,9 km | 15 | 4,8 m |
| 6 | 2,4 km | 16 | 2,4 m |
| 7 | 1,2 km | 17 | 1,2 m |
| 8 | 611 m | 18 | 0,6 m |
| 9 | 305 m | 19 | 0,3 m |
| 20 | 0,15 m |
D'après le tableau précédent, la valeur maxZoom définie dans l'exemple correspond à 19 mètres à l'équateur, et est plus faible aux latitudes plus élevées. Ce nombre est inférieur à la résolution nominale de 30 arcsecondes par pixel de l'image d'entrée. Par conséquent, vous pouvez faire un zoom avant sur la carte affichée dans le fichier de sortie
index.html
jusqu'à ce que les pixels de la résolution native soient visibles.
Pour limiter l'affichage de la carte à la résolution native en pixels, définissez maxZoom sur une valeur correspondant à la résolution native ou inférieure.
Consignes spécifiques à la plate-forme
Vous trouverez ci-dessous un certain nombre de plates-formes sur lesquelles vous pouvez afficher et utiliser des tuiles de carte. Chaque section indique les paramètres requis pour que les cartes fonctionnent avec cette plate-forme, ainsi qu'une copie de l'exemple de code avec les paramètres nécessaires.
Utiliser des tuiles de carte dans Earth Engine (éditeur de code ou applications EE)
Si vous souhaitez exporter des tuiles de carte uniquement pour les réutiliser dans Google Earth Engine ou les applications EE, définissez "Niveau d'accès" sur "Accessible au public", puis "Niveau d'accès JS" (dans la boîte de dialogue de la tâche) sur "Ajouter un accès Earth Engine" ou "Ajouter un accès public". Vous pouvez également définir ces paramètres dans le code:
writePublicTiles: true, bucketCorsUris: ['https://code.earthengine.google.com','https://*.earthengine.app']
Une fois les tuiles exportées, elles seront accessibles dans Earth Engine.
Éditeur de code (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'] });
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()
Afficher un aperçu de Google Maps
Pour prévisualiser vos tuiles de carte dans Google Maps, accédez au dossier de sortie sur Google Cloud Storage, puis ouvrez le fichier "index.html" dans votre navigateur. Une carte pleine page s'ouvre, affichant vos cartes sur Google Maps à l'aide de l'API Google Maps Platform JavaScript, comme celle-ci : index.html. Une exportation de base génère des tuiles de basemap grisées et portant le filigrane "À des fins de développement uniquement". Pour éviter cela et afficher les tuiles de carte de base Google standards, générez une clé API et incluez-la dans vos paramètres d'exportation.
Si vous fournissez une clé API au moment de l'exportation, cette page d'aperçu est visible par tous les utilisateurs, peut être intégrée à d'autres pages et ne nécessite pas que le lecteur soit un utilisateur Earth Engine enregistré.
Éditeur de code (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 });
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()
Afficher un aperçu Google Earth
Pour prévisualiser vos tuiles de carte dans Google Earth sur le Web, veillez à les exporter avec le niveau d'accès défini sur "Accessible au public". Accédez ensuite au dossier de sortie dans Google Cloud Storage, ouvrez le fichier "earth.html" dans votre navigateur, comme celui-ci : earth.html puis cliquez sur le bouton "Ouvrir dans Google Earth" qui s'affiche. Google Earth s'ouvre et vos tuiles s'affichent sur la carte 3D. Il est recommandé de définir également le niveau "Accès JavaScript" sur "Accessible au public", ce qui vous permettra d'utiliser les tuiles dans Google Earth sans le fichier d'aperçu (qui utilise un serveur proxy si les tuiles ne disposent pas des paramètres d'accès JavaScript/CORS nécessaires).
Pour télécharger un fichier KML contenant un lien vers vos données, cliquez sur le menu à trois points dans Google Earth, puis sélectionnez "Exporter en tant que fichier KML". Remarque:Le fichier KML généré de cette manière n'est PAS compatible avec Google Earth Pro (la version classique d'Earth).
Éditeur de code (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) });
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()
Publier avec Google Maps Platform (API Maps)
Pour créer un ensemble de tuiles de carte prêtes à être publiées publiquement via Google Maps Platform, vous devez disposer d'une clé API ou en créer une, et vous assurer que le niveau d'accès est défini sur "Accessible au public". En fonction de la façon dont votre application API Maps accède aux tuiles, vous devrez peut-être également définir un "niveau d'accès JavaScript" approprié pour votre site. Une fois que vous avez exporté vos tuiles, la sortie de l'onglet "Task" (Tâche) de l'éditeur de code fournit une URL pour vos tuiles avec les variables appropriées à utiliser avec l'API Google Maps, par exemple :
https://storage.googleapis.com/my_bucket/my_test_tiles/{Z}/{X}/{Y}
Éditeur de code (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 });
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()
Publier dans Google Earth (sur le Web)
Pour créer un ensemble de tuiles de carte à publier publiquement via Google Earth, vous devez définir le niveau d'accès sur "Accessible au public" et le niveau d'accès JavaScript sur "https://earth.google.com" (ou "Accessible au public"). Après l'exportation, vous pouvez les prévisualiser dans Google Earth à l'aide du fichier earth.html dans le répertoire d'exportation (voir ci-dessus).
Éditeur de code (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 });
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()
Une fois les tuiles exportées, vous pouvez les ajouter à un projet dans Google Earth Web. La sortie de l'onglet "Tâches" de l'éditeur de code (illustré ci-dessous) fournit l'URL de vos tuiles avec les variables appropriées à utiliser dans Google Earth, par exemple :
https://storage.googleapis.com/my_bucket/my_test_tiles/$[level]/$[x]/$[y]
Pour l'utiliser dans Earth Web, créez une couche de tuiles et ajoutez cette URL comme "URL de la superposition". Si votre ensemble de données n'est pas global et que vous souhaitez éviter les erreurs de requête de tuile pour les tuiles inexistantes, veillez à ouvrir la section "Options de superposition" et à ajuster les quatre paramètres de couverture des tuiles pour qu'ils correspondent aux étendues de vos tuiles exportées.
Publier sur d'autres plates-formes de cartographie
Lorsque vous exportez des cartes à utiliser avec d'autres plates-formes ou applications, les paramètres nécessaires dépendent de la manière dont elles y accèdent. Pour rendre les cartes aussi accessibles que possible, définissez le niveau d'accès sur "Publicement accessible" et le niveau d'accès JS sur "Publicement accessible".
Générer une clé API Google Maps Platform
Si vous prévoyez d'utiliser vos tuiles de carte avec Google Maps Platform ou si vous souhaitez les prévisualiser sur Maps sans la base de données cartographique réservée aux développeurs, vous devez disposer d'une clé API Google Maps Platform ou en générer une, et l'inclure dans vos paramètres d'exportation ou l'ajouter au ou aux sites par la suite. Ce n'est pas nécessaire pour l'utiliser avec Google Earth.
Lorsque vous exportez des tuiles de carte depuis Earth Engine, nous générons un exemple de page HTML stocké dans le répertoire de sortie afin que vous puissiez prévisualiser les tuiles à l'aide de l'API JavaScript Google Maps Platform. Vous pouvez éventuellement fournir une clé API Google Maps Platform au moment de l'exportation, qui sera utilisée pour les appels d'API de l'aperçu du lecteur.
Pour générer une clé API Google Maps Platform maintenant, procédez comme suit:
- Cliquez sur le bouton "Créer une clé API Maps Platform" ci-dessous.
- Sélectionnez le projet Cloud de votre clé API, puis cliquez sur "SUIVANT".
- Cliquez sur pour copier la nouvelle clé, puis collez-la dans la boîte de dialogue "Exporter la carte" de l'éditeur de code.
- (Recommandé) Cliquez sur le lien "Console API" sous la nouvelle clé pour définir des restrictions de site référent. Pour en savoir plus, consultez la section Restrictions sur le référent et les applications.
Créer une clé API Maps Platform
Ajouter des restrictions de référent à une clé API
Lorsque vous ajoutez une clé API, les restrictions de référents garantissent que seules les applications désignées peuvent utiliser votre clé. Vous pouvez définir ou modifier des restrictions de sites référents à tout moment en accédant à la page Identifiants de la console Cloud, puis en procédant comme suit:
- Assurez-vous que le bon nom de projet est sélectionné dans le menu déroulant en haut de l'écran.
- Cliquez sur la clé API Maps Platform générée ci-dessus pour afficher ses détails.
-
Sélectionnez Référents HTTP (sites Web), puis spécifiez le bucket Cloud Storage spécifié dans
Export.map.toCloudStorageà l'aide du modèle suivant :https://storage.googleapis.com/{bucket}/* - Cliquez sur "Enregistrer". L'indicateur "Enregistrement…" doit s'afficher.
