Azure maps OGC Map layer Capabilities support

Question

Hi,

we are adding some map layers onto Azure maps using the OGC Map Layer and I have all the sample code working on a local project.

We have some in house built map layers that produce asset tiles for our infrastructure and I've spent a few days now trying to work out why the tiles are not being produced and it seems to be down to when the request is sent off for the tile that the azure maps service is not honouring the capabilities defined by the source service, specifically the "Styles" parameter is being lower cased to "default" instead of the reported "Default", this unfortunately causes the XML response "Styles value is not defined" if I take that same URL and replace the Styles=default with Styles=Default the map tile is produced as expected.

I can't seem to find any configuration options that will effect the url generation, so I am also going to open a support ticket but I was wondering if anyone has seen this behaviour as this basically means I will probably need to request the service that has been built to be modified to be case in sensitive as I have seen the sample WMS services work ok with the lower case default but I haven't seen their capabilities and what they report.

thanks
Michael

Answer 1

I dug into this issue and found a bug in the spatial io module. I've reported it to the dev team, but not sure when it will be fixed in production. That said, I've come up with a simple workaround to unblock you. You can add an option when loading the map to transform requests before they are made. Adding the following to the map options when loading the map will look for this service, and change "default" to "Default". I tested it out with the service you provided and it seemed to work.

transformRequest: function (url, requestType) {
    //Look for requests to the water service that is for an image
    if (url.indexOf('webmap.southeastwater.com.au/WMSWater') > -1) {
        //Using regular expression to replace in case there are multiple styles in the URL.
        return { url: url.replace(/default/gi, 'Default') };
    }

    return { url: url };
}

Answer 2

You can set the "styles" using setOptions. For example:

layer.setOptions({
    styles: 'Default'
})

See if that works. If not, take a look at the capabilities XML and see what the styles area listed in there. Its possible that the XML has a lower case "default" which could be the issue. You can also use the getCapabilities function and look at the response. The sublayers will have a list of supported styles extracted from the XML capabilities.

Note, if there is no style defined in the capabilities, the OgcMapLayer fallback to "default" which is the standard used in most WMS/WMTS services.

If this doesn't work, are you using WMS or WMTS? Is the service publicly accessible? Do you know what the serving platform is; MapServer, GeoServer... and the version.

Answer 3

I'm not sure, when I try and load this using localhost it works fine, I haven't tried hosting it anywhere else. It is possible that their may be a CORs related issue, however if that was the issue, the get capabilities call would have failed. Try panning and zooming around a bit and see if you see any of the data appear.

Try setting the "debug" option of the OgcMapLayer to true. In order to support all the different variations of OGC WMS/WMTS services and it does a lot of testing of URL's until if figures out what works best. This is hidden by default but insights can be seen in the console when debug is set to true.

Here is the complete code sample I used to get this working:

    var map, layer;

    function GetMap() {
        //Initialize a map instance.
        map = new atlas.Map('myMap', {
            center: [145.275505, -38.2],
            zoom: 11,
            view: 'Auto',

            authOptions: {
                authType: 'subscriptionKey',
                subscriptionKey: '<Your Azure Maps Key>'
            },
            transformRequest: function (url, requestType) {
                //Look for requests to the water service that is for an image
                if (url.indexOf('webmap.southeastwater.com.au/WMSWater') > -1) {
                    console.log(url)
                    //Using regular expression to replace in case there are multiple styles.
                    return { url: url.replace(/default/gi, 'Default') };
                }

                return { url: url };
            }
        });

        //Wait until the map resources are ready.
        map.events.add('ready', function () {
            //Create an instance of the OGC map layer and add it to the map. In this case below the transit data (roads).
            layer = new atlas.layer.OgcMapLayer({
                url: 'https://webmap.southeastwater.com.au/WMSWater/Service.svc/get?request=GetCapabilities&service=WMS'
            });
            map.layers.add(layer);
        });
    }

Answer 4

https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-add-ogc-map-layer

I hope it will help

Answer 5

Well this is strange when I set the layer options like that I get the following url generated, it has set the "Styles" parameter to "D" instead of "Default" ?

https://webmap.southeastwater.com.au/WMSWater/service.svc/get?FORMAT=image%2Fpng&HEIGHT=1024&LAYERS=Wa_Pipe_Sew_Opr&REQUEST=GetMap&STYLES=D&TILED=true&TRANSPARENT=true&WIDTH=1024&VERSION=1.3.0&SERVICE=WMS&CRS=EPSG%3A3857&BBOX=16153284.31344973,-4596005.636731077,16155730.298354853,-4593559.651825951

Sorry yes the service is publically accessible below is the capability url

https://webmap.southeastwater.com.au/WMSWater/Service.svc/get?request=GetCapabilities&service=WMS

thanks
Michael