返回顶部

MapView

在本主题中

  1. 摘要
  2. 说明
  3. 属性
  4. 方法概述
  5. 方法
  6. 代码示例

摘要

MapView 类旨在用于两个工作流中。首先，它可以用于 ArcGIS Pro 工程中以访问当前活动的地图视图。其次，可以在 web 地图打印应用程序中将其与 ConvertWebMapToArcGISProject 配合使用，以访问要打印或导出的地图视图。

说明

在 ArcGIS Pro 工程中，MapView 类可用于获取对活动地图视图的访问权限。如果地图视图处于活动状态，则 ArcGISProject 类中的 activeView 属性将返回 MapView 对象，如果布局视图处于活动状态，则其将返回 Layout 对象。任何其他类型的视图都会返回 None。activeView 属性适用于要在 ArcGIS Pro 应用程序中执行的脚本，例如在 Python 窗格中运行的脚本或者与 脚本工具相关联的脚本。从 activeView 属性返回的 MapView 是更改与地图视图相关联的照相机范围的唯一方法。

MapView 类也可以用于 web 地图打印工作流。MapView 类可提供对地图视图的访问权限，以便打印或导出不包含页面布局周围要素（例如，标题、图例和比例尺）的 web 地图。这通常由正在创建 Web 地图打印应用程序的 Web 应用程序开发人员使用。有关详细信息，请参阅 ConvertWebMapToArcGISProject。

警告:

并非所有 MapView 方法均适用于 web 应用程序开发人员。Web 地图打印应用程序中不支持以下方法：

  • getLayerExtent
  • panToExtent
  • zoomToAllLayers
  • zoomToBookmark

属性

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

Camera 属性用于控制数据在地图视图中显示的位置和查看位置。可以更改照相机属性，例如范围。

Camera
map
(只读)

与 MapView 相关联的地图。

Map

方法概述

方法说明
exportToAIX (out_aix, width, height, {resolution}, {image_quality}, {compress_vector_graphics}, {image_compression}, {jpeg_compression_quality}, {embed_fonts}, {embed_color_profile})

用于将地图框导出为 Adobe Creative Cloud (AIX) 格式。

exportToBMP (out_bmp, width, height, {resolution}, {world_file}, {bmp_color_mode}, {bmp_image_compression}, {embed_color_profile})

用于将地图视图导出为 Microsoft Windows 位图 (BMP) 格式文件。

exportToEMF (out_emf, width, height, {resolution}, {image_quality}, {output_as_image})

用于将页面布局导出为增强型图元文件 (EMF) 格式文件。

exportToEPS (out_eps, width, height, {resolution}, {image_compression}, {image_quality}, {embed_fonts}, {output_as_image})

将 MapView 的内容导出为 Encapsulated PostScript (EPS) 文件格式。

exportToGIF (out_gif, width, height, {resolution}, {world_file}, {gif_color_mode})

将 MapView 内容导出为图形交换格式 (GIF) 文件。

exportToJPEG (out_jpg, width, height, {resolution}, {world_file}, {jpeg_color_mode}, {jpeg_quality}, {embed_color_profile})

将 MapView 内容导出为联合图像专家组 (JPEG) 格式文件。

exportToPDF (out_pdf, width, height, {resolution}, {image_quality}, {compress_vector_graphics}, {image_compression}, {embed_fonts}, {layers_attributes}, {georef_info}, {jpeg_compression_quality}, {output_as_image}, {embed_color_profile})

将 MapView 内容导出为便携式文档格式 (PDF) 文件。

exportToPNG (out_png, width, height, {resolution}, {world_file}, {color_mode}, {embed_color_profile})

将 MapView 内容导出为便携式网络图形 (PNG) 格式文件。

exportToSVG (out_svg, width, height, {resolution}, {compress_to_svgz}, {image_quality}, {embed_fonts}, {output_as_image})

将 MapView 内容导出为可伸缩矢量图形 (SVG) 格式文件。

