Créer un paquetage de tuiles de carte (Gestion des données)—ArcGIS Pro

Synthèse

Génère des tuiles à partir d’une carte et empaquette les tuiles pour créer un unique paquetage de tuiles compressé (fichier .tpkx).

Utilisation

La carte en entrée doit contenir une description et des balises pour que l’outil puisse être exécuté. Pour ajouter une description et des balises, cliquez avec le bouton droit sur le nom de la carte dans la fenêtre Contenu, sélectionnez Propriétés et saisissez une description ainsi que des balises sur l’onglet Description.
Si vous choisissez PNG pour le paramètre Format de tuilage, l’outil sélectionne automatiquement le format correct (PNG8, PNG24 ou PNG32) en fonction de la valeur spécifiée dans Niveau d’affichage.
Cet outil respecte l’environnement Facteur de traitement parallèle. Si l’environnement n’est pas défini (valeur par défaut) ou s’il est défini sur 100, le traitement parallèle complet est activé et l’outil tente de répartir les tâches sur tous les cœurs logiques de la machine. Si vous définissez l’environnement sur 0, le traitement parallèle est désactivé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil détermine le pourcentage de cœurs logiques à utiliser en appliquant la formule suivante, arrondie à l’entier supérieur le plus proche :
```
Facteur de traitement parallèle/100*Cœurs logiques
```
Si le résultat de cette formule est 0 ou 1, le traitement parallèle n'est pas activé.

Paramètres

