Structure de tuilage du cache de serveur de carte en polygones (Cartographie)

Synthèse

Crée une classe d'entités surfaciques à partir d'une structure de tuilage existante.

Cet outil subdivise une étendue de la carte à l’aide des mêmes échelles qu’une structure de tuilage de cache de service de carte existante et crée des tuiles sur une grande surface, ou super tuile. Comme l’étendue de la super tuile est plus grande que les tuiles réelles définies dans la structure, les tuiles utilisées en tant qu’entrées pour l’outil Étiquettes tuilées en annotations peuvent convertir en même temps des étiquettes en annotations sur une plus grande surface. Ce processus réduit la duplication d'annotations sur plusieurs tuiles.

Utilisation

  • Plusieurs options de chargement d'une structure de tuilage existante sont disponibles :

    • Chargement d'une structure de tuilage à partir d'un service de carte en ligne comme ArcGIS Online, Google Maps, Bing Maps ou Yahoo. Ces structures de tuilage se trouvent dans le répertoire d’installation de ArcGIS Pro, dans le sous-dossier Resources\TilingSchemes.
    • Chargement d’un fichier de structure de tuilage à partir d’un cache de service de carte existant. Tous les caches de carte disposent d’un fichier de structure de tuilage, conf.xml, dans le répertoire de cache (par exemple, C:\arcgisserver\arcgiscache\MyService\MyDataFrame\conf.xml).
    • Vous pouvez créer votre propre fichier de structure de tuile à l'aide de l'outil Générer la structure de tuilage pour le cache du serveur de carte.

  • La classe d’entités en sortie de cet outil peut être utilisée comme entrée dans l’outil Étiquettes tuilées en annotations.

  • Pour le paramètre Créer des polygones dans les limites du système de coordonnées, l’horizon du système de coordonnées est la zone valide d’utilisation pour un système de coordonnées géographiques ou projetées particulier.

Paramètres

ÉtiquetteExplicationType de données
Carte en entrée

Carte actuelle à utiliser.

Map
Structure de tuilage

Un fichier .xml de structure de tuilage prédéfinie.

File
Classe d’entités en sortie

Classe d'entités surfaciques en sortie.

Feature Class
Créer des polygones qui intersectent l'étendue de la carte

Indique si des entités surfaciques seront créées pour toute l’étendue de la structure de tuilage ou uniquement pour les tuiles qui intersectent la totalité de l’étendue de la carte.

  • Activé : des entités surfaciques sont créées pour la vue générale de la carte. Il s’agit de l’option par défaut.
  • Désactivé : des entités surfaciques sont créées pour la vue générale de la structure de tuilage.
Boolean
Créer des polygones dans les limites du système de coordonnées

Indique si les polygones seront contraints à la surface d’utilisation valide pour le système de coordonnées géographiques ou projetées de la carte.

  • Activé : des entités surfaciques sont créées uniquement dans la surface d’utilisation valide pour le système de coordonnées géographiques ou projetées de la carte. Les tuiles qui sont dans l’étendue de la structure de tuilage, mais à l’extérieur de l’étendue de l’horizon du système de coordonnées, sont découpées. Il s’agit de l’option par défaut.
  • Désactivé : des entités surfaciques sont créées pour la vue générale de la structure de tuilage. À chaque niveau d’échelle, les polygones sont de taille uniforme et ne sont pas découpés à l’horizon du système de coordonnées. Cela peut créer des données qui sont à l’extérieur de la surface d’utilisation valide pour le système de coordonnées géographiques ou projetées. Si une échelle dans la structure de tuilage génère une tuile qui est plus grande que le domaine spatial de la classe d'entités, une géométrie nulle sera créée pour cette entité.
Boolean
Créer des polygones qui correspondent aux caches du service de carte avec l'anti-crénelage activé
(Facultatif)

Indique si les polygones correspondant à des caches de service de carte avec anti-crénelage activé seront créés. Une super tuile de cache de service de carte correspond à 2048 x 2048 pixels avec anti-crénelage ou à 4096 x 4096 pixels sans anti-crénelage. Pour savoir si l’anti-crénelage a été utilisé dans un cache existant, ouvrez le fichier de structure de tuilage conf.xml et regardez si la balise <Anti-crénelage> est définie sur Vrai.

  • Activé : des tuiles polygones correspondant à l'étendue de super tuile d'un cache de service de carte avec anti-crénelage activé seront créées.
  • Désactivé : des tuiles polygones correspondant à l’étendue de super tuile d’un cache de service de carte sans anti-crénelage activé sont créées. Il s’agit de l’option par défaut.
Boolean
Échelles
(Facultatif)

Niveaux d’échelle auxquels les polygones seront créés. Ces niveaux d’échelle sont automatiquement renseignés en fonction des niveaux d’échelle de la structure de tuilage en entrée. Vous pouvez créer des polygones pour tous les niveaux d’échelle inclus dans votre structure de tuilage ou seulement quelques-uns. Toutefois, pour ajouter d’autres niveaux d'échelle, vous devez modifier votre fichier de structure de tuilage ou en créer un, car le bouton Ajouter une valeur n’est pas disponible pour cet outil.

Double

arcpy.cartography.MapServerCacheTilingSchemeToPolygons(input_map, tiling_scheme, output_feature_class, use_map_extent, clip_to_horizon, {antialiasing}, {levels})
NomExplicationType de données
input_map

Carte actuelle à utiliser.

Map
tiling_scheme

Un fichier .xml de structure de tuilage prédéfinie.

File
output_feature_class

Classe d'entités surfaciques en sortie.

Feature Class
use_map_extent

