瓦片数据服务接口

瓦片数据服务接口

 

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://tile0.tianditu.com/services/A0512_EMap/GetTileData?l=9&x=418&y=70&d=2011-04-22T20:25:15&cd=9999-12-31T00:00:00

当缓存无效时,返回最新版本的瓦片的请求地址：

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“表示有效