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

Résumé

Génère des tuiles à partir d'une carte ou d'un fond de carte et crée un paquetage de tuiles pour générer un seul fichier .tpk compressé.

Utilisation

  • La carte en entrée doit contenir une description et des balises pour que l’outil puisse s’exécuter. Pour ajouter une description et des balises, cliquez avec le bouton droit sur le nom de la carte dans la fenêtre Contents (Contenu), choisissez Properties (Propriétés) et entrer une description et des balises sous l’onglet Description.

  • En choisissant 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 :

    Parallel Processing Factor / 100 * Logical Cores
    .

    Si le résultat de cette formule est 0 ou 1, le traitement parallèle n'est pas activé.

Syntaxe

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})
ParamètreExplicationType 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.

  • EXISTINGUne 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 tuile pour un service existant sur votre serveur et que vous souhaitez vous y conformer. La correspondance des structures de tuile 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 votre source que celui de la carte avec la structure de tuile que vous importez.
  • ONLINELa structure de tuile ArcGIS Online/Bing Maps/Google Maps est utilisée. Il s’agit de l’option par défaut.La structure de tuile ArcGIS Online/Bing Maps/Google Maps vous permet de superposer vos tuiles de cache avec les tuiles de ces services de cartographie en ligne. ArcGIS Desktop inclut cette structure de tuile sous forme d'option intégrée lors du chargement d'une structure de tuile. Si vous sélectionnez cette structure de tuile, la carte source doit utiliser le système de coordonnées projetées WGS 1984 Web Mercator (Auxiliary Sphere) [WGS 1984 Web Mercator (Sphère Auxiliaire)].La structure de tuile ArcGIS Online/Bing Maps/Google Maps est nécessaire pour superposer votre paquetage avec ArcGIS Online, Bing Maps ou Google Maps. La structure de tuilage ArcGIS Online/Bing Maps/Google Maps présente l'avantage d'être largement répandue dans le secteur de la cartographie Web. Vos 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 tuile ArcGIS Online/Bing Maps/Google Maps peut contenir des échelles de zoom trop rapprochées pour être utiles à votre carte. L'empaquetage à grande échelle peut non seulement prendre beaucoup de 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 des tuiles générées.

  • PNGUtilisez PNG pour sélectionner automatiquement le format correct (PNG 8, PNG 24 ou PNG 32) en fonction de la valeur spécifiée dans Niveau de détail. Il s’agit de l’option par défaut.
  • PNG8Utilisez le format PNG 8 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 votre 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 contraindre votre carte à utiliser plus de 256 couleurs. Même les symboles, tels que les écrans antibruit, peuvent posséder un anti-crénelage subtil autour des bords qui ajoute des couleurs à votre carte de façon inattendue.
  • PNG24Utilisez le format PNG 24 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).
  • PNG32Utilisez le format PNG 32 pour des services de superposition, tels que des routes et des limites, qui présentent plus de 256 couleurs. Le format PNG 32 est un choix qui convient tout particulièrement aux services de superposition pour lesquels un anti-crénelage est 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.
  • JPEGUtilisez 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 très 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 votre 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 tenter d'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.Vous décidez de la qualité d’image que vous considérez acceptable. 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 en sélectionnant le format JPEG. Une taille de tuile réduite implique un téléchargement plus rapide.
  • MIXEDUn paquetage mixte utilise le format JPEG 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 à tous les endroits 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 votre image, aux endroits où elle est superposée à l'autre paquetage.
String
level_of_detail

L’échelle maximale à laquelle les tuiles sont générées pour le paquetage. La valeur par défaut est 1. Les valeurs possibles sont comprises entre 1 et 24.

Les valeurs plus grandes reflètent des échelles plus grandes qui affichent plus de détails mais occupent un plus grand espace de stockage, tandis que les valeurs plus petites reflètent des échelles plus petites qui affichent moins de détails et occupent un plus petit espace de stockage.

Cette valeur doit être supérieure ou égale à min_level_of_detail.

Long
service_file
(Facultatif)

Le nom du service de carte ou des fichiers XML à utiliser pour la structure de tuile. Ce paramètre est requis uniquement lorsque le paramètre service_type est défini sur EXISTING.

MapServer; 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 le format JPEG et MIXED. 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.

  • tpkLes tuiles sont stockées à l’aide du format de stockage compact. Il est pris en charge dans la plateforme ArcGIS.
  • tpkxLes tuiles sont stockées à l’aide du 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 amélioré et simplifié 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)

L’échelle minimale à laquelle les tuiles sont générées pour le paquetage. La valeur par défaut est 1. Les valeurs possibles sont comprises entre 1 et 24.

Les valeurs plus grandes reflètent des échelles plus grandes qui affichent plus de détails mais occupent un plus grand espace de stockage, tandis que les valeurs plus petites reflètent des échelles plus petites qui affichent moins de détails et occupent un plus petit espace de stockage.

Cette valeur doit être inférieure ou égale à level_of_detail.

Long

Exemple de code

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

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

import arcpy
arcpy.env.workspace = "C:/TilePackageExample" 
arcpy.CreateMapTilePackage_management("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.CreateMapTilePackage_management(m, "ONLINE", "{}.tpk".format(m.name), 
                                          "PNG8", "10")

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes