创建影像服务器图层 (数据管理)

摘要

根据影像服务创建临时栅格图层。如果不保存文档,所创建的图层将在会话结束后消失。

输入还可为连接到影像服务器的 URL。影像服务器 URL 还应包含 coverage 和版本信息。如果仅输入 URL,则该工具将自动采用第一个 coverage 并使用默认版本 (1.0.0) 来创建影像图层。

用法

语法

MakeImageServerLayer_management (in_image_service, out_imageserver_layer, {template}, {band_index}, {mosaic_method}, {order_field}, {order_base_value}, {lock_rasterid})
参数说明数据类型
in_image_service

输入影像服务的名称或引用影像服务的 URL。

如果使用的是影像服务器 URL,则该 URL 应包含 coverage 名称和版本信息。如果仅输入 URL,则该工具将自动采用第一个 coverage 并使用默认版本 (1.0.0) 来创建影像图层。

以下为包含 coverage 名称和版本的 URL 示例:

http://AGSServer/arcgis/services/ISName/ImageServer?coverage=rasterDRGs&version=1.1.1

在此例中,“http://AGSServer/arcgis/services/ISName/ImageServer?”即为 URL。指定的 coverage 为“coverage=rasterDRGs”,版本为“&version=1.1.1”。

Image Service; String
out_imageserver_layer

输出影像图层的名称。

Raster Layer
template
(可选)

图像图层的输出范围。

指定输出范围的方法可以是定义要裁剪的区域(X 最小值、Y 最小值、X 最大值和 Y 最大值),也可以是使用现有图层的范围。

Extent
band_index
[ID,...]
(可选)

选择要为图层输出哪些波段。如果未指定波段,则输出中将使用所有波段。

Value Table
mosaic_method
(可选)

镶嵌方法定义了如何使用不同的栅格数据来创建镶嵌数据集。

可使用若干输入的栅格数据来创建返回到客户端的影像。镶嵌过程包含两个默认的可用选项。

  • 最接近中心(Closest_To_Center)- 根据栅格中心与视图中心的距离对栅格数据进行排序,默认情况下,与视图中心距离越近,栅格数据的次序越靠前。
  • 北-西(North_West)- 根据栅格中心与西北方向的距离对栅格数据进行排序,与西北方向的距离越近,栅格数据的次序越靠前。
  • 锁定栅格(Lock_Raster)- 根据 ID 或名称锁定单个或多个栅格的显示。
  • 按属性(By_Attribute)- 根据属性字段及其与基础值的差异对栅格数据进行排序。
  • 最接近像底点(Closest_To_Nadir)- 根据像底点位置与视图中心的距离对栅格数据进行排序,像底点与视图中心的距离越近,栅格数据的次序越靠前。像底点可以偏离中心点,尤其是在倾斜的影像中。
  • 最接近视点(Closest_To_Viewpoint)- 根据像底点位置与用户定义的视点位置之间的距离对栅格数据进行排序,像底点与视点的距离越近,栅格数据的次序越靠前。
  • 接缝线(Seamline)- 按照为每个栅格预定义的接缝线形状切割栅格,也可以选择使用沿接缝线羽化功能。排列顺序将在生成接缝线的过程中进行预定义。
String
order_field
(可选)

将镶嵌方法设为 By_Attribute 时用于栅格排序的默认字段。根据服务表中类型为元数据和整型的字段来定义字段列表(例如,值可以是日期或云覆盖比例)。

String
order_base_value
(可选)

根据此输入值与指定字段中的属性值之间的差异对影像(栅格数据)进行排序。

String
lock_rasterid
(可选)

设置将服务锁定到哪些栅格 ID 或栅格名称,以便只显示指定的栅格。如果置空(未定义),将遵循系统默认设置。可使用分号分隔的列表定义多个 ID。

String

代码示例

MakeImageServerLayer 示例 1(Python 窗口)

这是 MakeImageServerLayer 工具的 Python 示例。

import arcpy
from arcpy import env
env.workspace = "C:/Workspace"
input1 = "GIS Servers/server3 (admin)/File_TIFF_Amberg.ImageServer"
arcpy.MakeImageServerLayer_management(input1, "islayer", "4488961 5478909 4489227 5479255",\
                                          "4;6", "#", "#", "#", "#")
MakeImageServerLayer 示例 2(独立脚本)

这是 MakeImageServerLayer 工具的 Python 脚本示例。

##====================================
##Make Image Server Layer
##Usage: MakeImageServerLayer_management in_image_service out_imageserver_layer 
##                                       {template} {ID;ID...} {mosaic_method} 
##                                       {order_field} {order_base_value} {lock_rasterid}
    
try:
    import arcpy
    
    arcpy.env.workspace = r"C:/Workspace"
    input1 = r"GIS Servers\server3 (admin)\File_TIFF_Amberg.ImageServer"
    input2 = "http://server3/arcgis/services/MD_MosaicRule/ImageServer"
    
    ##Create image services layer from a single image file service
    ##Use connection file as input
    arcpy.MakeImageServerLayer_management(input1, "islayer", "4488961 5478909 4489227 5479255",\
                                          "4;6", "#", "#", "#", "#")
    
    ##Create image services layer from mosaic dataset image service
    ##Use URL as input
    arcpy.MakeImageServerLayer_management(input2, "mdlayer", "feature.shp", "1;2;3",\
                                          "LockRaster", "#", "#", "4")

    print arcpy.GetMessages()
    
except:
    print "Make Image Server Layer example failed."
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcView: 是
ArcEditor: 是
ArcInfo: 是

7/10/2012