exportToTGA (out_tga, width, height, {resolution}, {world_file}, {color_mode})

用于将地图视图导出为 Truevision 图形适配器 (TGA) 格式文件。

exportToTIFF (out_tif, width, height, {resolution}, {world_file}, {color_mode}, {tiff_compression}, {geoTIFF_tags}, {jpeg_compression_quality}, {embed_color_profile})

将地图视图导出为标记图像文件格式 (TIFF) 文件。

getLayerExtent (layer, {selection_only}, {symbolized_extent})

返回图层中所有要素或仅仅所选要素的图层范围。

panToExtent (extent)

使用新 Extent 对象可平移和居中 MapView，而无需更改地图视图的比例。

zoomToAllLayers ({selection_only}, {symbolized_extent})

修改 MapView 视图以便与所有图层或地图中所选图层的范围相匹配。

zoomToBookmark (bookmark)

修改 MapView 视图以便与通过空间书签存储的视图信息相匹配。

方法

exportToAIX (out_aix, width, height, {resolution}, {image_quality}, {compress_vector_graphics}, {image_compression}, {jpeg_compression_quality}, {embed_fonts}, {embed_color_profile})
参数说明数据类型
out_aix

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 300)

Integer
image_quality

用于指定输出图像质量、作为栅格绘制的地图图层的绘制分辨率的字符串。

  • BEST—输出图像质量的重采样比为 1
  • BETTER—输出图像质量的重采样比为 2
  • NORMAL—输出图像质量的重采样比为 3
  • FASTER—输出图像质量的重采样比为 4
  • FASTEST—输出图像质量的重采样比为 5

(默认值为 BEST)

String
compress_vector_graphics

用于控制输出文件的矢量和文本部分压缩的布尔值。图像压缩单独定义。

(默认值为 True)

Boolean
image_compression

用于指定在输出文件中压缩图像或栅格数据时使用的压缩方案的字符串。

  • ADAPTIVE—自动为页面中的每个图像选择最佳压缩类型。JPEG 适用于包含许多唯一颜色的较大图像。DEFLATE 适用于所有其他图像。
  • DEFLATE—无损数据压缩。
  • JPEG—有损数据压缩。
  • LZW—Lempel-Ziv-Welch 为无损数据压缩。
  • NONE—不应用压缩。
  • RLE—游程编码压缩。

(默认值为 ADAPTIVE)

String
jpeg_compression_quality

当 image_compression 设置为 ADAPTIVE 或 JPEG 时，用于控制压缩质量值的数字。有效范围为 1 到 100。jpeg_compression_quality 为 100 时可提供最佳图像质量，但会创建较大的导出文件。推荐范围为 70 到 90 之间。

(默认值为 80)

Integer
embed_fonts

用于控制导出文件中的字体嵌入的布尔值。当在未安装所需字体的计算机上查看文档时，可通过字体嵌入正确显示文本和字符标记。

(默认值为 True)

Boolean
embed_color_profile

如果设置为 True，则颜色配置文件信息将嵌入在图像的元数据中。

(默认值为 True)

Boolean

AIX 是从 ArcGIS 导出的 Adobe Illustrator Exchange 文件，可以与 ArcGIS Maps for Adobe Creative Cloud 插件配合使用。与插件配合使用时，矢量地图和栅格地图内容将转换为可编辑的 Artwork 图层，以改善 Adobe Illustrator 中的编辑体验。在 Illustrator 中打开 AIX 后，可用于高端图形设计或地图最后处理工作流，并可在其他 Adobe Creative Cloud 应用程序之间进行迁移。

exportToBMP (out_bmp, width, height, {resolution}, {world_file}, {bmp_color_mode}, {bmp_image_compression}, {embed_color_profile})
参数说明数据类型
out_bmp

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
world_file

如果设置为 True，则将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。

(默认值为 False)

Boolean
bmp_color_mode