Étiquette	Explication	Type de données
Carte en entrée	Carte à partir de laquelle les tuiles ont été générées et empaquetées.	Map
Paquetage pour ArcGIS Online \| Bing Maps \| Google Maps	Détermine si la structure de tuilage est générée à partir d’un service de carte existant ou si les tuiles de carte sont générées pour ArcGIS Online, Bing Maps et Google Maps. Activé : la structure de tuile ArcGIS Online/Bing Maps/Google Maps est utilisée. Il s’agit de l’option par défaut. La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps vous permet de superposer les tuiles de cache avec celles de ces services de cartographie en ligne. ArcGIS Desktop intègre cette structure de tuile lors du chargement d'une structure de tuile. Lorsque vous sélectionnez cette structure de tuilage, la carte source doit utiliser le système de coordonnées projetées WGS 1984 Web Mercator (Sphère Auxiliaire). La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps est nécessaire si vous superposez le paquetage avec ArcGIS Online, Bing Maps ou Google Maps. La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps présente l’avantage d’être largement répandue dans le secteur de la cartographie Web. Les tuiles correspondent ainsi à celles d’autres organisations ayant utilisé cette structure de tuilage. Même si vous ne projetez pas de superposer l'un de ces services de carte connus, vous pouvez sélectionner la structure de tuile pour ses capacités d'interopérabilité. La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps peut contenir des échelles de zoom trop rapprochées pour être utiles dans votre carte. L’empaquetage à grande échelle peut non seulement prendre du temps, mais aussi occuper un espace de stockage important sur le disque. Par exemple, la plus grande échelle dans la structure de tuile est approximativement 1:1 000. A cette échelle, l'empaquetage de la totalité de la surface des Etats-Unis peut prendre des semaines et nécessiter des centaines de gigaoctets de stockage. Si vous ne souhaitez pas procéder à l'empaquetage à ce niveau d'échelle, supprimez ce niveau d’échelle lors de la création du paquetage de tuiles. Désactivé : la structure de tuilage d’un service de carte existant est utilisée. Sélectionnez cette option si votre organisation a créé une structure de tuilage pour un service existant sur le serveur et que vous souhaitez vous y conformer. La correspondance des structures de tuilage garantit une superposition correcte de vos tuiles dans votre application ArcGIS Runtime. Si vous sélectionnez cette option, utilisez le même système de coordonnées pour la carte source que celui de la carte avec la structure de tuilage que vous importez.	Boolean
Fichier en sortie	Paquetage de tuiles de carte en sortie.	File
Format de tuilage	Spécifie le format utilisé pour les tuiles générées. PNG—Le format approprié (PNG 8, PNG 24 ou PNG 32) est utilisé en fonction de la valeur spécifiée dans Niveau de détail. Il s’agit de l’option par défaut. PNG 8 bits—Le format PNG8 est utilisé. Utilisez ce format pour les services de superposition qui doivent avoir un arrière-plan transparent, tels que les routes et les limites. Le format PNG 8 crée des tuiles de très petite taille sur le disque, sans perte d'informations.Il est déconseillé d’utiliser le format PNG 8 si la carte contient plus de 256 couleurs. L’imagerie, les ombrages, les remplissages dégradés, la transparence et l’anti-crénelage peuvent aisément utiliser plus de 256 couleurs dans une carte. Même les symboles, tels que les écrans antibruit, peuvent posséder un anti-crénelage subtil autour des bords qui ajoute des couleurs à la carte de façon inattendue. PNG 24 bits—Le format PNG24 est utilisé. Utilisez ce format pour des services de superposition, tels que des routes et des limites, présentant plus de 256 couleurs (avec moins de 256 couleurs, utilisez le format PNG 8). PNG 32 bits—Le format PNG32 est utilisé. Utilisez ce format pour des services de superposition, tels que des routes et des frontières, possédant plus de 256 couleurs. Le format PNG32 convient aux services de superposition comportant un anti-crénelage activé sur les lignes ou le texte. Le format PNG 32 crée de plus grandes tuiles sur le disque que le format PNG 24. JPEG—Le format JPEG sera utilisé. Utilisez ce format pour les services de fond de carte comprenant de grandes variations de couleurs et qui ne nécessitent pas d’arrière-plan transparent. Par exemple, le format JPEG convient généralement à l’imagerie raster et aux fonds de carte vectoriels détaillés.JPEG est un format d'image avec perte. Il tente de supprimer des données de manière sélective sans affecter l'apparence de l'image. Cela crée de très petites tailles de tuiles sur le disque, mais si la carte contient un réseau linéaire vectoriel ou des étiquettes, il risque de produire trop de bruit ou des zones floues autour des lignes. Si tel est le cas, vous pouvez augmenter la valeur de compression par défaut de 75. Une valeur supérieure, telle que 90, permet d'équilibrer une qualité acceptable du dessin au trait DAO grâce à la taille de tuile réduite du format JPEG.Si vous êtes disposé à accepter une quantité réduite de bruit dans les images, vous pouvez économiser un volume important d’espace de stockage sur le disque grâce au format JPEG. Une taille de tuile réduite implique un téléchargement plus rapide. Mixte—Le format JPEG est utilisé au centre du paquetage et le format PNG 32 sur le bord du paquetage. Utilisez le mode mixte pour superposer nettement des paquetages de raster sur d’autres couches.Lors de la création d’un paquetage mixte, des tuiles PNG 32 sont créées partout où la transparence est détectée (en d’autres termes, partout où l’arrière-plan de la carte est visible). Les tuiles restantes sont créées à l'aide du format JPEG. Cela réduit la taille moyenne des fichiers tout en vous fournissant une superposition nette sur d’autres paquetages. Si vous n’utilisez pas le paquetage en mode mixte dans ce scénario, vous observez un collier non transparent autour de la périphérie de l’image, aux endroits où elle est superposée à l’autre paquetage.	String
Niveau de détail maximal	Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette échelle définit le niveau maximum de génération des tuiles de cache dans le paquetage de tuiles. Les valeurs plus élevées reflètent des échelles plus grandes qui affichent plus de détails, mais occupent un plus grand espace de stockage. Les valeurs plus faibles reflètent des échelles plus petites qui affichent moins de détails et occupent moins de stockage. Les valeurs possibles sont comprises entre 1 et 23. La valeur par défaut est 1. La valeur maximale du niveau de détail doit être supérieure à la valeur minimale du niveau de détail.	Long
Service (Facultatif)	Nom du service de carte ou des fichiers .xml utilisés pour la structure de tuilage. Ce paramètre est obligatoire uniquement lorsque le paramètre Paquetage pour ArcGIS Online \| Bing Maps \| Google Maps est désactivé.	Map Server; File
Résumé (Facultatif)	Ajoute un récapitulatif des propriétés du paquetage.	String
Balises (Facultatif)	Ajoute des informations sur les balises aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises en les séparant par une virgule ou un point-virgule.	String
Étendue (Facultatif)	Spécifie l'étendue utilisée pour sélectionner ou découper les entités. Default (Par défaut) : l’étendue repose sur l’étendue maximale de toutes les entrées participantes. Il s’agit de l’option par défaut. Union of Inputs (Union des entrées) : l’étendue est basée sur l’étendue maximale de toutes les entrées. Intersection of inputs (Intersection des entrées) : l’étendue est basée sur la surface minimale commune à toutes les entrées. Current Display Extent (Étendue d’affichage actuelle) : l’étendue correspond à l’affichage visible. Cette option n’est pas disponible lorsque aucune carte n’est active. As Specified Below (Comme spécifié ci-dessous) : l’étendue est basée sur les valeurs d’étendue minimale et maximale indiquées. Browse (Parcourir) : l’étendue repose sur un jeu de données existant.	Extent
Qualité de compression (Facultatif)	Une valeur comprise entre 1 et 100 pour définir la qualité de compression JPEG. La valeur par défaut est 75 pour le format de tuile JPEG et zéro pour les autres formats. La compression est uniquement prise en charge pour les formats JPEG et mixte. La sélection d'une valeur plus élevée entraîne une taille de fichier supérieure avec une image de meilleure qualité. La sélection d'une valeur inférieure entraîne une taille de fichier inférieure avec une image de qualité inférieure.	Long
Type de paquetage (Facultatif)	Spécifie le type de paquetage de tuiles à créer. tpk—Les tuiles sont stockées au format de stockage compact. Ce format est pris en charge sur la plateforme ArcGIS. tpkx—Les tuiles sont stockées au format de stockage CompactV2, qui offre de meilleures performances sur les partages réseau et les répertoires de stockage Cloud. Ce type de structure de paquetage est pris en charge par les versions plus récentes des produits ArcGIS, telles que ArcGIS Online 7.1, ArcGIS Enterprise 10.7 et ArcGIS Runtime 100.5. Il s’agit de l’option par défaut.	String
Niveau de détail minimal (Facultatif)	Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette valeur d’échelle définit le niveau minimal pour la mise à disposition et la génération des tuiles de cache dans le paquetage de tuiles. Les valeurs possibles sont comprises entre 0 et 23. La valeur par défaut est 0. La valeur minimale du niveau de détail doit être inférieure ou égale à la valeur maximale du niveau de détail.	Long
Zone d'intérêt (Facultatif)	Jeu d’entités qui contraint l’emplacement où les tuiles sont créées. Utilisez la zone d’intérêt afin de créer des tuiles pour des zones de forme irrégulière ou des entités multi-parties. Les zones situées en dehors de la zone de délimitation d’entités de zone d’intérêt ne sont pas mises en cache. Si aucune valeur n’est indiquée pour ce paramètre, la zone d’intérêt est l’étendue complète de la carte en entrée.	Feature Set

