esri_maplayer_add (AutoLISP)

使用指定的服务属性将地图或影像图层添加到当前工程图中。 此图层将使用其添加到的工程图的当前坐标系。 如果将此图层添加到不含坐标系的工程图，那么该工程图将从图层中继承坐标系。

语法

(esri_maplayer_add url service_properties)

参数

• url | 字符串 | 必填 | ArcGIS 地图或影像图层的有效路径。
• service_properties | 关联列表 | 可选 | 以点对形式表示的地图服务属性的关联列表，定义如下：

  相关标注	值类型	值描述	必填或可选
  "TRANSPARENCY"	整型	应用于地图的影像透明度百分比：{0-99: zero is opaque}（默认值 = 30）	可选

示例用法

尝试从给定 URL 添加 70% 透明的地图或影像图层：

(esri_maplayer_add "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Water_Network/MapServer"
  (list
  (cons "TRANSPARENCY" 70)
  )
)

结果示例用法

添加地图图层并返回一个列表，其中包含新地图图层索引编号：

(1)

返回值

该函数将返回一个值。

• 如果成功，则该函数将返回一个列表，其中包含新地图图层索引编号。
• 如果失败，则该函数将返回一个列表，其中第一个值为 nil，然后将返回一个包含键值 Error 的关联列表以及字符串形式的关联错误消息：(nil ( "Error" . "<message>"))。

失败的返回值

出于以下任一原因，可能出现失败的返回值：

• (nil ("Error" . "Invalid URL"))

  提供的 URL 无效。

• (nil ("Error" . "Error adding layer."))

  无法从提供的 URL 添加地图图层。

• (nil ("Error" . "Missing required argument."))

  未提供一个或多个必填参数。