该值可指定用于描述颜色的位数。

  • 8-BIT_ADAPTIVE_PALETTE—8 位自适应调色板
  • 8-BIT_GRAYSCALE—8 位灰度
  • 24-BIT_TRUE_COLOR—24 位真彩色

(默认值为 24-BIT_TRUE_COLOR)

String
bmp_image_compression

用于指定在输出文件中压缩图像或栅格数据时使用的压缩方案的字符串。此选项仅适用于 8 位 bmp_color_mode 选项。

  • NONE—不应用压缩。
  • RLE—游程编码压缩。

(默认值为 NONE)

String
embed_color_profile

如果设置为 True，则颜色配置文件信息将嵌入在图像的元数据中。

(默认值为 True)

Boolean

BMP 文件属于本地 Windows 栅格图像。BMP 文件可以使用多个位深度存储像素数据。BMP 图像的大小通常比 JPEG 或 PNG 等其他格式的图像大很多。

exportToEMF (out_emf, width, height, {resolution}, {image_quality}, {output_as_image})
参数说明数据类型
out_emf

用于表示输出导出文件的系统路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
image_quality

用于指定输出图像质量、作为栅格绘制的地图图层的绘制分辨率的字符串。

  • BEST—输出图像质量的重采样比为 1
  • BETTER—输出图像质量的重采样比为 2
  • NORMAL—输出图像质量的重采样比为 3
  • FASTER—输出图像质量的重采样比为 4
  • FASTEST—输出图像质量的重采样比为 5

(默认值为 BEST)

String
output_as_image

如果设置为 True，则矢量内容可以另存为图像。如果地图或布局包含具有高密度顶点的矢量图层，则选择此选项可减小输出文件的大小。如果导出为 PDF 并将此选项设置为 True，则无法在输出中查看 PDF 图层。

(默认值为 False)

Boolean

EMF 文件属于本地 Windows 图形文件，其中既包含矢量数据又包含栅格数据。这些文件非常适合于嵌入 Windows 文档，因为 EMF 文件的矢量部分可以调整大小，而又不会降低质量。但是，由于 EMF 文件不支持字体嵌入并且属于 Windows 专用格式，因此并不常用作用户之间的交换格式。

exportToEPS (out_eps, width, height, {resolution}, {image_compression}, {image_quality}, {embed_fonts}, {output_as_image})
参数说明数据类型
out_eps

用于表示输出导出文件的系统路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
image_compression

用于指定在输出文件中压缩图像或栅格数据时使用的压缩方案的字符串。

  • DEFLATE—无损数据压缩。
  • LZW—Lempel-Ziv-Welch 为无损数据压缩。
  • NONE—不应用压缩。
  • RLE—游程编码压缩。

(默认值为 DEFLATE)

String
image_quality

用于指定输出图像质量、作为栅格绘制的地图图层的绘制分辨率的字符串。

  • BEST—输出图像质量的重采样比为 1。
  • BETTER—输出图像质量的重采样比为 2。
  • NORMAL—输出图像质量的重采样比为 3。
  • FASTER—输出图像质量的重采样比为 4。
  • FASTEST—输出图像质量的重采样比为 5。

(默认值为 BEST)

String
embed_fonts

用于控制导出文件中的字体嵌入的布尔值。当在未安装所需字体的计算机上查看文档时，可通过字体嵌入正确显示文本和字符标记。

(默认值为 True)

Boolean
output_as_image

如果设置为 True，则矢量内容可以另存为图像。如果地图或布局包含具有高密度顶点的矢量图层，则选择此选项可减小输出文件的大小。如果导出为 PDF 并将此选项设置为 True，则无法在输出中查看 PDF 图层。

(默认值为 False)

Boolean

EPS 文件将通过 PostScript 页面描述语言描述矢量对象和栅格对象。PostScript 是高端图形文件、制图和打印的出版行业标准。许多绘图应用程序中都可编辑 EPS 文件，也可将此类文件作为图形置于大多数页面布局应用程序中。EPS 文件支持字体嵌入，因此即使用户尚未安装 Esri 字体也可以查看正确的符号。

