Gdansk Standard Maps
Transkrypt
Gdansk Standard Maps
in association with Gdańsk - standard maps API allows to obtain standard maps city of Gdańsk for chosen area. API allows access maps layers such as streets, addresses, buildings, tourist information etc. Authorization Basic HTTP Method GET URI https://host:port/wms/gdansk/standard/getmap? center= longitude,latitude&zoom=vale&size=widexheigh&format=value &layers=layer1,layer2,…,layerN where host and port are the host name and port of the machine. Request Parameters The request parameters are mandatory. The parameters for data operation are following: center: coordinates of central point of map longitude, latitude (center= longitude,latitude) The coordinates have to be float values compliant with EPSG 4326 (WGS 84) standard. Example: 20.992 for longitude and 51.242 for latitude. zoom: zoom level of the map (zoom=value) The zoom have to be Int values in range 10-21 size: map picture size in pixels (size= wide x heigh) The size have to be Int values in range 1-1000 format: picture format (format= value) format – correct values: png or jpeg 1 in association with layers: list of layers (layers=layer1,layer2,…,layerN) Layers There are list of supported layers: Gdansk Layer name 45 26 19 16 Description standard map – addresses standard map – buildings standard map – watercourses standard map – cemeteries 34 24 Description pl Mapa bazowa-Adresy Mapa bazowa-Budynki budynki Mapa bazowa-Wody cieki Mapa bazowa- użytkowanie terenu cmentarze Mapa bazowa-Drogi Mapa bazowaWoj. Pomorskie Mapa bazowa-ewidencja -dzialki Mapa bazowa-Dzielnice Mapa bazowa- budynki Ergo Arena Mapa bazowa-Ewidencja Mapa bazowa-glowne koleje Mapa bazowa-główne ulice Mapa bazowa-Gminy Mapa bazowa-Woj. Pomorskie Mapa bazowa-Jezdnie Mapa bazowa-Jezdnie Mapa bazowa-koleje Mapa bazowa-lasy Mapa bazowaWoj. Pomorskie Mapa bazowa- użytkowanie terenu - łąki Mapa bazowa-Miejsca lokalizacyjne Mapa bazowa-Morze Mapa bazowa-najważniejsze ulice Mapa bazowa- uzytkowanie terenu największe lasy Mapa bazowa- użytkowanie terenu lasy Mapa bazowa- uzytkowanie terenu parki Mapa bazowa - nazwy ulic Mapa bazowa - ewidencja obreby 11 Mapa bazowa- uzytkowanie terenu standard map – allotment gardens 4 23 5 28 43 35 2 32 33 42 3 15 46 0 37 12 13 14 standard map – roads standard map – parcels standard map – districts standard map – Ergo Arena standard map – registry standard map – main railways standard map – main streets standard map – municipalities standard map – roadways standard map – roadways standard map – railways standard map – forests standard map – meadows standard map – localization sites standard map – Baltic Sea standard map – major streets standard map – the largest forests standard map – the forests standard map – the parks standard map – street names standard map – precinct 2 in association with 14 27 17 21 8 44 9 40 41 35 31 38 10 7 20 ogrody działkowe Mapa bazowa-parki Mapa bazowa-budynki PGE Arena Mapa bazowa-plaża Mapa bazowa-wody - rzeki Mapa bazowa-uzytkowanie terenu strefy zabudowy Mapa bazowa-Szlaki piesze Mapa bazowa- bazowauzytkowanie terenu tereny przemysłowe Mapa bazowa-tramwaje Mapa bazowa-Transport szynowy Mapa bazowa-ulice Mapa bazowa-komunikajca UliceIdentify Mapa bazowa-ważniejsze ulice Mapa bazowa- uzytkowanie terenu wysypisko Mapa bazowa- bazowauzytkowanie zabudowa Mapa bazowa-Wody - zbiorniki wodne standard map – parks standard map – PGE Arena standard map – beach standard map – rivers standard map – building areas standard map – walking trails standard map – industrial areas standard map – trams standard map – rail transport standard map – streets standard map – identify streets standard map – important streets standard map – garbage dump standard map – buildings standard map – water tanks Response Body The request is converted to WMS standard and redirected to WMS server (HTTP message: 302 – Moved Temporary). On the basis of Location URL indicated in HTTP 302 message the application can download the final response from WMS server. The body of correct response contains the picture of map in requested format (png, jpeg or gif). Empty picture – incorrect value of the zoom parameter. The body of failed response contains the request status and error description as json object : {ApiRequestStatus: { MundoApiStatusInfoObject}} In following structure: {“apistatusinfo” : { “apiname”:” MUNDO WMS map”, “status”: enum {BAD_REQUEST, SERVER ERROR, RESOURCE_ERROR} “errorPhrasse”:”….description of error reason” } 3 in association with e.g. : {"apiStatusInfo":{"apiName":"MUNDO WMS map","status":"BAD_REQUEST","errorPhrase":"Invalid value of parameter 'zoom'; Expected value 1-21"}} Whole API parameters listed at the beginning are mandatory. If the user does not specify parameter, the platform may return an http error response with text description HTTP Status 400 - Required String parameter 'layers' is not present Optionally the WMS server can also return Error response in text format e.g. exception during the generation of map picture. Map picture returned by WMS server can also be empty in case of wrong zoom or picture size (e.g. when zoom will be too small to see the requested map layer details). 400 - Required String parameter 'layers' is not present 4