ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • 帮助
  • Sign Out
ArcGIS Desktop

ArcGIS Online

专为贵组织打造的制图平台

ArcGIS Desktop

全面的专业性 GIS

ArcGIS Enterprise

面向企业的 GIS

ArcGIS Developers

用于构建位置感知应用程序的工具

ArcGIS Solutions

适用于行业的免费模板地图和应用程序

ArcGIS Marketplace

获取适用于组织的应用程序和数据

  • 文档
  • 支持
Esri
  • 登录
user
  • 我的个人资料
  • 登出

ArcMap

  • 主页
  • 入门
  • 地图
  • 分析
  • 管理数据
  • 工具
  • 扩展模块

Layer

  • 描述
  • 讨论
  • 语法
  • 属性
  • 方法概述
  • 方法
  • 代码示例

描述

用于对图层的属性和方法进行访问。它可以引用地图文档 (.mxd) 或图层 (.lyr) 文件中的图层。

讨论

对于管理地图文档 (.mxd) 或图层 (.lyr) 文件中的图层来说,图层对象是必不可少的。图层对象提供了对 ArcMap 图层属性对话框中出现的众多常用图层属性的访问,同时也提供了用于保存图层文件的各种方法。Legend 对象中的 Layer 函数、ListLayers 函数和 listLegendItemLayers 方法都提供了引用 Layer 对象的方法。

图层类型千差万别,所支持的属性集也并不都一样。例如,要素图层支持定义查询,而栅格图层不支持,但栅格目录支持。supports 方法可用于帮助识别图层类型与图层属性之间的支持关系,从而无需在各种不同的图层对象中查找所有可能的图层类型与属性的组合。如果不知道图层类型是否支持该属性,在试图获取或设置其属性值之前,supports 方法可用于测试该图层是否支持这一属性,从而可减少不必要的错误信息。

从本质上来说,地图文档中存在三种类别的图层:要素图层、组图层和栅格图层。通过 isFeatureLayer、isGroupLayer 和 isRasterLayer 属性,您可以标识或分离出主要的图层类型,但并非全部。还有少数专题图层和数据集并不属于这三种类别:注记子类、尺寸要素、网络数据集、terrain 数据集、拓扑数据集等。这种情况下,对所关注的图层执行操作前,您需要先测试其他属性以分离该图层。

并非所有的图层属性都可通过 Layer 对象进行访问。ArcMap 图层属性对话框中所列属性中有许多并未提供给 arcpy 脚本环境(例如,显示属性、字段别名、选择内容的符号系统等)。通过 UpdateLayer 函数,您可以使用包含自定义信息的图层文件 (.lyr) 替换 ArcMap 图层属性对话框中列出的所有图层属性。

图层组和其他子图层(例如,注记类)将被视为普通图层。ListLayers 函数将返回按图层在内容列表中的显示顺序或在图层 (.lyr) 文件中的显示顺序从上至下生成的索引值。以上规则也适用于嵌套的图层组。例如,如果地图文档中包含一个内含三个子图层的图层组,则它将返回一个包含四个图层名的列表,图层组的名称作为第一项,子图层的名称依次为第二、第三、第四项。有两种方式用于确定某个图层是否为图层组。第一种方式,可以查看该图层是否支持 isGroupLayer 属性。第二种方式,可以评估 longName 属性。图层的 longName 属性值除了图层名称外还包括组名称。例如,在一个名称为 Group1 的图层组中,名称为 Layer1 的图层的 longName 值是 Group1\Layer1。如果 name 值与 longName 的值相同,则表示该图层不是图层组或该图层不在图层组内。

