OpenLayers.Control.WMTSGetFeatureInfo

The WMTSGetFeatureInfo control uses a WMTS query to get information about a point on the map. The information may be in a display-friendly format such as HTML, or a machine-friendly format such as GML, depending on the server’s capabilities and the client’s configuration. This control handles click or hover events, attempts to parse the results using an OpenLayers.Format, and fires a ‘getfeatureinfo’ event for each layer queried.

Inherits from

OpenLayers.Control

Summary

OpenLayers.Control.WMTSGetFeatureInfo	The WMTSGetFeatureInfo control uses a WMTS query to get information about a point on the map.
Properties
hover	{Boolean} Send GetFeatureInfo requests when mouse stops moving.
requestEncoding	{String} One of “KVP” or “REST”.
drillDown	{Boolean} Drill down over all WMTS layers in the map.
maxFeatures	{Integer} Maximum number of features to return from a WMTS query.
clickCallback	{String} The click callback to register in the {OpenLayers.Handler.Click} object created when the hover option is set to false.
layers	{Array(OpenLayers.Layer.WMTS)} The layers to query for feature info.
queryVisible	{Boolean} Filter out hidden layers when searching the map for layers to query.
infoFormat	{String} The mimetype to request from the server
vendorParams	{Object} Additional parameters that will be added to the request, for WMTS implementations that support them.
format	{OpenLayers.Format} A format for parsing GetFeatureInfo responses.
formatOptions	{Object} Optional properties to set on the format (if one is not provided in the format property.
handlerOptions	{Object} Additional options for the handlers used by this control, e.g.
handler	{Object} Reference to the OpenLayers.Handler for this control
hoverRequest	{OpenLayers.Request} contains the currently running hover request (if any).
pending	{Number} The number of pending requests.
Constructor
<OpenLayers.Control.WMTSGetFeatureInfo>
Functions
getInfoForClick	Called on click
getInfoForHover	Pause callback for the hover handler
cancelHover	Cancel callback for the hover handler
findLayers	Internal method to get the layers, independent of whether we are inspecting the map or using a client-provided array
buildRequestOptions	Build an object with the relevant options for the GetFeatureInfo request.
request	Sends a GetFeatureInfo request to the WMTS
handleResponse	Handler for the GetFeatureInfo response.

Properties

hover

{Boolean} Send GetFeatureInfo requests when mouse stops moving. Default is false.

requestEncoding

{String} One of “KVP” or “REST”. Only KVP encoding is supported at this time.

drillDown

{Boolean} Drill down over all WMTS layers in the map. When using drillDown mode, hover is not possible. A getfeatureinfo event will be fired for each layer queried.

maxFeatures

{Integer} Maximum number of features to return from a WMTS query. This sets the feature_count parameter on WMTS GetFeatureInfo requests.

clickCallback

{String} The click callback to register in the {OpenLayers.Handler.Click} object created when the hover option is set to false. Default is “click”.

layers

{Array(OpenLayers.Layer.WMTS)} The layers to query for feature info. If omitted, all map WMTS layers will be considered.

queryVisible

{Boolean} Filter out hidden layers when searching the map for layers to query. Default is true.

infoFormat

{String} The mimetype to request from the server

vendorParams

{Object} Additional parameters that will be added to the request, for WMTS implementations that support them. This could e.g. look like

{
    radius: 5
}

format

{OpenLayers.Format} A format for parsing GetFeatureInfo responses. Default is OpenLayers.Format.WMSGetFeatureInfo.

formatOptions

{Object} Optional properties to set on the format (if one is not provided in the format property.

handlerOptions

{Object} Additional options for the handlers used by this control, e.g.

{
    "click": {delay: 100},
    "hover": {delay: 300}
}

handler

{Object} Reference to the OpenLayers.Handler for this control

hoverRequest

{OpenLayers.Request} contains the currently running hover request (if any).

pending

{Number} The number of pending requests.

Constructor

<OpenLayers.Control.WMTSGetFeatureInfo>

Parameters

options

{Object}

Functions

getInfoForClick

getInfoForClick: function( evt )

Called on click

Parameters

evt	{OpenLayers.Event}

getInfoForHover

getInfoForHover: function( evt )

Pause callback for the hover handler

Parameters

evt

{Object}

cancelHover

cancelHover: function()

Cancel callback for the hover handler

findLayers

findLayers: function()

Internal method to get the layers, independent of whether we are inspecting the map or using a client-provided array

buildRequestOptions

buildRequestOptions: function( layer,
xy )

Build an object with the relevant options for the GetFeatureInfo request.

Parameters

layer	{OpenLayers.Layer.WMTS} A WMTS layer.
xy	{OpenLayers.Pixel} The position on the map where the mouse event occurred.

request

request: function( xy,
options )

Sends a GetFeatureInfo request to the WMTS

Parameters

xy	{OpenLayers.Pixel} The position on the map where the mouse event occurred.
options	{Object} additional options for this method.

Valid options

hover {Boolean} true if we do the request for the hover handler

handleResponse

handleResponse: function( xy,
request,
layer )

Handler for the GetFeatureInfo response.

Parameters

xy	{OpenLayers.Pixel} The position on the map where the mouse event occurred.
request	{XMLHttpRequest} The request object.
layer	{OpenLayers.Layer.WMTS} The queried layer.