Gdansk Commercial POI Maps
Transkrypt
Gdansk Commercial POI Maps
in association with Gdańsk - commercial POI 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/commercialpoi/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: Layer name Description pl 16 53 6 POI-Żłobki POI-Bary POI- Turystyka Baza noclegowa POI-Biblioteki POI-Cukiernie POI-Dyskoteki POI-Fastfood POI-Fundacje POI-Galerie POI-Gimnazja POI-Hipermarkety POI- Turystyka Hotele POI-Kawiarnie internetowe POI-Kawiarnie POI-Kina POI-Kościoły inne POI-Kościoły katolickie POI-Konsulaty POI-Licea POI-Miejsca charakterystyczne POI- Turystyka Miejsca noclegowe POI-Muzea POI-Poczta POI-Policja POI-Pomniki POI-Przedszkola Inne POI-Przedszkola niepubliczne POI-Przedszkola POI-Zdrowie Przychodnie POZ 24h POI- Zdrowie Przychodnie POZ POI- Turystyka Przystanki tramwajowe 42 55 35 52 41 40 23 54 8 50 51 39 45 46 33 24 56 7 38 28 32 37 18 19 20 3 2 11 Description POI nursery POI Bars POI- Tourism Accommodation POI-Library POI-Confectioners POI-Disco POI-fastfood POI-Foundations POI-Malls POI-Gymnasiums POI-Hypermarkets POI- Hotels Tourism POI-Internet Cafés POI-Cafes POI-Cinemas POI-Churches others POI-Catholic Churches POI-Consulates POI-high schools POI-Place characteristic POI- Tourism Accommodation POI-Museums POI-Post Office POI-police POI-Monuments POI-Kindergarten Other POI-Kindergarten commercial POI-Kindergarten Other POI-Health Clinics 7/24 POI-Health Clinics POI- Tourism tram stops 2 in association with 12 POI- Turystyka Przystanki tramwajowe POI-Puby POI-Punkty przedszkolne POI-Ratownictwo POI-Restauracje POI-Turystyka Schroniska PTSM POI-Transport Stacje PKP i SKM POI--Transport Stacje PKP i SKM POI-Straż miejska POI-Szkoły podstawowe POI-Szkoły ponadpodstawowe POI-Szkoły wyższe publiczne POI-Zdrowie Szpitale POI-Teatry POI-Transport Wi-Fi POI-Zespoły Kształcenia Podstawowego i Gimnazjalnego POI-Związki zakonne 49 17 31 48 5 13 14 30 21 25 26 1 36 10 22 44 POI- Tourism tram stops POI- pubs POI-Kindergarten points POI-Rescue POI-Restaurants POI-Tourism Lodges PTSM POI-Transport Railway Stations and SKM POI - Transportation Railway Stations and SKM POI-City Guard POI-Primary Schools POI-secondary schools POI-Public Universities POI-Health Hospitals POI-Theatres POI- Wi-Fi hot spots POI-Teams of Basic Education and Secondary School POI-compounds religious 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