exportToGIF (out_gif, width, height, {resolution}, {world_file}, {gif_color_mode})
参数说明数据类型
out_gif

用于表示输出导出文件的系统路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
world_file

如果设置为 True，将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。

(默认值为 False)

Boolean
gif_color_mode

该值可指定用于描述颜色的位数。

  • 8-BIT_PALETTE—8 位自适应调色板
  • 8-BIT_GRAYSCALE—8 位灰度

(默认值为 8-BIT_PALETTE)

String

GIF 文件属于 Web 中使用的旧的栅格格式。GIF 文件无法显示 256 种以上的颜色（每像素 8 位），并且使用的是可选的无损压缩，因此，该类文件的大小比其他格式的文件要小。

exportToJPEG (out_jpg, width, height, {resolution}, {world_file}, {jpeg_color_mode}, {jpeg_quality}, {embed_color_profile})
参数说明数据类型
out_jpg

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
world_file

如果设置为 True，将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。导出 3D 地图框时，无论设置为何，都将忽略此参数，因为坐标文件不适用于 3D 视图。

(默认值为 False)

Boolean
jpeg_color_mode

该值可指定用于描述颜色的位数。

  • 8-BIT_GRAYSCALE—8 位灰度
  • 24-BIT_TRUE_COLOR—24 位真彩色

(默认值为 24-BIT_TRUE_COLOR)

String
jpeg_quality

此值 (0–100) 用于控制应用于输出图像的压缩程度。对于 JPEG，压缩程度越大，图像质量越低。质量设置越高（最高为 100），生成的图像越清晰且文件大小更大。质量设置越低，产生的图像伪影越多且文件大小更小。

(默认值为 80)

Integer
embed_color_profile

如果设置为 True，则颜色配置文件信息将嵌入在图像的元数据中。

(默认值为 True)

Boolean

JPEG 文件属于经过压缩的图像文件。它支持 24 位颜色并且是 Web 上流行的使用格式，因为 JPEG 文件大小通常要比许多其他图像格式小很多。但是，JPEG 压缩算法会有损质量，多数地图图像中都不推荐使用，因为线绘图以及文本或图标图形会因压缩产生的伪影而变得模糊。因此，通常 PNG 格式才是地图图像的首选。在生成 JPEG 文件的同时，还将生成一个坐标文件，可用作地理配准栅格数据。

exportToPDF (out_pdf, width, height, {resolution}, {image_quality}, {compress_vector_graphics}, {image_compression}, {embed_fonts}, {layers_attributes}, {georef_info}, {jpeg_compression_quality}, {output_as_image}, {embed_color_profile})
参数说明数据类型
out_pdf

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 300)

Integer
image_quality

用于定义输出图像质量和作为栅格绘制的地图图层的绘制分辨率的字符串。

  • BEST—输出图像质量的重采样比为 1
  • BETTER—输出图像质量的重采样比为 2
  • NORMAL—输出图像质量的重采样比为 3
  • FASTER—输出图像质量的重采样比为 4
  • FASTEST—输出图像质量的重采样比为 5

(默认值为 BEST)

String
compress_vector_graphics

用于控制输出文件的矢量和文本部分压缩的布尔值。图像压缩单独定义。

(默认值为 True)

Boolean
image_compression

用于定义在输出文件中压缩图像或栅格数据时使用的压缩方案的字符串。

  • ADAPTIVE—自动为页面中的每个图像选择最佳压缩类型。JPEG 适用于包含许多唯一颜色的较大图像。DEFLATE 适用于所有其他图像。
  • DEFLATE—无损数据压缩。
  • JPEG—有损数据压缩。
  • LZW—Lempel-Ziv-Welch 为无损数据压缩。
  • NONE—不应用压缩。
  • RLE—游程编码压缩。

(默认值为 ADAPTIVE)

String
embed_fonts

用于控制导出文件中的字体嵌入的布尔值。当在未安装所需字体的计算机上查看文档时，可通过字体嵌入正确显示文本和字符标记。