由于用户名和密码信息未保存在图层文件内或地图文档内,所以地图文档或图层文件内的一些图层可能受密码保护。打开包含这些图层的地图文档时将会提示用户输入相应的信息。默认情况下,arcpy.mapping 脚本环境将在执行过程中禁止使用这些对话框,但这意味着这些图层的数据源将被视为已经损坏。换言之,受保护的图层将不会在任何输出中进行渲染。如果希望适当地渲染这些图层,则应采取如下做法。首先,将用户名和密码信息随图层一同保存。其次,使用 CreateDatabaseConnection 地理处理函数创建一个同样保留在内存中的连接文件。如果在使用 MapDocument 函数打开地图文档 (.mxd) 或使用 Layer 函数打开图层文件之前执行此函数,则将渲染地理数据库图层。目前尚没有针对受保护 Web 服务的操作方法。

引用磁盘上的图层文件 (.lyr) 的变量将锁定该文件。最好在脚本结尾或在 Python try/except 语句中使用 Python del 命令移除对象引用。

通常会需要您更改图层的数据源。Layer 对象中有两种方法可以实现此目的。findAndReplaceWorkspacePath 方法用于替换部分或全部的图层工作空间路径。replaceDataSource 方法用于更改图层的工作空间或源数据集。有关详细说明、参数信息、案例和编码示例,请参阅使用 arcpy.mapping 更新和修复数据源帮助主题。

根据符号系统的类型,您可以修改图层的符号系统。只有极少数受支持的符号系统类型,其属性和方法可供使用。最好先测试图层的 symbologyType 属性。如果返回 OTHER 值,则不可以修改图层的符号系统。如果返回值不是 OTHER,则图层的 symbology 属性将返回以下某个符号系统类,每个符号系统类都包含一组特有的方法和属性:GraduatedColorsSymbology、GraduatedSymbolsSymbology、RasterClassifiedSymbology 和 UniqueValuesSymbology。

可以对启用时间的图层执行时间管理操作。并非所有的图层类型都支持时间属性。因此,最好首先使用 supports 方法测试图层是否支持时间。如果图层支持时间,则可从 LayerTime 类访问时间属性。

语法

 Layer (lyr_file_path)
参数说明数据类型
lyr_file_path

包含现有图层 (.lyr) 文件的完整路径和文件名的字符串。

String

属性

属性说明数据类型
brightness
(可读写)

