地图服务器缓存切片方案转换为面 (制图)

描述

根据现有切片方案创建新面要素类。

此工具使用与现有地图服务缓存切片方案相同的比例对地图范围进行细分,并在较大区域上创建切片或创建超级切片。由于超级切片范围大于方案中所定义的实际切片,切片标注转注记工具使用切片作为输入,一次可在更大区域上将标注转换为注记。此过程将各切片间注记重复的可能性降至最低。

使用方法

  •  可以使用几种不同的方法来加载现有切片方案:

    • 加载来自在线地图服务(如 ArcGIS Online、Google 地图、Bing 地图或 Yahoo 等等)的切片方案。这些切片方案将保存在 ArcGIS Pro 安装目录下的 Resources\TilingSchemes 文件夹中。
    • 加载来自现有地图服务缓存的切片方案文件。所有地图缓存在缓存目录中都有一个切片方案文件 conf.xml(例如 C:\arcgisserver\arcgiscache\MyService\MyDataFrame\conf.xml)。
    • 创建自定义切片方案文件。有关详细信息,请参阅 ArcGIS Server 帮助中的可用的地图缓存属性

  • 此工具的输出要素类可用作切片标注转注记工具的输入。

  • 对于在坐标系视域内裁剪切片参数,坐标系视域是特定地理坐标系或投影坐标系的有效使用区域。

语法

arcpy.cartography.MapServerCacheTilingSchemeToPolygons(input_map, tiling_scheme, output_feature_class, use_map_extent, clip_to_horizon, {antialiasing}, {levels})
参数说明数据类型
input_map

要使用的当前地图。

Map
tiling_scheme

预定义切片方案 .xml 文件的路径。

File
output_feature_class

输出面要素类。

Feature Class
use_map_extent

选择是要为切片方案的整个范围生成切片还是仅生成与地图全图范围相交的切片。

  • USE_MAP_EXTENT将为地图的全图范围创建面要素。这是默认设置。
  • FULL_TILING_SCHEME为切片方案的全图范围创建面要素。
Boolean
clip_to_horizon

选择是否将面限制到地图的地理坐标系或投影坐标系的有效使用区域内。

  • CLIP_TO_HORIZON仅在地图的地理坐标系或投影坐标系的有效使用区域内创建面要素。位于切片方案范围内但位于坐标系视域范围外的切片将被裁剪。这是默认设置。
  • UNIFORM_TILE_SIZE为切片方案的全图范围创建面要素。在每个比例级别内,面将具有相同的大小,且不会在坐标系视域中被裁剪。这可能会在地理坐标系或投影坐标系的有效使用区域之外创建数据。如果使用切片方案中的某一比例将生成大于要素类的空间域的切片,则将为该要素创建空几何。
Boolean
antialiasing
(可选)

选择是否生成与启用了抗锯齿功能的地图服务缓存相匹配的面。启用抗锯齿功能的地图服务缓存超级切片为 2048 x 2048 像素,而未启用抗锯齿功能的超级切片为 4096 x 4096 像素。要查看现有缓存中是否启用了抗锯齿功能,请打开切片方案文件 conf.xml 并查看 <Antialiasing> 标记是否已设置为 true。

  • ANTIALIASING创建与启用了抗锯齿功能的地图服务缓存的超级切片范围相匹配的面切片。
  • NONE创建与未启用抗锯齿功能的地图服务缓存的超级切片范围相匹配的面切片。这是默认设置。
Boolean
levels
[level,...]
(可选)

创建面将使用的比例级别。要使用切片方案中包含的所有比例级别创建面,请将此参数留空。可选择使用切片方案中所包含的全部或部分比例级别来创建面。但如果要添加更多比例级别,则需要修改切片方案文件或创建新的切片方案文件。

Double

代码示例

MapServerCacheTilingSchemeToPolygons 示例(Python 窗口)

以下独立脚本演示了如何使用 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")
MapServerCacheTilingSchemeToPolygons 示例 2(工作流脚本)

以下脚本演示了使用 MapServerCacheTilingSchemeToPolygons 函数和 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)

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题