(默认值为 True)

Boolean
layers_attributes

用于控制导出文件中包含的 PDF 图层和 PDF 对象数据（属性）的字符串。

  • LAYERS_ONLY—仅导出 PDF 图层。
  • LAYERS_AND_ATTRIBUTES—导出 PDF 图层和要素属性。
  • NONE—无。

(默认值为 LAYERS_ONLY)

String
georef_info

用于将每个数据框的坐标系信息导出到输出 PDF 文件中的布尔值。

(默认值为 True)

Boolean
jpeg_compression_quality

当 image_compression 设置为 ADAPTIVE 或 JPEG 时，用于控制压缩质量值的数字。有效范围为 1 到 100。jpeg_compression_quality 为 100 时可提供最佳图像质量，但会创建较大的导出文件。推荐范围为 70 到 90。

(默认值为 80)

Integer
output_as_image

如果设置为 True，则矢量内容可以另存为图像。如果地图或布局包含具有高密度顶点的矢量图层，则选择此选项可减小输出文件的大小。如果导出为 PDF 并将此选项设置为 True，则无法在输出中查看 PDF 图层。

(默认值为 False)

Boolean
embed_color_profile

如果设置为 True，则颜色配置文件信息将嵌入在图像的元数据中。

(默认值为 True)

Boolean

PDF 文件可在不同的平台上实现一致的查看和打印效果。它们常用于在 Web 上分发文档，并且此格式现在属于文档交换的 ISO 官方标准。PDF 文件在许多图形应用程序中均可编辑，并会保留地图的地理配准信息、注记、标注和要素属性数据。PDF 导出支持字体嵌入，即使在用户尚未安装 Esri 字体时，也可以正确显示符号系统。

查看 PDFDocument 类以了解更多关于如何管理 PDF 文件的方法，如追加、插入以及设置属性。

exportToPNG (out_png, width, height, {resolution}, {world_file}, {color_mode}, {embed_color_profile})
参数说明数据类型
out_png

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
world_file

如果设置为 True，将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。导出 3D 地图框时，无论设置为何，都将忽略此参数，因为坐标文件不适用于 3D 视图。

(默认值为 False)

Boolean
color_mode

该值可指定用于描述颜色的位数。

  • 8-BIT_ADAPTIVE_PALETTE—8 位自适应调色板
  • 8-BIT_GRAYSCALE—8 位灰度
  • 24-BIT_TRUE_COLOR—24 位真彩色
  • 32-BIT_WITH_ALPHA—32 位，带 alpha

(默认值为 32-BIT_WITH_ALPHA)

String
embed_color_profile

如果设置为 True，则颜色配置文件信息将嵌入在图像的元数据中。

(默认值为 True)

Boolean

PNG 格式属于通用型栅格格式，可在各种 Web 浏览器上显示并且还可插入其他文档。它支持高位深度颜色并使用无损压缩。对于地图而言，PNG 通常是最佳的栅格格式，因为无损压缩可防止产生 JPEG 格式中的那种压缩伪影，从而使文本和线作业始终清晰可辨。PNG 文件还可定义透明颜色。在生成 PNG 文件的同时，还将生成一个坐标文件，可用作地理配准栅格数据。

exportToSVG (out_svg, width, height, {resolution}, {compress_to_svgz}, {image_quality}, {embed_fonts}, {output_as_image})
参数说明数据类型
out_svg

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
compress_to_svgz

如果设置为 True，则会压缩输出。

(默认值为 False)

Boolean
image_quality

用于指定输出图像质量、作为栅格绘制的地图图层的绘制分辨率的字符串。

  • BEST—输出图像质量的重采样比为 1。
  • BETTER—输出图像质量的重采样比为 2。
  • NORMAL—输出图像质量的重采样比为 3。
  • FASTER—输出图像质量的重采样比为 4。
  • FASTEST—输出图像质量的重采样比为 5。

(默认值为 BEST)

String
embed_fonts

