Instances of OpenLayers.Layer.MapGuide are used to display data from a MapGuide OS instance.
| OpenLayers. | Instances of OpenLayers.Layer.MapGuide are used to display data from a MapGuide OS instance. |
| Properties | |
| isBaseLayer | {Boolean} Treat this layer as a base layer. |
| useHttpTile | {Boolean} use a tile cache exposed directly via a webserver rather than the via mapguide server. |
| singleTile | {Boolean} use tile server or request single tile image. |
| useOverlay | {Boolean} flag to indicate if the layer should be retrieved using GETMAPIMAGE (default) or using GETDYNAMICOVERLAY requests. |
| useAsyncOverlay | {Boolean} indicates if the MapGuide site supports the asynchronous GETDYNAMICOVERLAY requests which is available in MapGuide Enterprise 2010 and MapGuide Open Source v2.0.3 or higher. |
| Constants | |
| TILE_PARAMS | {Object} Hashtable of default parameter key/value pairs for tiled layer |
| SINGLE_TILE_PARAMS | {Object} Hashtable of default parameter key/value pairs for untiled layer |
| OVERLAY_PARAMS | {Object} Hashtable of default parameter key/value pairs for untiled layer |
| FOLDER_PARAMS | {Object} Hashtable of parameter key/value pairs which describe the folder structure for tiles as configured in the mapguide serverconfig.ini section [TileServiceProperties] |
| Properties | |
| defaultSize | {OpenLayers.Size} Tile size as produced by MapGuide server |
| tileOriginCorner | {String} MapGuide tile server uses top-left as tile origin |
| Constructor | |
| OpenLayers. | Create a new Mapguide layer, either tiled or untiled. |
| Functions | |
| clone | Create a clone of this layer |
| getURL | Return a query string for this layer |
| getFullRequestString | getFullRequestString on MapGuide layers is special, because we do a regular expression replace on ‘,’ in parameters to ‘+’. |
| getImageFilePath | special handler to request mapguide tiles from an http exposed tilecache |
| calculateGridLayout | Generate parameters for the grid layout. |
{Boolean} use a tile cache exposed directly via a webserver rather than the via mapguide server. This does require extra configuration on the Mapguide Server, and will only work when singleTile is false. The url for the layer must be set to the webserver path rather than the Mapguide mapagent. See http://trac.osgeo.org
{Boolean} indicates if the MapGuide site supports the asynchronous GETDYNAMICOVERLAY requests which is available in MapGuide Enterprise 2010 and MapGuide Open Source v2.0.3 or higher. The newer versions of MG is called asynchronously, allows selections to be drawn separately from the map and offers styling options.
With older versions of MapGuide, set useAsyncOverlay=false. Note that in this case a synchronous AJAX call is issued and the mapname and session parameters must be used to initialize the layer, not the mapdefinition parameter. Also note that this will issue a synchronous AJAX request before the image request can be issued so the users browser may lock up if the MG Web tier does not respond in a timely fashion.
{OpenLayers.Size} Tile size as produced by MapGuide server
Create a new Mapguide layer, either tiled or untiled.
For tiled layers, the ‘groupName’ and ‘mapDefinition’ values must be specified as parameters in the constructor.
For untiled base layers, specify either combination of ‘mapName’ and ‘session’, or ‘mapDefinition’ and ‘locale’.
For older versions of MapGuide and overlay layers, set useAsyncOverlay to false and in this case mapName and session are required parameters for the constructor.
NOTE: MapGuide OS uses a DPI value and degrees to meters conversion factor that are different than the defaults used in OpenLayers, so these must be adjusted accordingly in your application. See the MapGuide example for how to set these values for MGOS.
| name | {String} Name of the layer displayed in the interface |
| url | {String} Location of the MapGuide mapagent executable (e.g. http://localhost:8008 |
| params | {Object} hashtable of additional parameters to use. Some parameters may require additional code on the server. The ones that you may want to use are: |
| options | {Object} Hashtable of extra options to tag onto the layer; will vary depending if tiled or untiled maps are being requested |
clone: function ( obj )
Create a clone of this layer
{OpenLayers.Layer.MapGuide} An exact clone of this layer
getURL: function ( bounds )
Return a query string for this layer
| bounds | {OpenLayers.Bounds} A bounds representing the bbox for the request |
{String} A string with the layer’s url and parameters and also the passed-in bounds and appropriate tile size specified as parameters.
getFullRequestString:function( newParams, altUrl )
getFullRequestString on MapGuide layers is special, because we do a regular expression replace on ‘,’ in parameters to ‘+’. This is why it is subclassed here.
| altUrl | {String} Alternative base URL to use. |
{String} A string with the layer’s url appropriately encoded for MapGuide
calculateGridLayout: function( bounds, origin, resolution )
Generate parameters for the grid layout. This
| bounds | {<OpenLayers.Bound>} |
| origin | {OpenLayers.LonLat} |
| resolution | {Number} |
{Object} Object containing properties tilelon, tilelat, tileoffsetlat, tileoffsetlat, tileoffsetx, tileoffsety
Create a clone of this layer
clone: function ( obj )
Return a query string for this layer
getURL: function ( bounds )
getFullRequestString on MapGuide layers is special, because we do a regular expression replace on ‘,’ in parameters to ‘+’.
getFullRequestString:function( newParams, altUrl )
special handler to request mapguide tiles from an http exposed tilecache
getImageFilePath:function( newParams, altUrl )
Generate parameters for the grid layout.
calculateGridLayout: function( bounds, origin, resolution )