DB3708T 58-2024.三維地圖平臺應用接口規(guī)范

ICS35.240.99CCSL67DB3708Specificationforapplicationinterfaceofthe3DmapplatformDB3708/T58—2024前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5基本規(guī)定 6接口服務內(nèi)容 6.1接口服務內(nèi)容分類 6.2管理類服務接口 6.3二維地圖類服務接口 6.4三維地圖類服務接口 6.5空間分析類服務接口 7接口使用流程 7.1概述 7.2接口發(fā)現(xiàn) 7.3接口申請 7.4接口調(diào)用 8接口調(diào)用規(guī)范 8.1基本要求 8.2接口規(guī)范 8.3接口操作 8.4響應格式 8.5返回碼 9接口安全要求 附錄A（資料性）三維地圖平臺接口服務 附錄B（資料性）三維地圖平臺應用接口代碼示例 參考文獻 DB3708/T58—2024本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構(gòu)不承擔識別專利的責任。本文件由濟寧市大數(shù)據(jù)局提出、歸口并組織實施。DB3708/T58—20241三維地圖平臺應用接口規(guī)范本文件規(guī)定了三維地圖平臺應用接口的服務內(nèi)容、使用流程、調(diào)用規(guī)范和安全要求。本文件適用于基于三維地圖平臺的接口進行應用開發(fā)。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T25530—2010地理信息服務GB/T25597—2010地理信息萬維網(wǎng)地圖服務接口GB/T22239信息安全技術(shù)網(wǎng)絡安全等級保護基本要求GB/T22240信息安全技術(shù)網(wǎng)絡安全等級保護定級指南GB/T39477信息安全技術(shù)政務信息共享數(shù)據(jù)安全技術(shù)要求3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1三維地圖平臺3Dmapplatform面向濟寧市提供統(tǒng)一的三維地圖數(shù)據(jù)管理、展示應用、接口發(fā)布與安全訪問管控的系統(tǒng)平臺。3.2接口interface描述實體行為特征的命名操作集合。[來源：GB/T25530—2010,4.2]3.3操作operation對象可以被調(diào)用執(zhí)行的轉(zhuǎn)換和查詢的規(guī)范。[來源：GB/T25530—2010,4.3]3.4服務service實體通過接口（3.2）提供的功能性的獨特角色。[來源：GB/T25597—2010,4.13]4縮略語DB3708/T58—20242下列縮略語適用于本文件。B3DM：批處理三維模型（Batched3DModel)GLTF：圖形語言傳輸格式（GraphicsLanguageTransmissionFormat）I3DM：實例化三維模型（Instanced3DModel）JSON：一種輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）M3D：三維數(shù)據(jù)模型（Modelof3DData）MVT：矢量瓦片（MapboxVectorTile）NETCDF：通用的網(wǎng)絡數(shù)據(jù)格式（NetworkCommonDataForm)OGC：開放地理信息系統(tǒng)協(xié)會（OpenGISConsortium）XML：可擴展標記語言（ExtensibleMarkupLanguage）PBF：協(xié)議緩沖區(qū)（ProtocolBuffers）PNTS：點云（POINTS）REST：表述性狀態(tài)轉(zhuǎn)移（RepresentationStateTransfer）S3M：空間三維模型數(shù)據(jù)格式（spatial3Dmodel）SLPK：場景圖層包（SceneLayerPackage）SOAP：簡單對象訪問協(xié)議（SimpleObjectAccessProtocol）TMS：切片地圖服務(TilemapServcie)URL：統(tǒng)一資源定位符（UniformResourceLocator）VCTR：矢量數(shù)據(jù)（VectorData）WVTS：矢量瓦片數(shù)據(jù)服務（WebVectorTileService）5基本規(guī)定5.1坐標系統(tǒng)應采用2000國家大地坐標系（CGCS2000）。5.2高程基準應采用1985國家高程基準。5.3時間基準應日期采用公歷紀元，時間采用北京時間。6接口服務內(nèi)容6.1接口服務內(nèi)容分類三維地圖平臺應用接口包括管理類服務接口、二維地圖類服務接口、三維地圖類服務接口、空間分析類服務接口。6.2管理類服務接口提供接口資源查詢搜索、接口元數(shù)據(jù)獲取和接口訪問授權(quán)的能力，包括目錄服務接口、元數(shù)據(jù)服務接口和授權(quán)服務接口，見附錄A。6.3二維地圖類服務接口提供二維矢量、柵格地圖數(shù)據(jù)的服務接口，包括地圖服務、要素服務、覆蓋服務，見附錄A。6.4三維地圖類服務接口DB3708/T58—20243提供多種三維數(shù)據(jù)格式的地理信息場景服務接口，包括高程地形服務、建筑信息模型數(shù)據(jù)服務、傾斜攝影模型數(shù)據(jù)服務、激光點云數(shù)據(jù)服務、三維手工建模數(shù)據(jù)服務、體元模型數(shù)據(jù)服務和三維數(shù)據(jù)切片服務，見附錄A。6.5空間分析類服務接口提供二三維地理分析服務接口，包括地理分析服務、地名地址服務和時空分析服務,實現(xiàn)空間疊加、要素提取、拓撲分析、柵格處理、地理編碼等能力，見附錄A。7接口使用流程7.1概述三維地圖平臺接口的使用流程，包括接口發(fā)現(xiàn)、接口申請、接口調(diào)用環(huán)節(jié)，見圖1。接口使用方檢索/返回結(jié)果服務接口目錄查看服務接口服務目錄接入申請接入審核接口開通授權(quán)接入認證與接統(tǒng)一服務網(wǎng)關(guān)授權(quán)憑證反饋圖1接口使用流程圖7.2接口發(fā)現(xiàn)接口使用方在三維地圖平臺查看接口資源列表，獲取所需的接口及元數(shù)據(jù)信息，包括標識、名稱、摘要、關(guān)鍵字等，服務接口元數(shù)據(jù)項見附錄A。7.3接口申請接口使用方提出接口使用權(quán)限申請，三維地圖平臺通過身份識別和鑒權(quán)后，分配接口訪問權(quán)限。7.4接口調(diào)用接口使用方通過三維地圖平臺服務網(wǎng)關(guān)進行接口調(diào)用，服務網(wǎng)關(guān)負責身份鑒別和權(quán)限驗證，鑒權(quán)通過后將響應結(jié)果返回給接口使用方，未通過鑒權(quán)的拒絕調(diào)用請求。DB3708/T58—202448接口調(diào)用規(guī)范8.1基本要求8.1.1接口形式三維地圖平臺對外提供的接口調(diào)用的URI格式為：{baseurl}/services/[catalogue]/{serviceName}URI的表述格式應包括相對服務基地址｛baseurl｝的相對路徑，URI由網(wǎng)絡協(xié)議名稱、主機地址、端口、相對路徑、服務參數(shù)等構(gòu)成，catalogue為可選的分類編目，serviceName為服務名稱。8.1.2請求協(xié)議遵循HTTP或HTTPS協(xié)議標準。8.1.3請求方式支持Restful、KVP或SOAP的接口請求方式。8.1.4請求操作通過GET或POST方法獲取三維地圖平臺接口資源。8.1.5安全認證采取用戶身份鑒別、數(shù)據(jù)安全等級標記、數(shù)據(jù)授權(quán)、強制訪問控制等措施，通過三維地圖平臺實現(xiàn)對用戶認證、接口訪問等權(quán)限的控制。8.2接口規(guī)范管理類服務接口遵循WebService規(guī)范，支持Restfull；二維地圖類、三維地圖類、空間分析類服務接口遵循OGC規(guī)范，見附錄A。8.3接口操作三維地圖平臺接口調(diào)用遵循的操作規(guī)范見表1，示例代碼見附錄B。表1接口操作規(guī)范表DB3708/T58—202458.4響應格式接口調(diào)用的響應結(jié)果數(shù)據(jù)格式見表2，示例代碼見附錄B。表2接口返回數(shù)據(jù)格式MVT/PNG/JPEG/TIFF/NETCDF/GeoB3DM/I3DM/PNTS/VCTR8.5返回碼接口調(diào)用的響應結(jié)果返回碼見表3。表3接口返回數(shù)據(jù)格式請求失敗，程序執(zhí)行異?；蚴?，無法返回請求失敗，服務器遇到意外狀況，導致無法完9接口安全要求接口按照《測繪地理信息管理工作國家秘密范圍的規(guī)定》的通知（自然資發(fā)〔2020〕95號）規(guī)定進行數(shù)據(jù)分類分級使用，網(wǎng)絡安全等級保護及政務信息共享安全應符合GB/T22239、GB/T22240、GB/T39477要求。DB3708/T58—20246（資料性）三維地圖平臺接口服務A.1接口服務內(nèi)容接口服務內(nèi)容見表A.1。表A.1接口服務內(nèi)容7口A.2管理類服務-數(shù)據(jù)目錄接口管理類服務-數(shù)據(jù)目錄接口見表A.2。表A.2管理類服務-數(shù)據(jù)目錄接口A.3管理類服務-元數(shù)據(jù)接口管理類服務-元數(shù)據(jù)接口見表A.3。表A.3管理類服務-元數(shù)據(jù)接口8A.4管理類服務-授權(quán)管理接口管理類服務-授權(quán)管理接口見表A.4。表A.4管理類服務-授權(quán)管理接口A.5服務接口元數(shù)據(jù)表服務接口元數(shù)據(jù)表見表A.5。表A.5服務接口元數(shù)據(jù)表9全DB3708/T58—2024（資料性）三維地圖平臺應用接口代碼示例B.1管理類服務接口a)元數(shù)據(jù)服務接口請求示例：:6080/services/manage/services/getServiceMetadata/?serviceid=5C4DF7B29736&key=“密鑰”b)元數(shù)據(jù)服務接口返回示例：{"identifier":"A4EF5568-DA3F-4AAD-B3D5-5C4DF7B29736","title":"jiningDEM_LERC_IMG","alias":"濟寧市高程地形服務","description":"濟寧市30米分辨率高程地形","tags":"DEM,地形","url":":6081/geoscene/rest/services/jiningdem/ImageServer","thumbnail":"","type":"3DMap","crs":"4549","scale":"","resolution":"","extent":"[[12957136.7712000,4180572.7383000],[12997539.0672000,4241668.4038000]"center":"12977337.9192,4211120.57105","layercount":"1","layersdes":"jiningdem","publisher":"濟寧市大數(shù)據(jù)局","publicationDate":"2023-10-22","revisionDate":"2024-5-15","version":"1.1","securitylevel":"0","constraints":"anymous","customizations":""}B.2二維地理圖服務接口a)二維要素服務WFS接口GetFeature操作請求參數(shù)示例：<?xmlversion="1.0"?><GetFeatureversion="2.0.0"DB3708/T58—2024service="WFS"xmlns="/wfs/2.0"xmlns:fes="/fes/2.0"xmlns:myns="/myns"xmlns:xsi="/2001/XMLSchema-instance"xsi:schemaLocation="/wfs/2.0/wfs/2.0/wfs.xsd"><QuerytypeNames="myns:InWaterA_1M"><PropertyName>myns:wkbGeom</PropertyName><PropertyName>myns:tileId</PropertyName><fes:Filter><fes:ResourceId<fes:ResourceId<fes:ResourceId</fes:Filter></Query>rid="InWaterA_1M.1013"/>rid="InWaterA_1M.1014"/>rid="InWaterA_1M.1015"/></GetFeature>b)二維要素服務WFS接口GetFeature操作返回示例：<?xmlversion="1.0"?><wfs:FeatureCollectiontimeStamp="2010-02-01T22:56:09"numberMatched="10"numberReturned="10"xmlns="/myns"xmlns:myns="/myns"xmlns:wfs="/wfs/2.0"xmlns:gml="/gml/3.2"xmlns:xsi="/2001/XMLSchema-instance"xsi:schemaLocation="/myns./GetFeature_05.xsd/wfs/2.0/wfs/2.0/wfs.xsd/gml/3.2/gml/3.2.1/gml.xsd"><wfs:boundedBy><gml:EnvelopesrsName="urn:ogc:def:crs:EPSG::4490"><gml:lowerCorner>-31.27141761779785115.001335144043</gml:lowerCorner><gml:upperCorner>-30.10202789306641117.9325866699219</gml:upperCorner></gml:Envelope></wfs:boundedBy><wfs:member><InWaterA_1Mgml:id="InWaterA_1M.1013"><wkbGeom><gml:PolygonsrsName="urn:ogc:def:crs:EPSG::4490"gml:id="P1">DB3708/T58—2024<gml:exterior><gml:LinearRing><gml:posList>-30.93597221374512117.6290588378906-30.94830513000489117.6447219848633-30.95219421386719117.6465530395508-30.95219421386719117.6431121826172-30.94802856445312117.6386108398438-30.94799995422363117.6314163208008-30.946138381958117.62850189209-30.94430541992188117.6295852661133-30.93280601501464117.6240539550781-30.92869377136231117.624641418457-30.92386054992676117.6201400756836-30.92111206054688117.6206970214844-30.92458343505859117.6275863647461-30.93597221374512117.6290588378906</gml:posList></gml:LinearRing></gml:exterior></gml:Polygon></wkbGeom><id>28022</id><tileId>177</tileId></InWaterA_1M></wfs:member><wfs:member><InWaterA_1Mgml:id="InWaterA_1M.1014"><wkbGeom><gml:PolygonsrsName="urn:ogc:def:crs:EPSG::4490"gml:id="P2"><gml:exterior><gml:LinearRing><gml:posList>-30.92013931274414117.6552810668945-30.92383384704589117.661361694336-30.93005561828613117.6666412353516-30.93280601501464117.6663589477539-30.93186187744141117.6594467163086-30.93780517578125117.6541137695312-30.94397163391114117.6519470214844-30.94255638122559117.6455535888672-30.93402862548828117.6336364746094-30.92874908447266117.6355285644531-30.92138862609864117.6326370239258-30.92236137390137117.6395568847656-30.91708374023438117.6433029174805-30.91711044311523117.6454467773437-30.92061042785645117.6484985351563-30.92061042785645117.6504135131836-30.91638946533203117.6504440307617-30.92013931274414117.6552810668945</gml:posList></gml:LinearRing></gml:exterior></gml:Polygon></wkbGeom><id>28021</id><tileId>177</tileId></InWaterA_1M></wfs:member><wfs:member><InWaterA_1Mgml:id="InWaterA_1M.1015"><wkbGeom><gml:PolygonsrsName="urn:ogc:def:crs:EPSG::4490"gml:id="P3"><gml:exterior><gml:LinearRing><gml:posList>-31.27141761779785117.9237747192383-31.2668342590332117.9219131469727-31.26474952697754117.9165802001953-31.26177787780761117.9173889160156-31.25813865661621117.9240798950195-31.25927734375117.928337097168-31.26297187805175117.9320526123047-31.26572227478028117.9325866699219-31.27097129821777117.9283065795898-31.27141761779785117.9237747192383</gml:posList></gml:LinearRing></gml:exterior></gml:Polygon></wkbGeom><id>28074</id><tileId>177</tileId></InWaterA_1M></wfs:member></wfs:FeatureCollection>B.3三維地圖類服務接口a)以i3s規(guī)范為例，建筑信息模型服務接口請求示例::6080/services/3D/BuildingSceneLayer/SceneServer/layers/0b)以i3s規(guī)范為例，建筑信息模型服務接口返回示例:{"name":"school","serviceName":"school","serviceVersion":"1.7","serviceItemId":"21aaf0e7edbb4674b6be09e7867aca91","supportedBindings":["rest""layers":[{"fullExtent":{"ymin":39.9996643630636584,"zmin":-1.2192000000000001,"xmin":115.999392498818935,"ymax":40.0002473679505783,"zmax":12.4854350067935709,"xmax":116.000146873430367,"spatialReference":{"latestVcsWkid":5737,"latestWkid":4490,DB3708/T58—2024}"activeFilterID":"","layerType":"Building","statisticsHRef":"./statistics/summary","sublayers":[{"layerType":"group","modelName":"FullModel","visibility":false,"sublayers":[{"layerType":"group","modelName":"Electrical","visibility":false,"sublayers":[{"layerType":"3DObject","modelName":"LightingFixtures","visibility":true,"name":"LightingFixtures","isEmpty":false,"alias":"LightingFixtures","id":21,"discipline":"Electrical"}"name":"Electrical","isEmpty":false,"alias":"Electrical","id":210{"layerType":"group","modelName":"Structural","visibility":false,"sublayers":[{"layerType":"3DObject","modelName":"StructuralFraming","visibility":true,"name":"StructuralFraming",DB3708/T58—2024"isEmpty":false,"alias":"StructuralFraming","id":20,"discipline":"Structural"{"layerType":"3DObject","modelName":"StructuralColumns","visibility":true,"name":"StructuralColumns","isEmpty":false,"alias":"StructuralColumns","discipline":"Structural"}"name":"Structural","isEmpty":false,"alias":"Structural","id":220{"layerType":"group","modelName":"Architectural","visibility":false,"sublayers":[{"layerType":"3DObject","modelName":"Windows","visibility":true,"name":"Windows","isEmpty":false,"alias":"Windows","discipline":"Architectural"{"layerType":"3DObject","modelName":"Walls","visibility":true,"name":"Walls","isEmpty":false,"alias":"Walls",DB3708/T58—2024"discipline":"Architectural"..."name":"Architectural","isEmpty":false,"alias":"Architectural","id":230}"name":"完整模型","alias":"完整模型","id":200{"layerType":"3DObject","modelName":"Overview","visibility":true,"isEmpty":false,"alias":"概述","id":0}"name":"Technical_school-current_m","alias":"Technical_school-current_m","id":0,"spatialReference":{"latestVcsWkid":5737,"latestWkid":4490,"version":"1.9"}]}B.4空間分析類服務接口a)地理分析服務(WPS)接口Execute操作請求參數(shù)的示例：<wps:Executexmlns:wps=“/wps/2.0.0”DB3708/T58—2024xmlns:ows=“/ows/2.0”xmlns:xlink=“/1999/xlink”xmlns:xsi=“/2001/XMLSchema-instance”xsi:schemaLocation=/wps/2.0.0../wpsExecute.xsdservice=“WPS”version=“2.0.0”response=“document”mode=“async”><ows:Identifier>http://my.wps.server/processes/proximity/Planar-Buffer</ows:Identifier><wps:Inputid=”INPUT_GEOMETRY”><wps:Referencexlink:/wps/2.0.0