Indique si des entités surfaciques seront créées pour toute l’étendue de la structure de tuilage ou uniquement pour les tuiles qui intersectent la totalité de l’étendue de la carte.

  • USE_MAP_EXTENTDes entités surfaciques sont créées pour la vue générale de la carte. Il s’agit de l’option par défaut.
  • FULL_TILING_SCHEMEDes entités surfaciques sont créées pour l’étendue complète de la structure de tuilage.
Boolean
clip_to_horizon

Indique si les polygones seront contraints à la surface d’utilisation valide pour le système de coordonnées géographiques ou projetées de la carte.

  • CLIP_TO_HORIZONDes entités surfaciques sont créées uniquement dans la surface d’utilisation valide pour le système de coordonnées géographiques ou projetées de la carte. Les tuiles qui sont dans l’étendue de la structure de tuilage, mais à l’extérieur de l’étendue de l’horizon du système de coordonnées, sont découpées. Il s’agit de l’option par défaut.
  • UNIFORM_TILE_SIZEDes entités surfaciques sont créées pour l’étendue complète de la structure de tuilage. À chaque niveau d’échelle, les polygones sont de taille uniforme et ne sont pas découpés à l’horizon du système de coordonnées. Cela peut créer des données qui sont à l’extérieur de la surface d’utilisation valide pour le système de coordonnées géographiques ou projetées. Si une échelle dans la structure de tuilage génère une tuile qui est plus grande que le domaine spatial de la classe d'entités, une géométrie nulle sera créée pour cette entité.
Boolean
antialiasing
(Facultatif)

Indique si les polygones correspondant à des caches de service de carte avec anti-crénelage activé seront créés. Une super tuile de cache de service de carte correspond à 2048 x 2048 pixels avec anti-crénelage ou à 4096 x 4096 pixels sans anti-crénelage. Pour savoir si l’anti-crénelage a été utilisé dans un cache existant, ouvrez le fichier de structure de tuilage conf.xml et regardez si la balise <Anti-crénelage> est définie sur Vrai.

  • ANTIALIASINGDes tuiles polygones correspondant à l'étendue de super tuile d'un cache de service de carte avec anti-crénelage activé seront créées.
  • NONEDes tuiles polygones correspondant à l’étendue de super tuile d’un cache de service de carte sans anti-crénelage activé sont créées. Il s’agit de l’option par défaut.
Boolean
levels
[level,...]
(Facultatif)

Niveaux d’échelle auxquels les polygones seront créés. Pour créer des polygones pour tous les niveaux d’échelle inclus dans une structure de tuilage, laissez ce paramètre vierge. Vous pouvez créer des polygones pour tous les niveaux d’échelle inclus dans votre structure de tuilage ou seulement quelques-uns. Toutefois, pour ajouter d'autres niveaux d'échelle, vous devrez modifier votre fichier de structure de tuilage ou en créer un.

Double

Exemple de code

Exemple 1 d’utilisation de la fonction MapServerCacheTilingSchemeToPolygons (fenêtre Python)

Le script autonome ci-dessous illustre l’utilisation de la fonction MapServerCacheTilingSchemeToPolygons.


import arcpy
import os

arcpy.env.workspace = "C:/data/data.gdb"
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
      "C:/data/Annotation.mxd", os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                                             'Resources\\TilingSchemes\\WGS84_Geographic_Coordinate_System_V2.xml'), 
      "Tiles", "USE_MAP_EXTENT", "CLIP_TO_HORIZON", "NONE")
Exemple 2 d’utilisation de l'outil MapServerCacheTilingSchemeToPolygons (script de processus)

Le script suivant présente un processus faisant appel aux fonctions MapServerCacheTilingSchemeToPolygons et TiledLabelsToAnnotation.

# Name: MapServerCacheTilingSchemeToPolygons_Example2.py
# Description: Create a tile feature class and use those tiles to create annotation.
# Requirements: ArcGIS Desktop Advanced license

# Import system modules
import arcpy
import os

# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"

# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
# Change path below to match your system
inTilingScheme = os.path.join(arcpy.GetInstallInfo()['InstallDir'], 
                              'Resources\\TilingSchemes\\ArcGIS_Online_Bing_Maps_Google_Maps.xml'),
outFeatureClass = "C:/data/data.gdb/Tiles"
inTileExtent = "USE_MAP_EXTENT"
inClipping = "CLIP_TO_HORIZON"
inAntialiasing = "NONE"
inScales = ""

# Execute MapServerCacheTilingSchemeToPolygons
arcpy.MapServerCacheTilingSchemeToPolygons_cartography(
    inMapDocument, inTilingScheme, outFeatureClass, 
    inTileExtent, inClipping, inAntialiasing, inScales)

# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
inPolygonIndexLayer = "Tiles"
inOutGeodatabase = "C:/data/data.gdb"
outOutLayer = "GroupAnno"
inAnnoSuffix = "Anno"
inRefScaleValue = ""
inRefScaleField = "Tile_Scale"
inTileIDField = "OID"
inCoordSysField = ""
inMapRotationField = ""
inFeatureLinked = "STANDARD"
inGenerateUnplaced = "GENERATE_UNPLACED_ANNOTATION"

# Execute TiledLabelsToAnnotation
arcpy.TiledLabelsToAnnotation_cartography(
    inMapDocument, inPolygonIndexLayer, inOutGeodatabase, 
    outOutLayer, inAnnoSuffix, inRefScaleValue, inRefScaleField, 
    inTileIDField, inCoordSysField, inMapRotationField,inFeatureLinked, 
    inGenerateUnplaced)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

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

Rubriques connexes