影像缩略图

影像缩略图（Thumbnail）指从原始影像生成的一个较小尺寸的图像，缩略图保留了原始图像的重要视觉信息，用于快速预览或识别影像的主要内容。

影像服务中，影像缩略图尺寸的计算方式如下：保持原始影像的宽高比，将原始影像的最小边长缩放到512像素，然后根据相同的缩放比例调整其他边长。因此，缩略图的最小边长尺寸固定为512像素。

1. 缩略图的生成

影像服务发布影像后，默认未创建缩略图，影像缩略图的生成途径包括以下几种：

缩略图将使用影像集合的显示风格渲染，生成缩略图前，需要确认影像集合的显示风格。

• 查看影像文件信息，如上图所示，将生成该影像的缩略图并显示。
• 通过 /collections/{collectionId}/items/{featureId} 资源（返回指定ID（collectionId）影像集合中指定索引（featureId）的Item对象）的GET请求，如下图所示，将生成该影像的缩略图。

  

• 影像服务检索页面中，返回查询结果时，将对所有结果影像生成缩略图。

  

2. 缩略图的存储

影像缩略图将以二进制数据形式存储在影像集合镶嵌数据集属性表的“Thumbnail”字段。

3. 缩略图的显示风格

低于 SuperMap iServer 11i(2024) R1 (Version 11.3.0) 版本，生成的缩略图未进行风格渲染，缩略图与影像集合显示效果可能存在差异。

SuperMap iServer 11i(2024) R1 (Version 11.3.0) 及以上版本，缩略图将使用影像集合的显示风格渲染，因此，缩略图与影像集合显示风格一致。

4. 缩略图的更新

当修改了影像集合的显示风格，已有影像缩略图风格不会自动更新。更新缩略图需要先清除已有缩略图，再重新生成缩略图。

清除已有缩略图，即清空影像集合镶嵌数据集属性表中的“Thumbnail”字段内容，例如：可以通过“数据库端SQL操作”GPA工具，通过SQL语句执行清空属性表“Thumbnail”字段操作，如下图所示，存储在PostGIS数据源中的影像集合镶嵌数据集，使用GPA工具清空“Thumbnail”属性字段，其中：“imagecollectiondatasetMosaic”为集合镶嵌数据集名称，“_F”为必须后缀，表示操作对应的元信息属性表，“thumbnail”为缩略图字段名称。

由于程序会缓存缩略图，因此，重新生成缩略图前需要重启 iServer。重新生成缩略图的方式同《缩略图的生成》。

 

此外， 使用 /collections/{collectionId}/items/{featureId} 资源的GET请求也可以更新影像缩略图，当请求参数“createThumbnail”和“overwriteThumbnail”的值同时为true时，将重新生成影像缩略图并覆盖已有缩略图。

示例：

http://{iServer服务地址:端口}/iserver/services/{imageservice-影像服务名称}/restjsr/collections/{影像集合ID}/items/{featureId}?createThumbnail=true&overwriteThumbnail=true

其中，createThumbnail参数，表示是否生成缩略图，true表示生成，false表示不生成；overwriteThumbnail参数，表示是否重新生成缩略图并覆盖已有缩略图，true表示重新生成并覆盖；false表示不会重新生成缩略图。