Oracle Maps HTML5 JavaScript API Reference

 
Class: DynamicTileLayer

OM.layer. DynamicTileLayer

new DynamicTileLayer(name, dtl_props, objMapReq)

This class represents a Dynamic tile layer. It extends TileLayer.

Parameters:
Name Type Description
name String

A unique dynamic tile layer name.
dtl_props Object

A JSON object that specifies dynamic tile layer related parameters. It may have the following attributes.


  • dataSource {String}: Optional. The data source where the MapViewer resources are accessed. If not provided, it uses the one defined in the ServerMapRequest object

  • tileServerURL {String}: The map image tile server URL. For example, "http://maps.oracle.com/mapviewer/omserver"

  • tileLayerConfig {OM.layer.TileLayerConfig}: The dynamic tile layer configuration object.

  • universe {OM.universe.Universe}: The dynamic tile layer universe object

  • enableUTFGrid {Boolean}: Optional. When set to true, a tile request will fetch a companian UTFGrid dataset
  • enableUTFGridInfoWindow {Boolean} When it is set to true, a UTFGrid info window will be displayed. Default is true.
  • utfGridResolution {Integer}: Optional. When enableUTFGrid attribute is set to true, this attribute
    defines the resolution of the UTFGrid dataset. Default value is 4 (i.e., one UTFGrid grid cell
    represents 4*4=16 image pixels).

  • infoWindowTrigger {OM.event.MouseEvent}: Two types are supported, OM.event.MouseEvent.MOUSE_CLICK or OM.event.MouseEvent.MOUSE_OVER.
    Default value is OM.event.MouseEvent.MOUSE_CLICK

  • urlBuilder {Function}: Optional. A function that builds the URL needed to fetch map image tiles from a WMS. For example, the following function builds the URL to fetch images from a GeoServer:
    var urlb = function (w, h, minX, minY, maxX, maxY, options){
    var str="http://myhost:8080/geoserver/ows?";
    var optParams="";
    str = str+"request=getmap"+
    "&bbox="+minX+","+minY+","+maxX+","+maxY+
    "&width="+w+"&height="+h;

    if (!OM.isNull(options)){
        for (var key in options){
            optParams=optParams +"&"+key +"="+options[key];
        }
    }            
    return str+optParams;}  </li>

  • urlBuilderOptions {Object}: Optional. A JSON object that contains the urlBuilder needed parameters. For example
    For example, the following attributes are assigned to the options object to be used by the urlBuilder function for a WMS:
    urlBuilderOptions: {
    "layers": "topp:states,sf:sfdem,sf:roads,sf:streams",
    "CRS": "CRS:84",
    "service": "WMS",
    "version": "1.3.0",
    "format": "image/png"
    }

  • tileURLTemplate {String or an Array URLs } Optional.
    If it is a string, it specifies the tile image URL template. For example:
    tileURLTemplate: "http://my.corp.com/server/tile/{z}/{y}/{x}.png"
    If it is an array, it contains alternating tile server URLs. For example:
    ["https://a.my.corp.com/server/tile/{z}/{y}/{x}.png",
    "https://b.my.corp.com/server/tile/{z}/{y}/{x}.png",
    "https://c.my.corp.com/server/tile/{z}/{y}/{x}.png"]

    		•
    objMapReq OM.server.ServerMapRequest

    A OM.server.ServerMapRequest instance which contains the various parameters needed
    to construct the XMLMapRequest to a MapViewer server to request a tile.
    Optional. It is not needed when a urlBuilder function is provide; otherwise, required.
    Returns:

    An instance of OM.layer.DynamicTileLayer

    Type
    OM.layer.DynamicTileLayer

    Extends

    Methods

    bringForward()

    Bring the layer to the front by one step (closer to the top of the map).

    Inherited From:
    Returns:

    The new z-index

    Type
    int

    bringToTop()

    Bring the layer all the way to the top of the map

    Inherited From:
    Returns:

    The new z-index

    Type
    int

    enableInfoWindow(enable)

    Enable or disable the feature info window.

    Parameters:
    Name Type Description
    enable boolean

    Enable or disable feature info window. By default,
    the info window is enabled.
    Inherited From:
    Returns:
    Type
    void

    enableUTFGridInfoWindow(status)

    Enable or disable the UTFGrid Info Window when applicable

    Parameters:
    Name Type Description
    status boolean

    true or false to enable or disable the default (built-in) utfgrid info window
    Inherited From:

    getCustomTags()

    Get custom tags from tile layer

    Inherited From:
    Returns:

    An object defined custom tags if any

    Type
    Object

    getCustomURL(x, y, z)

    Parameters:
    Name Type Description
    x Number

    Tile coordinate x.
    y Number

    Tile coordinate y.
    z Number

    Tile zoom level.
    z: zoom level
    Returns:

    the image url

    getEnableInfoWindow()

    get the enable infowindow status: true for enabled and false otherwise
    the info window is enabled.

    Inherited From:
    Returns:

    true or false

    Type
    boolean

    getName()

    Get the layer name.

    Inherited From:
    Returns:

    The layer name

    Type
    String

    getOpacity()

    Get the layer's current opacity setting.

    Inherited From:
    Returns:

    The layer's opacity. Is a value between 0 and 1.

    Type
    float

    getStaticMapURL(width)

    This method returns a static URL of the displayed map.
    This URL may be used to print the map in a dimention specified by the width and height arguments.

    Parameters:
    Name Type Description
    width int

    The image width in pixels to contain the current map view.
    Returns:

    An XML map request. This reques can be used to fetch the map in current map view.
    The fetched map will fit into the given image dimension specified by the width and height arguments.

    Type
    String

    getTileLayerConfig(callBack)

    Get the tile layer configuration.

    Parameters:
    Name Type Description
    callBack function

    Getting tile layer config is asynchronous. So
    you need a callback fucntion to get result.
    Inherited From:
    Returns:
    Type
    void

    getUTFGridResolution(res)

    parse and return the utfgrid resolution

    Parameters:
    Name Type Description
    res string

    The utfgrid resolution. Can be either a string or a number
    Inherited From:
    Returns:

    the utfgrid resolution

    Type
    number

    getZIndex()

    Get the layer's z-index.

    Inherited From:
    Returns:

    The z-index value. Returns -1 if the layer was not added to the map.

    Type
    int

    isInZoomLevelRange(curLevel)

    Checks if the current map zoom level is within this layer's visible zoom-level range.

    Parameters:
    Name Type Description
    curLevel int

    Optional, the zoom level to check if it is within the minVisibleLevel and maxVisibleLevel
    range. If not specified, then the current zoom level is used.
    Inherited From:
    Returns:

    true if the current map level is within the layer's zoom level range for
    it to be visible.

    Type
    Boolean

    isVisible(curLevel)

    Get the visibility of the layer.

    Parameters:
    Name Type Description
    curLevel int

    Optional, the zoom level to check if it is within the minVisibleLevel and maxVisibleLevel
    range. If not specified, then the current zoom level is used.
    Inherited From:
    Returns:

    True if the theme-based FOI layer is currently visible,
    False if the theme-based FOI layer is currently not visible

    Type
    Boolean

    on()

    A shorthand name for the member function addListener.

    Inherited From:
    Mixes In:

    redraw()

    Refresh the display of the layer's existing data.

    Inherited From:
    Returns:

    None

    sendBackward()

    Sendthe layer to the back by one step (closer to the bottom of the map).

    Inherited From:
    Returns:

    The new z-index

    Type
    int

    sendToBottom()

    Send the layer all the way to the bottom of the map

    Inherited From:
    Returns:

    The new z-index

    Type
    int

    setBindingParameters(bp)

    Set the binding parameters of a predefined theme in a dynamic tile layer.

    Parameters:
    Name Type Description
    bp object

    An array of JSON object containing themes' binding parameters.
    For example [{'WIND_THEME', [{value:0.0, type:'Double'}, {value:'CA', type:'String'}]}]

    setInfoWindowTrigger(status)

    Enable or disable the UTFGridInfoWindow when applicable

    Parameters:
    Name Type Description
    status boolean

    true or false to enable or disable the default (built-in) utfgrid info window
    Inherited From:

    setName(newName)

    Set the layer name with the given name.

    Parameters:
    Name Type Description
    newName String

    The new layer name to be assigned to this layer.
    Inherited From:
    Returns:
    Type
    None

    setOpacity(opacity)

    Set the layer's opacity. A value between 0 (transparnet) and 1 (opaque).

    Parameters:
    Name Type Description
    opacity float

    It should be a number between 0 and 1. e.g. 0.5 means 50% opacity.
    Inherited From:
    Returns:
    Type
    void

    setVisible(visibility)

    Sets the visibility of the layer.
    Note that the visibility change will NOT be made if the current map zoom level is
    outside the layer's 'visible zoom level range' which is set by setZoomLevelRange() method.

    Parameters:
    Name Type Description
    visibility Boolean

    A Boolean true (show the layer, i.e. make it visible) or false
    (hide the layer).
    Inherited From:
    Returns:

    void}

    Type
    None

    setVisibleBound(bound)

    Set a bound (MBR) for the layer visibility. Only content within the supplied bound will be rendered.
    That is, the map client will only fetch and display map content within this bound.

    Parameters:
    Name Type Description
    bound OM.geometry.Rectangle

    Specifies the layer boundary
    Inherited From:
    Returns:
    Type
    void

    setZIndex()

    Set the z-index for the layer.

    Note: A valid layer z-index should be a number between 1 and n, where n is
    the number of layers that are currently displayed in the map. When the newIndex
    parameter of setZIndex is less than 1, it will be set to 1. If it is
    greater than n, it will be set to n. If z-Index value, newIndex, is already assigned
    to another layer, then it will still be assigned to the current layer (on which this function is invoked).
    One or more of the other layer will be assigned a different z-index value. The changes will depend on
    whether this layer was inserted into the current layer stack or just moved within the layer stack.

    Inherited From:
    Returns:

    The old z-index

    Type
    int

    setZoomLevelOffset(offset)

    set the offset for zoom level for configuration zoom level shift.
    If the config's zoom level 0 matches 1 in the tile image provider, set it to 1
    If the config's zoom level 1 matches 0 in the tile image provider, set it to -1

    Parameters:
    Name Type Description
    offset Number

    The offset value
    Returns:

    null

    setZoomLevelRange(minLevel, maxLevel)

    Set the zoom level range within which this layer is visible. By default
    a layer is set to be visible between a minmum zoom level of 0 and a maximum
    (theoretical) zoom level of 100.

    Parameters:
    Name Type Description
    minLevel int

    Specifies the min level. The layer will not be
    visible if the zoom level is lower than this vlaue.
    maxLevel int

    Specifies the max level. The layer will not be
    visible if the zoom level is higher than this value.
    Inherited From:
    Returns:
    Type
    None