Map Server Cache Tiling Scheme To Polygons (Cartography)

License Level:BasicStandardAdvanced

Summary

Creates a new polygon feature class from an existing tiling scheme.

This tool subdivides a data frame extent using the same scales as an existing map service cache tiling scheme and creates tiles over a large area, or "supertile". Since the supertile extent is larger than the actual tiles defined in the scheme, tiles used as input into the Tiled Labels to Annotation tool can convert labels to annotation over a larger area at a time. This process minimizes annotation duplication across tiles.

Usage

Syntax

MapServerCacheTilingSchemeToPolygons_cartography (map_document, data_frame, tiling_scheme, output_feature_class, use_map_extent, clip_to_horizon, {antialiasing}, {levels})
ParameterExplanationData Type
map_document

The source map document.

ArcMap Document
data_frame

The data frame from the source map document.

String
tiling_scheme

Path to a predefined tiling scheme .xml file.

File
output_feature_class

The output polygon feature class.

Feature Class
use_map_extent

Choose whether to produce tiles for the entire extent of the tiling scheme or only tiles that intersect the full extent of the data frame.

  • USE_MAP_EXTENTPolygon features will be created for the full extent of the data frame. This is the default.
  • FULL_TILING_SCHEMEPolygon features will be created for the full extent of the tiling scheme.
Boolean
clip_to_horizon

Choose whether to constrain the polygons to the valid area of use for the geographic or projected coordinate system of the data frame.

  • CLIP_TO_HORIZONPolygon features will only be created within the valid area of use for the geographic or projected coordinate system of the data frame. Tiles that are within the extent of the tiling scheme but outside the extent of the coordinate system horizon will be clipped. This is the default.
  • UNIFORM_TILE_SIZEPolygon features will be created for the full extent of the tiling scheme. Within each scale level, polygons will be of a uniform size and will not be clipped at the coordinate system horizon. This may create data that is outside the valid area of use for the geographic or projected coordinate system. If a scale within the tiling scheme would generate a tile that is larger than the spatial domain of the feature class, null geometry will be created for that feature.
Boolean
antialiasing
(Optional)

Choose whether to generate polygons that match map service caches with anti-aliasing enabled. A map service cache supertile is 2048 x 2048 pixels with antialiasing or 4096 x 4096 pixels without. To see if antialiasing was used in an existing cache, open the tiling scheme file, conf.xml, and check to see if the <Antialiasing> tag is set to true.

  • ANTIALIASINGPolygon tiles will be created to match the supertile extent of a map service cache with antialiasing enabled.
  • NONEPolygon tiles will be created to match the supertile extent of a map service cache without antialiasing enabled. This is the default.
Boolean
levels
[level,...]
(Optional)

The scale levels at which you will create polygons. To create polygons for all scale levels included in a tiling scheme, leave this parameter blank. You may choose to create polygons for all or only some of the scale levels that are included in your tiling scheme. To add additional scale levels, however, you will need to modify your tiling scheme file or create a new one.

Double

Code Sample

MapServerCacheTilingSchemeToPolygons Example (Python Window)

The following stand-alone script demonstrates how to use the MapServerCacheTilingSchemeToPolygons function.

import arcpy
from arcpy import env
env.workspace = "C:/data/data.gdb"
arcpy.MapServerCacheTilingSchemeToPolygons_cartography("C:/data/Annotation.mxd", 
"Layers", 
"C:/Program Files/ArcGIS/Desktop10.1/TilingSchemes/ArcGIS_Online_Bing_Maps_Google_Maps.xml",
"Tiles","USE_MAP_EXTENT","CLIP_TO_HORIZON", "NONE", "")
MapServerCacheTilingSchemeToPolygons Example2 (workflow script)

The following script demonstrates a workflow using the MapServerCacheTilingSchemeToPolygons and the TiledLabelsToAnnotation functions.

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

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inMapDocument = "C:/data/Annotation.mxd"
inDataFrame = "Layers"
inTilingScheme = "C:/Program Files/ArcGIS/Desktop10.1/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)

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
10/25/2012