arcpy.management.CreateMapTilePackage(in_map, service_type, output_file, format_type, level_of_detail, {service_file}, {summary}, {tags}, {extent}, {compression_quality}, {package_type}, {min_level_of_detail}, {area_of_interest})

Nom	Explication	Type de données
in_map	Carte à partir de laquelle les tuiles ont été générées et empaquetées.	Map
service_type	Détermine si la structure de tuilage est générée à partir d’un service de carte existant ou si les tuiles de carte sont générées pour ArcGIS Online, Bing Maps et Google Maps. EXISTING—Une structure de tuile d’un service de carte existant est utilisée. Vous devez indiquer un service de carte dans le paramètre service_file.Sélectionnez cette option si votre organisation a créé une structure de tuilage pour un service existant sur le serveur et que vous souhaitez vous y conformer. La correspondance des structures de tuilage garantit une superposition correcte de vos tuiles dans votre application ArcGIS Runtime.Si vous sélectionnez cette option, utilisez le même système de coordonnées pour la carte source que celui de la carte avec la structure de tuilage que vous importez. ONLINE—La structure de tuile ArcGIS Online/Bing Maps/Google Maps est utilisée. Il s’agit de l’option par défaut.La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps vous permet de superposer les tuiles de cache avec celles de ces services de cartographie en ligne. ArcGIS Desktop intègre cette structure de tuile lors du chargement d'une structure de tuile. Lorsque vous sélectionnez cette structure de tuilage, la carte source doit utiliser le système de coordonnées projetées WGS 1984 Web Mercator (Sphère Auxiliaire).La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps est nécessaire si vous superposez le paquetage avec ArcGIS Online, Bing Maps ou Google Maps. La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps présente l’avantage d’être largement répandue dans le secteur de la cartographie Web. Les tuiles correspondent ainsi à celles d’autres organisations ayant utilisé cette structure de tuilage. Même si vous ne projetez pas de superposer l'un de ces services de carte connus, vous pouvez sélectionner la structure de tuile pour ses capacités d'interopérabilité.La structure de tuilage d’ArcGIS Online/Bing Maps/Google Maps peut contenir des échelles de zoom trop rapprochées pour être utiles dans votre carte. L’empaquetage à grande échelle peut non seulement prendre du temps, mais aussi occuper un espace de stockage important sur le disque. Par exemple, la plus grande échelle dans la structure de tuile est approximativement 1:1 000. A cette échelle, l'empaquetage de la totalité de la surface des Etats-Unis peut prendre des semaines et nécessiter des centaines de gigaoctets de stockage. Si vous ne souhaitez pas procéder à l'empaquetage à ce niveau d'échelle, supprimez ce niveau d’échelle lors de la création du paquetage de tuiles.	Boolean
output_file	Paquetage de tuiles de carte en sortie.	File
format_type	Spécifie le format utilisé pour les tuiles générées. PNG—Le format approprié (PNG 8, PNG 24 ou PNG 32) est utilisé en fonction de la valeur spécifiée dans Niveau de détail. Il s’agit de l’option par défaut. PNG8—Le format PNG8 est utilisé. Utilisez ce format pour les services de superposition qui doivent avoir un arrière-plan transparent, tels que les routes et les limites. Le format PNG 8 crée des tuiles de très petite taille sur le disque, sans perte d'informations.Il est déconseillé d’utiliser le format PNG 8 si la carte contient plus de 256 couleurs. L’imagerie, les ombrages, les remplissages dégradés, la transparence et l’anti-crénelage peuvent aisément utiliser plus de 256 couleurs dans une carte. Même les symboles, tels que les écrans antibruit, peuvent posséder un anti-crénelage subtil autour des bords qui ajoute des couleurs à la carte de façon inattendue. PNG24—Le format PNG24 est utilisé. Utilisez ce format pour des services de superposition, tels que des routes et des limites, présentant plus de 256 couleurs (avec moins de 256 couleurs, utilisez le format PNG 8). PNG32—Le format PNG32 est utilisé. Utilisez ce format pour des services de superposition, tels que des routes et des frontières, possédant plus de 256 couleurs. Le format PNG32 convient aux services de superposition comportant un anti-crénelage activé sur les lignes ou le texte. Le format PNG 32 crée de plus grandes tuiles sur le disque que le format PNG 24. JPEG—Le format JPEG sera utilisé. Utilisez ce format pour les services de fond de carte comprenant de grandes variations de couleurs et qui ne nécessitent pas d’arrière-plan transparent. Par exemple, le format JPEG convient généralement à l’imagerie raster et aux fonds de carte vectoriels détaillés.JPEG est un format d'image avec perte. Il tente de supprimer des données de manière sélective sans affecter l'apparence de l'image. Cela crée de très petites tailles de tuiles sur le disque, mais si la carte contient un réseau linéaire vectoriel ou des étiquettes, il risque de produire trop de bruit ou des zones floues autour des lignes. Si tel est le cas, vous pouvez augmenter la valeur de compression par défaut de 75. Une valeur supérieure, telle que 90, permet d'équilibrer une qualité acceptable du dessin au trait DAO grâce à la taille de tuile réduite du format JPEG.Si vous êtes disposé à accepter une quantité réduite de bruit dans les images, vous pouvez économiser un volume important d’espace de stockage sur le disque grâce au format JPEG. Une taille de tuile réduite implique un téléchargement plus rapide. MIXED—Le format JPEG est utilisé au centre du paquetage et le format PNG 32 sur le bord du paquetage. Utilisez le mode mixte pour superposer nettement des paquetages de raster sur d’autres couches.Lors de la création d’un paquetage mixte, des tuiles PNG 32 sont créées partout où la transparence est détectée (en d’autres termes, partout où l’arrière-plan de la carte est visible). Les tuiles restantes sont créées à l'aide du format JPEG. Cela réduit la taille moyenne des fichiers tout en vous fournissant une superposition nette sur d’autres paquetages. Si vous n’utilisez pas le paquetage en mode mixte dans ce scénario, vous observez un collier non transparent autour de la périphérie de l’image, aux endroits où elle est superposée à l’autre paquetage.	String
level_of_detail	Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette échelle définit le niveau maximum de génération des tuiles de cache dans le paquetage de tuiles. Les valeurs plus élevées reflètent des échelles plus grandes qui affichent plus de détails, mais occupent un plus grand espace de stockage. Les valeurs plus faibles reflètent des échelles plus petites qui affichent moins de détails et occupent moins de stockage. Les valeurs possibles sont comprises entre 1 et 23. La valeur par défaut est 1. La valeur maximale du niveau de détail doit être supérieure à la valeur minimale du niveau de détail.	Long
service_file (Facultatif)	Nom du service de carte ou des fichiers .xml utilisés pour la structure de tuilage. Ce paramètre est requis uniquement lorsque le paramètre service_type est défini sur EXISTING.	Map Server; File
summary (Facultatif)	Ajoute un récapitulatif des propriétés du paquetage.	String
tags (Facultatif)	Ajoute des informations sur les balises aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises en les séparant par une virgule ou un point-virgule.	String
extent (Facultatif)	Spécifie l'étendue utilisée pour sélectionner ou découper les entités. MAXOF : l’étendue maximale de toutes les entrées est utilisée. MINOF : l’étendue minimale de toutes les entrées est utilisée. DISPLAY : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. Objet Extent : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
compression_quality (Facultatif)	Une valeur comprise entre 1 et 100 pour définir la qualité de compression JPEG. La valeur par défaut est 75 pour le format de tuile JPEG et zéro pour les autres formats. La compression est uniquement prise en charge pour les formats JPEG et mixte. La sélection d'une valeur plus élevée entraîne une taille de fichier supérieure avec une image de meilleure qualité. La sélection d'une valeur inférieure entraîne une taille de fichier inférieure avec une image de qualité inférieure.	Long
package_type (Facultatif)	Spécifie le type de paquetage de tuiles à créer. tpk—Les tuiles sont stockées au format de stockage compact. Ce format est pris en charge sur la plateforme ArcGIS. tpkx—Les tuiles sont stockées au format de stockage CompactV2, qui offre de meilleures performances sur les partages réseau et les répertoires de stockage Cloud. Ce type de structure de paquetage est pris en charge par les versions plus récentes des produits ArcGIS, telles que ArcGIS Online 7.1, ArcGIS Enterprise 10.7 et ArcGIS Runtime 100.5. Il s’agit de l’option par défaut.	String
min_level_of_detail (Facultatif)	Représentation sous forme d’entiers correspondant au nombre d’échelles utilisées pour définir une structure de tuilage de cache. Cette valeur d’échelle définit le niveau minimal pour la mise à disposition et la génération des tuiles de cache dans le paquetage de tuiles. Les valeurs possibles sont comprises entre 0 et 23. La valeur par défaut est 0. La valeur minimale du niveau de détail doit être inférieure ou égale à la valeur maximale du niveau de détail.	Long
area_of_interest (Facultatif)	Jeu d’entités qui contraint l’emplacement où les tuiles sont créées. Utilisez la zone d’intérêt afin de créer des tuiles pour des zones de forme irrégulière ou des entités multi-parties. Les zones situées en dehors de la zone de délimitation d’entités de zone d’intérêt ne sont pas mises en cache. Si aucune valeur n’est indiquée pour ce paramètre, la zone d’intérêt est l’étendue complète de la carte en entrée.	Feature Set

Exemple de code

Exemple 1 d'utilisation de l'outil CreateMapTilePackage (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction CreateMapTilePackage dans la fenêtre Python.

import arcpy
arcpy.env.workspace = "C:/TilePackageExample" 
arcpy.management.CreateMapTilePackage("World Soils", "ONLINE", "Example.tpk", "PNG8", "10")

Exemple 2 d'utilisation de l'outil CreateMapTilePackage (script autonome)

Recherchez et créez des paquetages de tuiles de carte pour toutes les cartes dans un projet.

# Name: CreateMapTilePackage.py
# Description: Find all the maps in the project and
#   create a map tile package for each map

# import system modules
import os
import arcpy

# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/Tilepackages" 

# Loop through the project, find all the maps, and
#   create a map tile package for each map,
#   using the same name as the map
p = arcpy.mp.ArcGISProject("c:\\temp\\myproject.aprx")
for m in p.listMaps():
    print("Packaging " + m.name)
    arcpy.management.CreateMapTilePackage(m, "ONLINE", "{}.tpk".format(m.name), 
                                          "PNG8", "10")

Environnements

Espace de travail courant, Facteur de traitement parallèle

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?