-
影像服务预览与出图
- 影像服务发布后，预览集合中的影像不显示。
答：预览影像时，如果缩放和平移操作下都无法看到影像，可通过下面的途径排错和解决：
1. 进入影像服务检索页面，如下所示；
2. 如下所示，点击“查询”，打开查询参数面板；
3. 在“Collections”参数中，选择预览的影像集合；
4. 点击“查询”按钮；
查询结果为集合的全部影像。
- 如果左侧地图窗口显示出每幅影像的轮廓，但无影像显示，则可判定预览无影像的原因是影像没有统计信息。
- 如果左侧地图窗口未显示出每幅影像的轮廓，则可判定预览无影像的原因是影像文件坐标信息有误。
解决方法：参见下文：
影像文件坐标信息有误包括：影像文件坐标信息错误和没有坐标信息。
影像文件坐标信息错误，导致影像在动态投影到集合坐标系时，无法正确转换，此坐标系问题暂无解决方法。
影像文件没有坐标信息，如下左图，在桌面中会显示为平面坐标系，如下右图。这种情况下，需要明确知晓原始影像文件坐标系，才能通过下文操作解决，否则暂无解决方法。
例如，上图所示的影像文件，其坐标系信息为空，但是明确知道该影像文件的坐标系为 EPSG 2381。根据应用场景不同，有两种解决方案：
- 第一种：集合与影像文件坐标系相同
重新“添加影像集合”，集合的坐标系设置为原始影像文件的坐标系，例如：EPSG：2381。
此方案中原始影像文件与集合的坐标系一致，不涉及影像的动态投影。
- 第二种：集合与影像文件坐标系不同
重新“添加影像集合”。此操作前，需要为原始影像文件配置正确的坐标系信息。
此方案中原始影像文件与集合的坐标系不同，需要原始影像文件的坐标信息进行动态投影。
为每一幅没有坐标系信息的影像文件提供一个.prj坐标系信息文件，.prj文件名与影像文件名相同，并存放在影像文件同级目录下。例如：本例中的影像文件：F48G002079.tif，其坐标信息文件应为：F48G002079.prj。
.prj坐标系信息文件内容如下所示，例如：EPSG 2381 坐标系描述文本。
每一幅影像都配置了坐标信息文件后，即可重新“添加影像集合”
影像服务缓存相关
- 影像服务动态缓存目录在哪里？
答：iServer默认的缓存目录为：安装目录\webapps\iserver\output，该目录下将以服务名称为文件夹名称存放对应服务的动态缓存瓦片。默认缓存目录可以在影像服务管理页面中的“瓦片存储配置信息”进行修改，如下图所示，如果在此处修改了缓存目录，则缓存目录为修改后的位置。
影像服务中所有影像集合的动态缓存瓦片和静默切片瓦片，共用下图所示的缓存目录（瓦片存储路径）和瓦片存储类型配置。
目前，动态出图的结果瓦片暂不支持缓存到MongoDB数据库。
- 影像集合启动了静默切片，切片结果目录在哪里？
答：静默切片默认结果目录为iServer默认的缓存目录：安装目录\webapps\iserver\output。静默切片目录可以在影像服务管理页面中的“瓦片存储配置信息”进行修改，如下图所示，如果在此处修改了缓存目录，则静默切片目录为修改后的位置。
影像服务中所有影像集合的动态缓存瓦片和静默切片瓦片，共用下图所示的缓存目录（瓦片存储路径）和瓦片存储类型配置。
当瓦片存储类型为MongoDB时，暂不支持影像集合的补切瓦片操作。
- 影像集合启动了静默切片，能否终止？
答：在影像集合“瓦片配置”页的“静默切片”区域，取消“立即执行”和“计划任务”，保存配置，即可终止静默切片任务。
- 浏览影像集合中的影像或者请求瓦片后，缓存目录下没有缓存动态生成的瓦片？
答：首先，确定一下动态缓存的目录是否正确，默认目录为：iServer安装目录\webapps\iserver\output，该目录下将以服务名称为文件夹名称存放对应服务的动态缓存瓦片。默认缓存目录可以在影像服务管理页面中的“瓦片存储配置信息”进行修改，如下图所示，如果在此处修改了缓存目录，则缓存目录为修改后的位置。
注意：下图所示的瓦片存储配置将应用于该服务中的所有影像集合。
其次，在影像集合“瓦片配置”页，请确认是否开启了“是否启用动态缓存”，开启后，才会缓存动态生成的瓦片。
影像集合的存储与数据配置
- 发布影像服务时，并没有指定影像集合存储的数据源，影像集合存储在哪里了？
答：影像集合默认存储在临时的UDBX数据源中，该数据源位于“iServer安装目录\temp\iserver-imageservice\”目录下，数据源文件名称同影像服务名称。
- 添加影像集合时，通过清单文件配置影像集合的数据来源，结果添加失败或者影像缺失？
答：检查清单文件的格式是否正确，清单文件是一个.txt文件，内容为一行记录对应一个影像文件的全路径。关于清单文件的编码没有特殊要求，但是，若清单文件编码为UTF-8，则必须是“UTF-8 无BOM格式编码”。
- 添加影像集合时，通过影像数据目录配置影像集合的数据来源，目录下的影像并未完全添加到集合？
答：此问题可以从以下几个方面排查：
第一，检查在配置影像数据目录后，是否勾选了要添加的文件类型。
第二，影像数据目录下的子文件夹中的影像是否需要添加到影像集合，如果需要，需要开启“搜索子文件夹中的文件”。
第三，影像集合的数据来源于多个影像数据目录时，检查多个目录是否使用英文逗号进行了分隔。
- 添加影像集合时，未指定集合的坐标系，那么集合坐标系默认是什么？
答：若未指定影像集合坐标系，集合的坐标系默认为 EPSG 4326，即 WGS 1984 地理坐标系。
- 基于已有的镶嵌数据集创建影像集合后，为什么更新了镶嵌数据集后，对应服务没有更新？
答：基于已有的镶嵌数据集发布影像服务，默认复制镶嵌数据集到影像服务的“存储影像集合的数据源”中，作为集合镶嵌数据集；此时，对已有镶嵌数据集操作不会影响到影像集合，反之亦然。
- 影像集合支持管理哪些存储媒介中的影像文件以及如何配置？
答：影像集合支持管理的影像文件类型包括：.tif、.img、.ecw和.pix，还支持管理卫星影像数据产品。而上述这些影像数据可以来源于多种存储媒介，具体有：
- 本地存储，包括Windows和Linux系统；
- NAS网络存储，支持FTP、NFS、SMB访问协议；
- 对象存储，包括：华为OBS对象存储服务、阿里OSS对象存储服务、S3简单存储服务，既支持HTTP访问协议；也可以通过GDAL的vsis3和vsioss文件系统处理程序来访问AWS S3和阿里OSS对象存储桶中的影像文件；
- FTP服务器；
- 远程共享目录(NFS)。
影像数据下载
- 影像集合完成了数据可下载的相关配置，但数据仍无法下载？
答：此问题可以从以下几个方面排查：
第一，在服务管理页面中，确认影像集合的“允许数据下载”项是勾选状态。
第二，对应的影像服务组件配置页中，确认“允许数据下载”项是勾选状态。
第三，影像数据目录发布后，是否可以通过URL下载到，若不能，请检查影像数据目录发布环节是否存在问题。
第四，所下载的影像文件必须是影像集合所配置的影像目录下的影像文件，而不能是其他目录下的副本，例如，影像集合中某影像文件的路径为：E:\imageChina\H48C002002.tif，另外一个目录E:\imageChinaCopy下也存储相同的影像文件（E:\imageChinaCopy\H48C002002.tif），且用户发布的目录是“E:\imageChinaCopy”，配置的数据资产访问地址映射也基于这个副本目录，这样的部署也是无法通过影像服务下载到影像数据，正确的做法是：发布E:\imageChina数据目录（即影像集合配置的影像数据目录），并在数据资产访问地址映射中也配置此目录。