Python ArcGIS WebMap.print用法及代码示例

本文简要介绍 python 语言中 arcgis.mapping.WebMap.print 的用法。

用法:

print(file_format, extent, dpi=92, output_dimensions=500, 500, scale=None, rotation=None, spatial_reference=None, layout_template='MAP_ONLY', time_extent=None, layout_options=None)

返回：

可以下载和打印的文件的 URL。

print 方法将 WebMap 对象打印到 PDF、PNG32、JPG 等可打印文件。

注意：

渲染和打印操作发生在服务器端(ArcGIS Online 或 Enterprise)而不是客户端。

print 方法采用 WebMap 的状态，以光栅或矢量格式呈现并返回页面布局或没有指定范围的页面环绕的Map。

Parameter	Description
file_format	必需的字符串。指定输出文件格式。有效类型： PNG8 | PNG32 | JPG | GIF | PDF | EPS | SVG | SVGZ 。
extent	所需词典。指定要打印的范围。 # Example Usage: >>> extent = {'spatialReference': {'latestWkid': 3857, 'wkid': 102100}, 'xmin': -15199645.40582486, 'ymin': 3395607.5273594954, 'xmax': -11354557.134968376, 'ymax': 5352395.451459487} 范围对象的空间参考是可选的；如果未提供，则假定它在Map的空间参考中。当Map范围的纵横比与输出页面上的Map大小或 output_dimensions 不同时，您可能会注意到输出Map上的要素更多。
dpi	可选整数。指定输出文件的打印分辨率。dpi代表每英寸点数.更高的数字意味着更好的分辨率和更大的文件大小。
output_dimensions	可选元组。指定输出文件的尺寸(以像素为单位)。如果 layout_template 不是 MAP_ONLY ，则选择的特定布局模板优先于该参数。
scale	可选浮点数。指定要打印的Map比例。您希望打印Map时使用的Map比例。此参数是可选的，但建议使用以获得最佳结果。当 web Map中的Map服务设置了 scale-dependent 图层或参考比例时，scale 属性特别有用。由于您在 Web 应用程序上查看的Map可能小于输出Map的尺寸(例如 8.5 x 11 英寸或 A4 尺寸)，因此输出Map的比例将会不同，您可能会看到以下差异：与输出Map相比，网络应用程序中的特征和/或符号。 使用比例时，它优先于范围，但输出Map是以范围中心为中心的请求比例绘制的。
rotation	可选浮点数。指定Map框旋转的度数(从北边逆时针测量)。要顺时针旋转，请使用负值。
spatial_reference	可选字典。指定应在其中打印Map的空间参考。如果未指定，则优先顺序如下： 从 extent 参数读取 从 web Map的基础Map图层中读取 从选择的layout_template 中读取
layout_template	可选字符串。默认值MAP_ONLY不使用任何模板。要获取可用模板的列表，请运行 get_layout_templates() 。
time_extent	可选列表。如果有time-aware图层并且您希望在指定时间绘制它，请指定此属性。该订单列表可以有一个或两个元素。添加两个元素( startTime 后跟 endTime )来表示时间范围，或仅提供一个时间元素来表示时间点。时间始终采用 UTC 时间。 # Example Usage to represent Tues. Jan 1, 2008 00:00:00 UTC: # to Thurs. Jan 1, 2009 00:00:00 UTC. >>> time_extent = [1199145600000, 1230768000000]
layout_options	可选词典。这定义了不同可用页面布局元素的设置，并且仅在选择可用的 layout_template 时才需要。页面布局元素包括 title 、 copyright text 、 scale bar 、 author name 和 custom text elements 。更多详情请参见ExportWebMap specification.

例子：

# USAGE EXAMPLE 1: Printing a web map to a JPG file of desired extent.

from arcgis.mapping import WebMap
from arcgis.gis import GIS

# connect to your GIS and get the web map item
gis = GIS(url, username, password)
wm_item = gis.content.get('1234abcd_web map item id')

# create a WebMap object from the existing web map item
wm = WebMap(wm_item)

# create an empty web map
wm2 = WebMap()
wm2.add_layer(<desired Item or Layer object>)

# set extent
redlands_extent = {'spatialReference': {'latestWkid': 3857, 'wkid': 102100},
                     'xmin': -13074746.000753032,
                     'ymin': 4020957.451106308,
                     'xmax': -13014666.49652086,
                     'ymax': 4051532.26242039}

# print
printed_file_url = wm.print(file_format='JPG', extent=redlands_extent)
printed_file2_url = wm2.print(file_format='PNG32', extent=redlands_extent)

# Display the result in a notebook:
from IPython.display import Image
Image(printed_file_url)

# Download file to disk
import requests
with requests.get(printed_file_url) as resp:
    with open('./output_file.png', 'wb') as file_handle:
        file_handle.write(resp.content)