用于获取或设置亮度值。默认的正常亮度是 0%。输入 +100% 和 -100% 之间的任意值。在值的左侧输入加号或减号以指定该值是大于零还是小于零。并非所有图层都支持 brightness 属性(例如,组图层和要素图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

Integer
contrast
(可读写)

用于获取或设置对比度值。默认的中性对比度是 0%。输入 +100% 和 -100% 之间的任意值。在值的左侧输入加号或减号以指定该值是大于零还是小于零。并非所有图层都支持 contrast 属性(例如,注记图层和结构图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

Integer
credits
(可读写)

用于获取或设置图层的制作者名单或版权信息。

String
datasetName
(只读)

以图层数据集在工作空间(非 TOC)中显示的方式返回其名称。并非所有图层都支持 datasetName 属性(例如,web 服务),因此值得提倡的做法是使用 supports 方法预先进行测试。

String
dataSource
(只读)

返回图层数据源的完整路径。包括 workspacePath 和 datasetName 属性的组合。并非所有图层都支持 dataSource 属性(例如,注记类和 web 服务),因此值得提倡的做法是使用 supports 方法预先进行测试。

String
definitionQuery
(可读写)

用于获取或设置图层的定义查询。并非所有图层都支持 definitionQuery 属性(例如,栅格图层和组图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

String
description
(可读写)

用于获取或设置图层的描述信息。并非所有图层都支持 description属性(例如,拓扑图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

String
isBasemapLayer
(只读)

如果图层是底图图层,则返回 True。

Boolean
isBroken
(只读)

如果图层的数据源损坏,则返回 True。

Boolean
isFeatureLayer
(只读)

如果图层是要素图层,则返回 True。

Boolean
isGroupLayer
(只读)

如果图层是图层组,则返回 True。

Boolean
isNetworkAnalystLayer
(只读)

如果图层是 ArcGIS Network Analyst extension 图层类型,则返回 True。

Boolean
isNetworkDatasetLayer
(只读)

如果图层是 ArcGIS Network Analyst extension 网络数据集图层类型,则返回 True。

Boolean
isRasterizingLayer
(只读)

如果在打印或导出地图时,图层导致数据框中其他矢量图层栅格化,则返回 True。输出过程中的矢量图层栅格化在使用了图层透明度时最易于发生,但当图层具有基于栅格的图片符号或基于字段的透明度时也可发生此现象。

Boolean
isRasterLayer
(只读)

如果图层是栅格图层,则返回 True。

Boolean
isServiceLayer
(只读)

如果图层是 GIS 服务图层,则返回 True。GIS 服务是自动化的地理信息服务,可以使用标准技术和协议在 Web 上对其进行发布和访问。

Boolean
labelClasses
(可读写)

通过返回 LabelClass 对象的列表,提供对图层的标注类属性的访问。各个 LabelClass 对象属性可被读取和修改以及写回到图层。并非所有图层都支持 labelClasses 属性(例如,栅格图层和注记图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

LabelClass
longName
(只读)

当试图确定图层是否属于图层组时,此属性十分有用。如果图层不属于图层组,则长名称等于图层名称。如果图层属于图层组,则图层组结构将包含在长名称中。例如,与另一图层组一同嵌套在某个图层组中的图层名称可能为 Group1\Group2\LayerName。所有图层类型都支持此属性。

String
maxScale
(可读写)

用于设置或获取图层的最大比例阈值。

Double
minScale
(可读写)

用于设置或获取图层的最小比例阈值。

Double
name
(可读写)

用于以图层在 ArcMap 内容列表中显示的方式设置或获取图层名称。可包含空格。所有图层类型都支持此属性。

String
serviceProperties
(只读)

提供对 ArcSDE 和 web 服务图层的连接信息的访问。返回的结果是字典键值对。根据图层类型,会返回两种不同的字典。第一种针对 ArcSDE 连接,第二种针对所有 Web 服务图层类型。Web 服务字典包含可用于所有服务图层类型的键,也包含仅用于特定 web 服务类型(例如,WMS 具有称作 WMSTitle 的键)的特定键。既可在评估特定键之前用脚本检查 ServiceType 键,也可使用 get 方法绕过不可用的键。并非所有图层都支持 serviceProperties 属性(例如,除 ArcSDE 或 web 服务图层以外的图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

ArcSDE 字典的键

  • ServiceType —此属性显示服务类型。只能是 ArcSDE 图层类型的 SDE。
  • Server —ArcSDE 地理数据库所在的计算机的名称或 IP 地址。
  • Service —运行在 ArcSDE 服务器上的进程的名称或端口号。
  • Database —企业级 RDBMS 数据库的名称。使用 Oracle 时不需要此属性。
  • UserName —用户帐户。如果使用操作系统身份验证,则此属性为空。
  • AuthenticationMode —地理数据库或操作系统身份验证。
  • Version —要连接的地理数据库的版本。

Web 服务字典的键

  • ServiceType —此属性显示服务类型。包括 ImageServer、IMS、MapServer、TiledInternetLayer、WMS 和 WCS。
  • URL —此属性显示服务对应的 URL。如果通过局域网 (LAN) 与 ArcGIS for Server 连接,则此值为空。
  • Server —此属性显示服务器名称。如果通过 Internet (HTTP) 与 ArcGIS for Server 连接,则此值为空。
  • UserName —此属性显示用来访问受保护服务的用户名称。如果服务不受密码保护,则此属性为空。
  • ServiceName —仅 IMS 服务图层。此属性显示 IMS 服务的名称。
  • WMSName —仅 WMS 服务图层。此属性显示用于计算机对计算机通信的 WMS 服务的文本字符串。
  • WMSTitle —仅 WMS 服务图层。此属性显示 WMS 服务的描述标题字符串。
  • Name —仅 WMS 服务图层。此属性显示用于计算机对计算机通信的 WMS 图层的文本字符串。
  • Title —仅 WMS 服务图层。此属性显示 WMS 图层的描述标题字符串。
Dictionary
showLabels
(可读写)

控制图层标注的显示。如果设置为 True,则显示标注;如果设置为 False,则不会绘制标注。并非所有图层都支持 showLabels 属性(例如,栅格图层和注记图层),因此值得提倡的做法是使用 supports 方法预先进行测试。支持 showLabels 属性的图层类型也支持 labelClasses 属性。

Boolean
symbology
(只读)

返回对图层符号系统类的引用。每个受支持的图层符号系统类都有自己唯一的属性集。在尝试修改符号系统类属性前,最好首先确定图层的 symbologyType。

Object
symbologyType
(只读)

返回表示图层的符号系统类类型的字符串。并非所有图层符号系统类类型均受支持;对于那些不受支持的类型,返回关键字 OTHER。以下是可能值列表:

  • GRADUATED_COLORS —GraduatedColorsSymbology 类。
  • GRADUATED_SYMBOLS —GraduatedSymbolsSymbology 类。
  • OTHER —表示不受支持的图层符号系统类的字符串。
  • UNIQUE_VALUES —UniqueValuesSymbology 类。
  • RASTER_CLASSIFIED —栅格图层的 RasterClassifiedSymbology 类。
Object
time
(只读)

返回 LayerTime 类,此类用于访问已启用时间的图层的时间属性。

Object
transparency
(可读写)

用于获取或设置透明度值。这使您可以透过一个图层看到下方的图层。如果不想使图层透明,则输入 0。大于 90% 的透明度值经常导致图层几乎未被绘制。并非所有图层都支持 transparency 属性(例如,结构组图层和 web 服务子图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

Integer
visible
(可读写)

控制图层的显示。这与选中 ArcMap 内容列表中图层旁边的复选框具有相同的效果。如果设置为 True,则绘制图层;如果设置为 False,则不绘制图层。并非所有图层都支持 visible 属性(例如,被限制的 web 服务图层),因此值得提倡的做法是使用 supports 方法预先进行测试。

Boolean
workspacePath
(只读)

返回图层的工作空间或连接文件路径。并非所有图层都支持 workspacePath 属性(例如,web 服务),因此值得提倡的做法是使用 supports 方法预先进行测试。

String

方法概述

方法说明
findAndReplaceWorkspacePath (find_workspace_path, replace_workspace_path, {validate})

查找图层的工作空间路径并替换为新工作空间路径。

getExtent ({symbolized_extent})

返回图层的几何或符号化范围。

getSelectedExtent ({symbolized_extent})

返回所选要素的图层几何或符号化范围。

getSelectionSet ()

以 Python 对象 ID 集的形式返回图层选择。

replaceDataSource (workspace_path, workspace_type, {dataset_name}, {validate})

为地图文档 (.mxd) 或图层 (.lyr) 文件中的图层替换数据源。其提供转换工作空间类型的能力(例如,用 SDE 数据源替换文件地理数据库数据源)。

save ()

保存图层 (.lyr) 文件。

saveACopy (file_name, {version})

将图层 (.lyr) 文件另存为其他文件名称,或较早版本。

setSelectionSet (method, oidList)

使用 Python 对象 ID 集设置图层选择。

supports (layer_property)

并非所有图层都支持相同的属性集。supports 属性可用来测试图层支持的属性。

updateLayerFromJSON (json_layer_definition)

根据 JSON 字符串更新图层。

方法

findAndReplaceWorkspacePath (find_workspace_path, replace_workspace_path, {validate})
参数说明数据类型
find_workspace_path

用于表示要查找的工作空间路径或连接文件的字符串。如果传递了空字符串,则将根据 validate 参数的值将所有工作空间路径替换为 replace_workspace_path 参数。

String
replace_workspace_path

用于表示要替换的工作空间路径或连接文件的字符串。

String
validate

如果设置为 True,则仅在 replace_workspace_path 值为有效工作空间时,才会更新工作空间。如果为无效工作空间,则不会替换该工作空间。如果设置为 False,则无论匹配是否有效,此方法都会将工作空间设置为匹配 replace_workspace_path。在这种情况下,如果匹配不存在,则将损坏图层的数据源。

(默认值为 True)

Boolean

有关详细说明、参数信息、案例和编码示例,请参阅使用 arcpy.mapping 更新和修复数据源帮助主题。

getExtent ({symbolized_extent})
参数说明数据类型
symbolized_extent

如果值为 True,将返回图层的符号化范围;否则将返回几何范围。符号化范围会将符号覆盖的区域考虑在内,因此该区域不会被数据框边界切掉。

(默认值为 True)

Boolean

返回值

数据类型说明
Extent

getExtent 方法将支持图层定义查询,因此如果查询了要素子集,则 getExtent 将只返回这些要素的范围。

在构建范围矩形时,符号化范围会考虑要素符号的面积。返回符号化范围可能最适合制图结果,因为不会切断数据框边缘的符号。几何范围可能最适合分析。

getSelectedExtent ({symbolized_extent})
参数说明数据类型
symbolized_extent

如果值为 True,将返回图层的符号化范围;否则将返回几何范围。符号化范围会将符号覆盖的区域考虑在内,因此该区域不会被数据框边界切掉。

(默认值为 True)

Boolean

返回值

数据类型说明
Extent

在构建范围矩形时,符号化范围会考虑要素符号的面积。返回符号化范围可能最适合制图结果,因为不会切断数据框边缘的符号。几何范围可能最适合分析。

getSelectionSet ()

提供检索图层当前选择的简便方式。

replaceDataSource (workspace_path, workspace_type, {dataset_name}, {validate})
参数说明数据类型
workspace_path

包含新数据或连接文件的工作空间路径的字符串。

String
workspace_type

用于表示新数据的工作空间类型的字符串关键字。

  • ACCESS_WORKSPACE — 个人地理数据库或 Access 工作空间
  • ARCINFO_WORKSPACE — ArcInfo coverage 工作空间
  • CAD_WORKSPACE —CAD 文件工作空间
  • EXCEL_WORKSPACE —Excel 文件工作空间
  • FILEGDB_WORKSPACE —文件地理数据库工作空间
  • NONE —用于跳过参数
  • OLEDB_WORKSPACE —OLE 数据库工作空间
  • PCCOVERAGE_WORKSPACE —PC ARC/INFO Coverage 工作空间
  • RASTER_WORKSPACE —栅格工作空间
  • SDE_WORKSPACE —SDE 地理数据库工作空间
  • SHAPEFILE_WORKSPACE —shapefile 工作空间
  • TEXT_WORKSPACE —文本文件工作空间
  • TIN_WORKSPACE —TIN 工作空间
  • VPF_WORKSPACE —VPF 工作空间
String
dataset_name

用于表示数据集在新工作空间中显示的名称(而非 TOC 中的图层名称)的字符串。如果未提供 dataset_name,则 replaceDataSource 方法将尝试通过查找与图层的当前数据集属性具有相同名称的表来替换数据集。

String
validate

如果设置为 True,则仅在 workspace_path 值为有效工作空间时,才会更新工作空间。如果为无效工作空间,则不会替换该工作空间。如果设置为 False,则无论匹配是否有效,此方法都会将源设置为匹配 workspace_path。在这种情况下,如果匹配不存在,则将损坏数据源。

(默认值为 True)

Boolean

有关详细说明、参数信息、案例和编码示例,请参阅使用 arcpy.mapping 更新和修复数据源帮助主题。

save ()

图层 (.lyr) 文件和地图图层(地图文档中的图层)之间存在细微的差别。只有变量引用了图层文件并且不会用于地图图层时, save 方法才会有效。从图层文件加载图层时,将记住文件名并在调用 save 方法时使用此名称。如果正在引用地图图层,最初并未设置文件名,则您将需要改用 saveACopy 方法。

saveACopy (file_name, {version})
参数说明数据类型
file_name

A string that includes the location and name of the output layer (.lyr) file.

String
version

A string that sets the output version number. The default value will use the current version.

  • 10.8 —Version 10.8
  • 10.7 —Version 10.7
  • 10.6 —Version 10.6
  • 10.5 —Version 10.5
  • 10.4 —Version 10.4
  • 10.3 —Version 10.3
  • 10.1 —Version 10.1/10.2
  • 10.0 —Version 10.0
  • 9.3 —Version 9.3
  • 9.2 —Version 9.2
  • 9.0 —Version 9.0/9.1
  • 8.3 —Version 8.3

(默认值为 None)

String

可选择将图层 (.lyr) 文件另存为其他文件名称,或较早版本。 在较早版本的软件中不受支持的功能将从新保存的图层中移除。

setSelectionSet (method, oidList)
参数说明数据类型
method

用于指定要使用的选择方法的字符串。

  • NEW —从 oidList 创建一个新的要素选择。
  • DIFFERENCE —选择不在当前选择中但在 oidList 中的要素。
  • INTERSECT —选择当前选择和 oidList 中均含有的要素。
  • SYMDIFFERENCE —选择当前选择或 oidList 不含的要素。
  • UNION —选择当前选择和 oidList 中的全部要素。

(默认值为 None)

String
oidList
[oidList,...]

与适当的选择方法一起使用的 Python 对象 ID 集。

List

此方法提供管理图层选择的简便方式。要清空选择,请使用包含空集的 NEW 选择方法。Python 集或列表可用于 oidList,但会针对 Layer 对象使用 getSelectionSet 方法返回集。

supports (layer_property)
参数说明数据类型
layer_property

将要测试的特定图层属性的名称。

  • BRIGHTNESS —栅格图层的亮度值
  • CONTRAST —栅格图层的对比度值
  • DATASETNAME —在工作空间中显示的图层数据集名称
  • DATASOURCE —图层的文件路径或连接文件
  • DEFINITIONQUERY —图层的定义查询字符串
  • DESCRIPTION —图层的描述字符串
  • LABELCLASSES —图层的标注类列表
  • LONGNAME —包含可能嵌套的图层组的图层路径
  • NAME —图层的名称
  • SERVICEPROPERTIES —SDE 和 web 服务图层的连接信息
  • SHOWLABELS —指示图层的标注打开或关闭的布尔值
  • SYMBOLOGY —图层的符号系统类
  • SYMBOLOGYTYPE —图层的符号系统类类型
  • TIME —图层的时间属性
  • TRANSPARENCY —图层的透明度值
  • VISIBLE —指示 TOC 中的图层打开或关闭的布尔值
  • WORKSPACEPATH —图层的工作空间或连接文件路径

(默认值为 name)

String

返回值

数据类型说明
Boolean

图层类型多种多样,并且不是所有图层类型都支持相同的属性。例如,要素图层支持定义查询,而栅格图层不支持,但栅格目录支持。support 方法主要用于协助识别哪些图层类型支持哪些属性,而不是创建所有可能图层类型和属性组合的各个图层对象。如果您不知道图层类型是否支持此属性,在获得或设置属性值前,您可以使用 support 方法对其进行测试。如果图层支持此属性,则 supports 属性将返回 true。

updateLayerFromJSON (json_layer_definition)
参数说明数据类型
json_layer_definition

采用 JavaScript 对象表示法 (JSON) 格式的图层定义。有关详细信息,请参阅 ExportWebMap JSON 规范。通过 ArcGIS Web API(JavaScript、Flex 和 Silverlight),开发人员可以从 web 应用程序中轻松获得此 JSON 字符串。图层定义是 ConvertWebMapToMapDocument 函数中使用的 webmap_json 的子集。不需要创建 Web 地图 JSON;因为 API 会为您解决这个问题。不过,需要从完整 webmap_json 中提取图层定义。

String

此函数用于地理处理服务中,该服务在支持更改动态 Web 服务图层中的渲染器(或其他属性)的 Web 地图打印应用程序中使用 ConvertWebMapToMapDocument 函数。如果地理处理服务在运行 ConvertWebMapToMapDocument 后将服务图层替换为过渡的矢量图层,则 updateLayerFromJSON 将按照 webmap_json 中指定的渲染器(或其他图层属性)应用于在模板地图文档中过渡的相应矢量图层。有关详细信息和代码示例,请参阅 ConvertWebMapToMapDocument。

代码示例

图层示例 1

以下脚本将引用图层 (.lyr) 文件,查找名为 Highways 的所有图层,打开标注,然后将结果保存到新图层文件中。

import arcpy
lyrFile = arcpy.mapping.Layer(r"C:\Project\Data\Streets.lyr")
for lyr in arcpy.mapping.ListLayers(lyrFile):
    if lyr.name.lower() == "highways":
        lyr.showLabels = True
        lyr.saveACopy(r"C:\Project\Data\StreetsWithLabels.lyr")
del lyrFile
#Or with one less line using a wild card:
import arcpy
lyrFile = arcpy.mapping.Layer(r"C:\Project\Data\Streets.lyr")
for lyr in arcpy.mapping.ListLayers(lyrFile, "Highways"):
    lyr.showLabels = True
    lyr.saveACopy(r"C:\Project\Data\StreetsWithLabels.lyr")
del lyrFile
图层示例 2

以下脚本将在打开需要输入密码的地图文档前,通过在内存中创建地理数据库连接确保适当地渲染受保护图层。此脚本仅定义了连接信息,然后将地图文档导出为 PDF 文件。最好在关闭脚本前从内存中删除此引用。

import arcpy, os
#Remove temporary connection file if it already exists
sdeFile = r"C:\Project\Output\TempSDEConnectionFile.sde"
if os.path.exists(sdeFile):
    os.remove(sdeFile)
#Create temporary connection file in memory
arcpy.CreateArcSDEConnectionFile_management(r"C:\Project\Output", "TempConnection", "myServerName", "5151", "myDatabase", "DATABASE_AUTH", "myUserName", "myPassword", "SAVE_USERNAME", "myUser.DEFAULT", "SAVE_VERSION")
#Export a map document to verify that secured layers are present
mxd = arcpy.mapping.MapDocument(r"C:\Project\SDEdata.mxd")
arcpy.mapping.ExportToPDF(mxd, r"C:\Project\output\SDEdata.pdf")
os.remove(sdeFile)
del mxd
图层示例 3

以下脚本将打印每个地理数据库或 web 服务图层的名称以及相应服务信息。与上例类似,由于一些地理数据库图层可能使用密码信息保护,所以将创建临时地理数据库连接文件。此例不打印非地理数据库或 web 服务图层的信息。

import arcpy, os
#Remove temporary connection file if it already exists
sdeFile = r"C:\Project\Output\TempSDEConnectionFile.sde"
if os.path.exists(sdeFile):
    os.remove(sdeFile)
#Create temporary connection file in memory
arcpy.CreateArcSDEConnectionFile_management(r"C:\Project\Output", "TempConnection", "myServerName", "5151", "myDatabase", "DATABASE_AUTH", "myUserName", "myPassword", "SAVE_USERNAME", "myUser.DEFAULT", "SAVE_VERSION")
#Report service properties for layers in a map that support SERVICEPROPERTIES
mxd = arcpy.mapping.MapDocument(r"C:\Project\ServerData.mxd")
for lyr in arcpy.mapping.ListLayers(mxd):
    if lyr.supports("SERVICEPROPERTIES"):
        servProp = lyr.serviceProperties
        print "Layer name:" + lyr.name
        print "-----------------------------------------------------"
        if lyr.serviceProperties["ServiceType"] != "SDE":
            print "Service Type: " + servProp.get('ServiceType', 'N/A')
            print "    URL:         " + servProp.get('URL', 'N/A')
            print "    Connection:  " + servProp.get('Connection', 'N/A')
            print "    Server:      " + servProp.get('Server', 'N/A')
            print "    Cache:       " + str(servProp.get('Cache', 'N/A'))
            print "    User Name:   " + servProp.get('UserName', 'N/A')
            print "    Password:    " + servProp.get('Password', 'N/A')
            print ""
        else:
            print "Service Type: " + servProp.get('ServiceType', 'N/A')
            print "    Database:       " + servProp.get('Database', 'N/A')
            print "    Server:         " + servProp.get('Server', 'N/A')
            print "    Service:        " + servProp.get('Service', 'N/A')
            print "    Version:        " + servProp.get('Version', 'N/A')
            print "    User name:      " + servProp.get('UserName', 'N/A')
            print "    Authentication: " + servProp.get('AuthenticationMode', 'N/A')
            print ""       
del mxd
图层示例 4

以下脚本修改了地图文档中某个图层的符号系统。首先,它通过 UpdateLayer 函数,使用磁盘中的图层文件更新图层的符号系统。图层文件包含用于图层的自定义色带。然后,它将验证图层是否具有分级色彩符号系统。最后,此脚本修改 GraduatedColors 符号系统分类中的各种属性并将结果导出至 PDF。

import arcpy
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
df = arcpy.mapping.ListDataFrames(mxd, "Census")[0]
lyr = arcpy.mapping.ListLayers(mxd, "StatePopulation", df)[0]
lyrFile = arcpy.mapping.Layer(r"C:\Project\LYRs\Population.lyr")
arcpy.mapping.UpdateLayer(df, lyr, lyrFile, True)
if lyr.symbologyType == "GRADUATED_COLORS":
  lyr.symbology.valueField = "POP2000"
  lyr.symbology.numClasses = 4
  lyr.symbology.classBreakValues = [250000, 999999, 4999999, 9999999, 35000000]
  lyr.symbology.classBreakLabels = ["250,000 to 999,999", "1,000,000 to 4,999,999", 
                                    "5,000,000 to 9,999,999", "10,000,000 to 35,000,000"]
arcpy.mapping.ExportToPDF(mxd, r"C:\Project\Output\StatePopulation.pdf")
del mxd, lyrFile
图层示例 5

以下脚本测试图层文件是否支持时间以及是否已设置时间属性。然后,此脚本使用时间信息(开始时间和结束时间)计算已启用时间的图层的时间范围。

import arcpy, datetime
lyr = arcpy.mapping.Layer(r'C:\Project\Data\Time\TemperatureWithTime.lyr')
if lyr.supports("TIME"):
    lyrTime = lyr.time
    if lyr.time.isTimeEnabled:
        startTime = lyrTime.startTime
        endTime = lyrTime.endTime
        timeDelta = endTime - startTime
        print "Start Time: " + str(startTime)
        print "End Time: " + str(endTime)
        print "Time Extent: " + str(timeDelta)
    else:
        print "No time properties have been set on the layer"
else:
    print "Time is not supported on this layer"

ArcGIS Desktop

  • 主页
  • 文档
  • 支持

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

关于 Esri

  • 关于我们
  • 招贤纳士
  • Esri 博客
  • 用户大会
  • 开发者峰会
Esri
分享您的想法。
Copyright © 2021 Esri. | 隐私政策 | 法律声明