用于控制导出文件中的字体嵌入的布尔值。当在未安装所需字体的计算机上查看文档时，可通过字体嵌入正确显示文本和字符标记。

(默认值为 True)

Boolean
output_as_image

如果设置为 True，则矢量内容可以另存为图像。如果地图或布局包含具有高密度顶点的矢量图层，则选择此选项可减小输出文件的大小。如果导出为 PDF 并将此选项设置为 True，则无法在输出中查看 PDF 图层。

(默认值为 False)

Boolean

SVG 格式是一种基于 XML 的文件格式，专门适用于在 Web 上进行查看。SVG 文件可以同时包含矢量信息和栅格信息。某些 Web 浏览器可能需要安装插件才能查看 SVG 文件。较早版本的浏览器可能根本无法查看 SVG 文件。SVG 格式支持字体嵌入，因此即使用户尚未安装 Esri 字体也可以使用正确的符号系统查看导出的 SVG 文件。用户也可以生成压缩的 SVG 文件。如果启用此选项，文件扩展名变为 .svgz。

exportToTGA (out_tga, width, height, {resolution}, {world_file}, {color_mode})
参数说明数据类型
out_tga

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
world_file

如果设置为 True，则将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。

(默认值为 False)

Boolean
color_mode

该值可指定用于描述颜色的位数。

  • 8-BIT_ADAPTIVE_PALETTE—8 位自适应调色板
  • 8-BIT_GRAYSCALE—8 位灰度
  • 24-BIT_TRUE_COLOR—24 位真彩色
  • 32-BIT_WITH_ALPHA—32 位，带 alpha

(默认值为 32-BIT_WITH_ALPHA)

String

TGA 文件以往用于其他应用程序中的内容（例如，动画游戏的 Image Sprites），许多受欢迎的图形艺术应用程序均可对该文件进行读取和写入。TGA 格式支持多位深度，包括支持 alpha（透明）的 32 位。

exportToTIFF (out_tif, width, height, {resolution}, {world_file}, {color_mode}, {tiff_compression}, {geoTIFF_tags}, {jpeg_compression_quality}, {embed_color_profile})
参数说明数据类型
out_tif

用于表示输出导出文件的路径和文件名的字符串。

String
width

用于定义导出宽度的数字（单位：像素）。

Integer
height

用于定义导出高度的数字（单位：像素）。

Integer
resolution

用于定义导出文件分辨率的数字，单位为每英寸点数 (dpi)。

(默认值为 96)

Integer
world_file

如果设置为 True，将创建地理配准坐标文件。文件中包含像素比例信息和真实世界坐标信息。导出 3D 地图框时，无论设置为何，都将忽略此参数，因为坐标文件不适用于 3D 视图。

(默认值为 False)

Boolean
color_mode

该值可指定用于描述颜色的位数。

  • 8-BIT_ADAPTIVE_PALETTE—8 位自适应调色板
  • 8-BIT_GRAYSCALE—8 位灰度
  • 24-BIT_TRUE_COLOR—24 位真彩色
  • 32-BIT_WITH_ALPHA—32 位，带 alpha

(默认值为 24-BIT_TRUE_COLOR)

String
tiff_compression

此值表示压缩方案。

  • DEFLATE—无损数据压缩。
  • JPEG—JPEG 压缩。
  • LZW—Lempel-Ziv-Welch 为无损数据压缩。
  • NONE—不应用压缩。
  • PACK_BITS—紧缩位压缩。

(默认值为 LZW)

String
geoTIFF_tags

如果设置为 True，则地理配准标签将包含在 TIFF 导出文件结构内。标签中包含像素比例信息和真实世界坐标信息。可通过支持 GeoTIFF 格式的应用程序读取这些标签。

(默认值为 False)

Boolean
jpeg_compression_quality

此值 (0–100) 用于控制应用于输出图像的压缩程度。对于 JPEG 图像来说，压缩程度越大，图像质量越低。质量设置越高（最高为 100），生成的图像越清晰且文件大小更大。质量设置越低，产生的图像伪影越多且文件大小更小。

