Skip To Content

Créer un paquetage de tuiles de carte

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.

Syntaxe

CreateMapTilePackage_management (in_map, service_type, output_file, format_type, level_of_detail, {service_file}, {summary}, {tags}, {extent}, {compression_quality})
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.

  • EXISTINGLa 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, votre source doit utiliser le même système de coordonnées que la carte dont vous importez la’ structure de tuilage.
  • 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. Lorsque vous sélectionnez cette structure de tuilage, le la carte source doit utiliser le système de coordonnées projetées 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 lors de l'empaquetage des 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, mais elles sont entièrement prises en charge dans tous les navigateurs.
  • 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, peut présenter un bon compromis avec une qualité du réseau linéaire acceptable et l'avantage des tailles réduites 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

Spécifie le nombre de niveaux d’échelle auxquelles les tuiles sont générées pour le paquetage. Les valeurs possibles sont comprises entre 1 et 20.

Long
service_file
(Facultatif)

Indique 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)

Indique l’étendue en saisissant manuellement les coordonnées dans le paramètre d’étendue à l’aide du format X-Min Y-Min X-Max Y-Max. Pour utiliser l'étendue d'une couche spécifique, indiquez le nom de la couche.

  • MAXOFAgrégation des entrées
  • MINOFIntersection des entrées
  • DISPLAYEtendue identique à l'affichage actuel
  • <Layer>Etendue identique à la couche spécifiée
Extent
compression_quality
(Facultatif)

Indique 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

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", m.name + ".tpk", "PNG8", "10")

Informations de licence

  • ArcGIS Desktop Basic: Oui
  • ArcGIS Desktop Standard: Oui
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes