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

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