Résumé
Crée une classe d'entités surfaciques à partir d'une structure de tuilage existante.
Cet outil subdivise une étendue de bloc de données à 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 dossier TilingSchemes du répertoire d’installation de ArcGIS Desktop.
- 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).
- Création de votre propre fichier de structure de tuilage. Pour plus d’informations, reportez-vous à la rubrique Propriétés de cache de carte disponibles de l’aide ArcGIS Server.
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.
Syntaxe
arcpy.cartography.MapServerCacheTilingSchemeToPolygons(map_document, data_frame, tiling_scheme, output_feature_class, use_map_extent, clip_to_horizon, {antialiasing}, {levels})
Paramètre | Explication | Type de données |
map_document | Document ArcMap source. | ArcMap Document |
data_frame | Bloc de données du document ArcMap source. | String |
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 du bloc de données.
| 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 du bloc de données.
| 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.
| 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", "Layers",
os.path.join(arcpy.GetInstallInfo()['InstallDir'],
'TilingSchemes\\ArcGIS_Online_Bing_Maps_Google_Maps.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
# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"
# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
inDataFrame = "Layers"
# Change path below to match your system
inTilingScheme = os.path.join(arcpy.GetInstallInfo()['InstallDir'],
'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, inDataFrame, inTilingScheme, outFeatureClass,
inTileExtent, inClipping, inAntialiasing, inScales)
# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
inDataFrame = "Layers"
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, inDataFrame, 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