DB3708T 58-2024三維地圖平臺(tái)應(yīng)用接口規(guī)范

ICSCCS35.240.99DB3708Specificationforapplicationinterfaceofthe3DmapplatformDB3708/T58—2024前言 2規(guī)范性引用文件 3術(shù)語(yǔ)和定義 4縮略語(yǔ) 5基本規(guī)定 6接口服務(wù)內(nèi)容 6.1接口服務(wù)內(nèi)容分類(lèi) 6.2管理類(lèi)服務(wù)接口 6.3二維地圖類(lèi)服務(wù)接口 6.4三維地圖類(lèi)服務(wù)接口 6.5空間分析類(lèi)服務(wù)接口 7接口使用流程 7.1概述 7.2接口發(fā)現(xiàn) 7.3接口申請(qǐng) 7.4接口調(diào)用 8接口調(diào)用規(guī)范 8.1基本要求 8.2接口規(guī)范 8.3接口操作 8.4響應(yīng)格式 8.5返回碼 9接口安全要求 附錄A（資料性）三維地圖平臺(tái)接口服務(wù) 6附錄B（資料性）三維地圖平臺(tái)應(yīng)用接口代碼示例 參考文獻(xiàn) DB3708/T58—2024本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請(qǐng)注意本文件的某些內(nèi)容可能涉及專(zhuān)利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專(zhuān)利的責(zé)任。本文件由濟(jì)寧市大數(shù)據(jù)局提出、歸口并組織實(shí)施。1DB3708/T58—2024三維地圖平臺(tái)應(yīng)用接口規(guī)范本文件規(guī)定了三維地圖平臺(tái)應(yīng)用接口的服務(wù)內(nèi)容、使用流程、調(diào)用規(guī)范和安全要求。本文件適用于基于三維地圖平臺(tái)的接口進(jìn)行應(yīng)用開(kāi)發(fā)。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T25530—2010地理信息服務(wù)GB/T25597—2010地理信息萬(wàn)維網(wǎng)地圖服務(wù)接口GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求GB/T22240信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)定級(jí)指南GB/T39477信息安全技術(shù)政務(wù)信息共享數(shù)據(jù)安全技術(shù)要求3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1三維地圖平臺(tái)3Dmapplatform面向濟(jì)寧市提供統(tǒng)一的三維地圖數(shù)據(jù)管理、展示應(yīng)用、接口發(fā)布與安全訪(fǎng)問(wèn)管控的系統(tǒng)平臺(tái)。3.2接口interface描述實(shí)體行為特征的命名操作集合。[來(lái)源：GB/T25530—2010,4.2]3.3操作operation對(duì)象可以被調(diào)用執(zhí)行的轉(zhuǎn)換和查詢(xún)的規(guī)范。[來(lái)源：GB/T25530—2010,4.3]3.4服務(wù)service實(shí)體通過(guò)接口（3.2）提供的功能性的獨(dú)特角色。[來(lái)源：GB/T25597—2010,4.13]4縮略語(yǔ)2DB3708/T58—2024下列縮略語(yǔ)適用于本文件。B3DM：批處理三維模型（Batched3DModel)GLTF：圖形語(yǔ)言傳輸格式（GraphicsLanguageTransmissionFormat）I3DM：實(shí)例化三維模型（Instanced3DModel）JSON：一種輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotation）M3D：三維數(shù)據(jù)模型（Modelof3DData）MVT：矢量瓦片（MapboxVectorTile）NETCDF：通用的網(wǎng)絡(luò)數(shù)據(jù)格式（NetworkCommonDataForm)OGC：開(kāi)放地理信息系統(tǒng)協(xié)會(huì)（OpenGISConsortium）XML：可擴(kuò)展標(biāo)記語(yǔ)言（ExtensibleMarkupLanguage）PBF：協(xié)議緩沖區(qū)（ProtocolBuffers）PNTS：點(diǎn)云（POINTS）REST：表述性狀態(tài)轉(zhuǎn)移（RepresentationStateTransfer）S3M：空間三維模型數(shù)據(jù)格式（spatial3Dmodel）SLPK：場(chǎng)景圖層包（SceneLayerPackage）SOAP：簡(jiǎn)單對(duì)象訪(fǎng)問(wèn)協(xié)議（SimpleObjectAccessProtocol）TMS：切片地圖服務(wù)(TilemapServcie)URL：統(tǒng)一資源定位符（UniformResourceLocator）VCTR：矢量數(shù)據(jù)（VectorData）WVTS：矢量瓦片數(shù)據(jù)服務(wù)（WebVectorTileService）5基本規(guī)定5.1坐標(biāo)系統(tǒng)應(yīng)采用2000國(guó)家大地坐標(biāo)系（CGCS2000）。5.2高程基準(zhǔn)應(yīng)采用1985國(guó)家高程基準(zhǔn)。5.3時(shí)間基準(zhǔn)應(yīng)日期采用公歷紀(jì)元，時(shí)間采用北京時(shí)間。6接口服務(wù)內(nèi)容6.1接口服務(wù)內(nèi)容分類(lèi)三維地圖平臺(tái)應(yīng)用接口包括管理類(lèi)服務(wù)接口、二維地圖類(lèi)服務(wù)接口、三維地圖類(lèi)服務(wù)接口、空間分析類(lèi)服務(wù)接口。6.2管理類(lèi)服務(wù)接口提供接口資源查詢(xún)搜索、接口元數(shù)據(jù)獲取和接口訪(fǎng)問(wèn)授權(quán)的能力，包括目錄服務(wù)接口、元數(shù)據(jù)服務(wù)接口和授權(quán)服務(wù)接口，見(jiàn)附錄A。6.3二維地圖類(lèi)服務(wù)接口提供二維矢量、柵格地圖數(shù)據(jù)的服務(wù)接口，包括地圖服務(wù)、要素服務(wù)、覆蓋服務(wù)，見(jiàn)附錄A。6.4三維地圖類(lèi)服務(wù)接口3DB3708/T58—2024提供多種三維數(shù)據(jù)格式的地理信息場(chǎng)景服務(wù)接口，包括高程地形服務(wù)、建筑信息模型數(shù)據(jù)服務(wù)、傾斜攝影模型數(shù)據(jù)服務(wù)、激光點(diǎn)云數(shù)據(jù)服務(wù)、三維手工建模數(shù)據(jù)服務(wù)、體元模型數(shù)據(jù)服務(wù)和三維數(shù)據(jù)切片服務(wù)，見(jiàn)附錄A。6.5空間分析類(lèi)服務(wù)接口提供二三維地理分析服務(wù)接口，包括地理分析服務(wù)、地名地址服務(wù)和時(shí)空分析服務(wù),實(shí)現(xiàn)空間疊加、要素提取、拓?fù)浞治?、柵格處理、地理編碼等能力，見(jiàn)附錄A。7接口使用流程7.1概述三維地圖平臺(tái)接口的使用流程，包括接口發(fā)現(xiàn)、接口申請(qǐng)、接口調(diào)用環(huán)節(jié)，見(jiàn)圖1。接口使用方↓檢索/返回結(jié)果服務(wù)接口目錄查看服務(wù)接口服務(wù)目錄接入申請(qǐng)接入審核↓接口開(kāi)通授權(quán)接入認(rèn)證與接統(tǒng)一服務(wù)網(wǎng)關(guān)授權(quán)憑證反饋↓圖1接口使用流程圖7.2接口發(fā)現(xiàn)接口使用方在三維地圖平臺(tái)查看接口資源列表，獲取所需的接口及元數(shù)據(jù)信息，包括標(biāo)識(shí)、名稱(chēng)、摘要、關(guān)鍵字等，服務(wù)接口元數(shù)據(jù)項(xiàng)見(jiàn)附錄A。7.3接口申請(qǐng)接口使用方提出接口使用權(quán)限申請(qǐng)，三維地圖平臺(tái)通過(guò)身份識(shí)別和鑒權(quán)后，分配接口訪(fǎng)問(wèn)權(quán)限。7.4接口調(diào)用接口使用方通過(guò)三維地圖平臺(tái)服務(wù)網(wǎng)關(guān)進(jìn)行接口調(diào)用，服務(wù)網(wǎng)關(guān)負(fù)責(zé)身份鑒別和權(quán)限驗(yàn)證，鑒權(quán)通過(guò)后將響應(yīng)結(jié)果返回給接口使用方，未通過(guò)鑒權(quán)的拒絕調(diào)用請(qǐng)求。4DB3708/T58—20248接口調(diào)用規(guī)范8.1基本要求8.1.1接口形式三維地圖平臺(tái)對(duì)外提供的接口調(diào)用的URI格式為：{baseurl}/services/[catalogue]/{serviceName}URI的表述格式應(yīng)包括相對(duì)服務(wù)基地址｛baseurl｝的相對(duì)路徑，URI由網(wǎng)絡(luò)協(xié)議名稱(chēng)、主機(jī)地址、端口、相對(duì)路徑、服務(wù)參數(shù)等構(gòu)成，catalogue為可選的分類(lèi)編目，serviceName為服務(wù)名稱(chēng)。8.1.2請(qǐng)求協(xié)議遵循HTTP或HTTPS協(xié)議標(biāo)準(zhǔn)。8.1.3請(qǐng)求方式支持Restful、KVP或SOAP的接口請(qǐng)求方式。8.1.4請(qǐng)求操作通過(guò)GET或POST方法獲取三維地圖平臺(tái)接口資源。8.1.5安全認(rèn)證采取用戶(hù)身份鑒別、數(shù)據(jù)安全等級(jí)標(biāo)記、數(shù)據(jù)授權(quán)、強(qiáng)制訪(fǎng)問(wèn)控制等措施，通過(guò)三維地圖平臺(tái)實(shí)現(xiàn)對(duì)用戶(hù)認(rèn)證、接口訪(fǎng)問(wèn)等權(quán)限的控制。8.2接口規(guī)范管理類(lèi)服務(wù)接口遵循WebService規(guī)范，支持Restfull；二維地圖類(lèi)、三維地圖類(lèi)、空間分析類(lèi)服務(wù)接口遵循OGC規(guī)范，見(jiàn)附錄A。8.3接口操作三維地圖平臺(tái)接口調(diào)用遵循的操作規(guī)范見(jiàn)表1，示例代碼見(jiàn)附錄B。表1接口操作規(guī)范表5DB3708/T58—20248.4響應(yīng)格式接口調(diào)用的響應(yīng)結(jié)果數(shù)據(jù)格式見(jiàn)表2，示例代碼見(jiàn)附錄B。表2接口返回?cái)?shù)據(jù)格式MVT/PNG/JPEG/TIFF/NETCDF/GeoB3DM/I3DM/PNTS/VCTR8.5返回碼接口調(diào)用的響應(yīng)結(jié)果返回碼見(jiàn)表3。表3接口返回?cái)?shù)據(jù)格式請(qǐng)求失敗，程序執(zhí)行異常或失敗，無(wú)法返回請(qǐng)求失敗，服務(wù)器遇到意外狀況，導(dǎo)致無(wú)法完9接口安全要求接口按照《測(cè)繪地理信息管理工作國(guó)家秘密范圍的規(guī)定》的通知（自然資發(fā)〔2020〕95號(hào)）規(guī)定進(jìn)行數(shù)據(jù)分類(lèi)分級(jí)使用，網(wǎng)絡(luò)安全等級(jí)保護(hù)及政務(wù)信息共享安全應(yīng)符合GB/T22239、GB/T22240、GB/T39477要求。6DB3708/T58—2024（資料性）三維地圖平臺(tái)接口服務(wù)A.1接口服務(wù)內(nèi)容接口服務(wù)內(nèi)容見(jiàn)表A.1。表A.1接口服務(wù)內(nèi)容7DB3708/T58—2024口A(yíng).2管理類(lèi)服務(wù)-數(shù)據(jù)目錄接口管理類(lèi)服務(wù)-數(shù)據(jù)目錄接口見(jiàn)表A.2。表A.2管理類(lèi)服務(wù)-數(shù)據(jù)目錄接口A(yíng).3管理類(lèi)服務(wù)-元數(shù)據(jù)接口管理類(lèi)服務(wù)-元數(shù)據(jù)接口見(jiàn)表A.3。表A.3管理類(lèi)服務(wù)-元數(shù)據(jù)接口8DB3708/T58—2024A.4管理類(lèi)服務(wù)-授權(quán)管理接口管理類(lèi)服務(wù)-授權(quán)管理接口見(jiàn)表A.4。表A.4管理類(lèi)服務(wù)-授權(quán)管理接口A(yíng).5服務(wù)接口元數(shù)據(jù)表服務(wù)接口元數(shù)據(jù)表見(jiàn)表A.5。表A.5服務(wù)接口元數(shù)據(jù)表9DB3708/T58—2024全DB3708/T58—2024（資料性）三維地圖平臺(tái)應(yīng)用接口代碼示例B.1管理類(lèi)服務(wù)接口a)元數(shù)據(jù)服務(wù)接口請(qǐng)求示例：:6080/services/manage/services/getServiceMetadata/?serviceid=5C4DF7B29736&key=“密鑰”b)元數(shù)據(jù)服務(wù)接口返回示例：{"identifier":"A4EF5568-DA3F-4AAD-B3D5-5C4DF7B29736","title":"jiningDEM_LERC_IMG","alias":"濟(jì)寧市高程地形服務(wù)","description":"濟(jì)寧市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":"濟(jì)寧市大數(shù)據(jù)局","publicationDate":"2023-10-22","revisionDate":"2024-5-15","version":"1.1","securitylevel":"0","constraints":"anymous","customizations":""}B.2二維地理圖服務(wù)接口a)二維要素服務(wù)WFS接口GetFeature操作請(qǐng)求參數(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)二維要素服務(wù)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>DB3708/T58—2024<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三維地圖類(lèi)服務(wù)接口a)以i3s規(guī)范為例，建筑信息模型服務(wù)接口請(qǐng)求示例::6080/services/3D/BuildingSceneLayer/SceneServer/layers/0b)以i3s規(guī)范為例，建筑信息模型服務(wù)接口返回示例:{"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":"modelName":"group","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,{"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空間分析類(lèi)服務(wù)接口a)地理分析服務(wù)(WPS)接口Execute操作請(qǐng)求參數(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:Input><wps:Inputid=”DISTANCE”><wps:Data>10</wps:Data></wps:Input><wps:Outputid=”BUFFERED_GEOMETRY”wps:dataTransmissionMode=“reference”></wps:Output></wps:Execute>b)地理分析服務(wù)(WPS)接口分析執(zhí)行的返回結(jié)果示例：<wps:Resultxmlns:ows=“/ows/2.0”xmlns:wps=“/wps/2.0.0”xmlns:xlink=“/1999/xlink”xmlns:xsi=“/2001/XMLSchema-instance”xsi:schemaL