(默认值为 80)

Integer
embed_color_profile

如果设置为 True，则颜色配置文件信息将嵌入在图像的元数据中。

(默认值为 True)

Boolean

TIFF 文件最适合导入图像编辑应用程序，同时它也属于一种常用的 GIS 栅格数据格式。但是却无法通过 Web 浏览器在本地查看这些文件。TIFF 文件还支持在 GeoTIFF 标签中或在单独坐标文件中存储地理配准信息，以便用作栅格数据。

getLayerExtent (layer, {selection_only}, {symbolized_extent})
参数说明数据类型
layer

引用 Layer 对象。

Layer
selection_only

如果为 True，将返回选定要素的范围；如果为 False，将返回所有要素的范围。

(默认值为 True)

Boolean
symbolized_extent

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

(默认值为 True)

Boolean
返回值
数据类型说明
Extent

地理处理 Extent 对象。

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

panToExtent (extent)
参数说明数据类型
extent

地理处理 Extent 对象。

Extent

此方法尤为适合比例未变而位置发生了变化的情况。无需设置范围以及每次都重置比例，panToExtent 保持比例不变，然后使照相机在新范围中居中。

zoomToAllLayers ({selection_only}, {symbolized_extent})
参数说明数据类型
selection_only

如果为 True，将根据选定要素设置范围；如果为 False，将为地图中的所有要素设置范围。

(默认值为 True)

Boolean
symbolized_extent

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

(默认值为 True)

Boolean

如果对含有全局或本地场景的 MapView 使用了 zoomToAllLayers，则将生成平面视图。

zoomToBookmark (bookmark)
参数说明数据类型
bookmark

引用 Bookmark 对象。

Bookmark

如果对引用了 2D 地图的 MapView 使用了 3D 书签（反之亦然），则将生成平面试图。

代码示例

活动地图视图示例

在本示例中，将 MapView 范围导出到 PNG 文件之前，将针对当前活动地图视图对其进行修改。可以使用 current 关键词来引用 ArcGIS Pro 工程。此脚本将在 Python 窗格或脚本工具中运行。

import arcpy, os

aprx = arcpy.mp.ArcGISProject('current')
mv = aprx.activeView

# Change the extent of the map view
ext = mv.camera.getExtent()
ext.XMin = ext.XMin + 100
ext.YMin = ext.YMin + 100
ext.XMax = ext.XMax - 100
ext.YMax = ext.YMax - 100
mv.camera.setExtent(ext)

# Export the map view
Output_File = os.path.join(arcpy.env.scratchFolder, 'ActiveMapView.png')
mv.exportToPNG(Output_File, width=1000, height=1000, world_file=True, color_mode="32-BIT_WITH_ALPHA")
MapView 网络地图打印示例

在本示例中，脚本在 Web 地图 JSON 中读取。ConvertWebMapToArcGISProject 中的输出 MapView 将导出为 PNG 文件。 

import arcpy
import os
import uuid

# Input web map json
Web_Map_as_JSON = arcpy.GetParameterAsText(0)

# Convert the web map to an ArcGIS Project
result = arcpy.mp.ConvertWebMapToArcGISProject(Web_Map_as_JSON)
aprx = result.ArcGISProject

# Get the map view
m = aprx.listMaps()[0]
mv = m.defaultView

# Use the uuid module to generate a GUID as part of the output name
# This will ensure a unique output name
output = 'WebMap_{}.png'.format(str(uuid.uuid1()))
Output_File = os.path.join(arcpy.env.scratchFolder, output)

# Export the web map
mv.exportToPNG(Output_File, result.outputSizeWidth, result.outputSizeHeight, result.DPI)

# Set the output parameter to be the output file of the server job
arcpy.SetParameterAsText(1, Output_File)

# Clean up
del mv, m, aprx, result

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 说明
  3. 属性
  4. 方法概述
  5. 方法
  6. 代码示例