瓦片数据服务接口
1.1 服务描述
瓦片数据服务(Tile Data Service)用于分发数据,通过应用终端的请求,把影像、地形、矢量、模型、地名等类型的瓦片数据按照应用终端的需要返回给应用终端。当应用终端提交请求时,会带有缓存时间戳信息,瓦片数据服务会根据时间信息验证缓存有效性,当缓存有效时,就不传递数据;当缓存无效时,会传递最新数据下载地址给用户终端,通知其下载最新数据。同时,服务能够提供所发布数据集的相关信息,如数据集地理范围、瓦片分块规则信息等。
本服务包含四个操作:
GetCapabilities返回描述服务所关联的数据集的基本描述信息,如数据集类型、范围、瓦片分块基本规则等;
GetTileData通过瓦片的层、行、列号和应用终端缓存时间等信息,验证缓存的有效性,在应用终端当前缓存无效的情况下负责返回数据提取地址;
1.2 使用协议
本服务接口遵循HTTP协议,用户终端以Get方式向服务提交请求。
1.3 GetCapabilities操作
1.3.1 操作简介
本操作返回描述服务所关联的数据集的基本描述信息,如数据集类型、范围、瓦片分块基本规则等。
1.3.2 参数说明
无
1.3.3 调用方式
KVP encoded举例如下:
http://tile0.tianditu.com/services/A0512_EMap/GetCapabilities
1.3.4 返回结果
返回结果为对服务基本能力的描述的XML。
<GetCapabilitiesResponse xmlns="http://com/geostar/geoglobe/">
<ServiceCapabilities>
<Name>A0512_EMap</Name>
<Service>GeoGlobeTileService</Service>
<Version>2.0.0</Version>
<Abstract/>
<Tags/>
<OnlineResource>http://www.geostar.com.cn</OnlineResource>
<ServerAddress>http://114.255.197.183/services/A0512_EMap</ServerAddress>
<OperationList>
<Operations>
<GetCapabilities>
<Format>text/xml</Format>
</GetCapabilities>
<GetTileData>
<Format>text/xml</Format>
<Format>image/png</Format>
<Format>image/jpeg</Format>
</GetTileData>
<GetTexture>
<Format>text/xml</Format>
<Format>image/png</Format>
<Format>image/jpeg</Format>
</GetTexture>
</Operations>
</OperationList>
<Data>
<TileData>
<Tile>svector</Tile>
<CRS>GEOGCS["WGS_1984",DATUM["WGS_1984",SPHEROID["WGS_1984",6378137,298.257223563]],PRIMEM["Greenwich",0],UNIT["degree",0.0174532925199433]]</CRS>
<BoundBox minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0"/>
<LevelZeroTileSizeX>360.0</LevelZeroTileSizeX>
<LevelZeroTileSizeY>-360.0</LevelZeroTileSizeY>
<TopLevel>1</TopLevel>
<BottomLevel>10</BottomLevel>
<TilePixelsX>256</TilePixelsX>
<TilePixelsY>256</TilePixelsY>
<CacheExpireTime>900</CacheExpireTime>
<Pyramid>
<Basic Name="360度金字塔" PyramidID="72f3fcab-c1c2-4942-bb17-af5a3b469e5d" Description="360度金字塔方案"/>
<Level TopLevelIndex="0" BottomLevelIndex="20" ScaleX="2" ScaleY="2"/>
<TileBasic TileSizeX="256" TileSizeY="256" OriginRowIndex="0" OriginColIndex="0" />
<TopTile FromX="-180.0" FromY="90.0" ToX="180.0" ToY="-270.0" />
<Const PI="3.141592653589793" Tolerance="1.1920928959999998E-7" />
<Range XMin="-180.0" XMax="180.0" YMin="-90.0" YMax="90.0" />
</Pyramid>
</TileData>
</Data>
</ServiceCapabilities>
</GetCapabilitiesResponse>
XML文档元素说明:
元素名称 |
说明 |
Name |
本服务对外名称 |
Service |
标示服务类型为瓦片数据服务 |
Version |
服务版本号 |
Abstract |
服务相关描述信息 |
ServerAddress |
服务访问地址 |
Operations |
对服务几个基本操作的说明 |
Format |
本操作的返回结果格式 |
Tile |
数据集类型,为影像 |
CRS |
坐标参考系 |
LevelZeroTileSizeX |
金字塔顶层瓦片宽度,单位度 |
LevelZeroTileSizeY |
金字塔顶层瓦片高度,单位度 |
TopLevel |
数据集顶层层数 |
BottomLevel |
数据集底层层数 |
TilePixelsX |
瓦片像素宽度 |
TilePixelsY |
瓦片像素高度 |
DEMDataType |
当数据集为地形时,标示类型信息 |
InvalidValue |
无效值 |
InvalidColor |
颜色无效值 |
Transparency |
透明度 |
1.4 GetTileData操作
1.4.1 操作简介
本操作通过瓦片的层、行、列号和应用终端缓存时间等信息验证缓存的有效性。在应用终端当前缓存有效的情况下不会返回图片下载地址;当前缓存无效时则会返回最新版本瓦片的请求地址。用户得到最新的瓦片数据集需要再次调用数据提取地址,返回PNG图片,以供应用终端显示。
1.4.2 参数说明
参数 |
是否可选 |
说明 |
l |
必选 |
请求瓦片的层号 |
x |
必选 |
瓦片列号 |
y |
必选 |
瓦片的行号 |
d |
必选 |
发出请求的当前时间 |
cd |
必选 |
应用终端瓦片缓存时间,还没有缓存时,此值统一赋9999-12-31T00:00:00即可 |
1.4.3 调用方式
KVP encoded举例如下:
验证缓存是否有效的URL:
当缓存无效时,返回最新版本的瓦片的请求地址:
http://114.255.197.183/DataServer?T=A0512_EMap&TILEKEY=2533274790487084&INDATE=2011-01-17 20:55:25
1.4.4 返回结果
返回结果为缓存无效的XML。
<ns2:GetTileDataResponse xmlns:ns2="http://com/geostar/geoglobe/wsdl/BaseTileDataService/">
<ValidateTileInfo>
<CacheTile xmlns="http://com/geostar/geoglobe/" isvalidate="false" />
<NewTile xmlns=http://com/geostar/geoglobe/newtileurl="http://114.255.197.183/DataServer?T=A0512_EMap&TILEKEY=2533274790487084&INDATE=2011-01-17 20:55:25" starttime="2011-01-17T20:55:25.000+08:00"
</ValidateTileInfo>
</ns2:GetTileDataResponse>
XML文档元素说明:
参数 |
说明 |
isvalidate |
表示缓存是否有效:“false“表示无效;”ture“表示有效 |