esri_maplayer_addasync (AutoLISP)

使用指定的服务属性将地图或影像图层异步添加到当前工程图中。 将在 AutoLISP 进程之外执行该进程。 您将不会得到任何进一步的反馈。 可以使用 esri_maplayer_add 添加带有结果反馈的地图或影像图层。 此图层将使用其添加到的工程图的当前坐标系。 如果将此图层添加到不含坐标系的工程图，那么该工程图将从图层中继承坐标系。

语法

(esri_map_addasync url service_properties)

参数

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

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

示例用法

尝试从给定 URL 添加地图或影像图层并将透明度设置为 70：

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

结果示例用法

尝试添加指定的图层。 该函数不等待任何有关成功或失败的反馈，而是返回一个 true 列表：

(T)

返回值

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

失败的返回值：

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

  未提供必填参数。

• (nil ("Error" . "This command requires a network connection."))

  要执行函数，需要与 Web 图层源的网络连接。

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

  提供的 URL 无效。