Просмотр исходного текста страницы Использование контрола WMSGetFeatureInfo в OpenLayers

== Настройки WMSGetFeatureInfo ==
Краткий перечень наиболее часто используемых настроек контрола:
{|class="wikitable"
! Свойство
! Тип
! Описание
|-
| hover
| {Boolean}
| Запрос GetFeatureInfo выполняется при задержке курсора мыши над объектом. По умолчанию ''false'' и запрос выполняется только по щелчку.
|- 
| maxFeatures
| {Integer}
| Максимальное количество возвращаемых записей, определяет значение параметра FEATURE_COUNT запроса GetFeatureInfo. По умолчанию 10.
|-
| layers
| {Array(OpenLayers.Layer.WMS)}
| Список слоёв, к которым будет выполнен запрос GetFeatureInfo. Если значение не определено, то будут использованы все WMS-слои карты, url которых совпадает со значением свойства url самого контрола или одним из url из массива layerUrls. По умолчанию не определено.
|-
| queryVisible
| {Boolean}
| Если ''true'', исключает скрытые слои из запроса GetFeatureInfo. По умолчанию ''false'', то есть, если слой присутствует среди слоёв, описанных в массиве layers, но при этом выключен на карте, то запрос GetFeatureInfo к этому слою всё равно будет выполнен.
|-
| url
| {String}
| URL сервиса WMS к которому будет осуществляться запрос. Если url не задан при создании контрола WMSGetFeatureInfo, то в качестве значения будет использовано свойство url первого подходящего слоя. По умолчанию не определено.
|-
| infoFormat
| {String}
| MIME-тип ответа, который должен отдать сервер. По умолчанию ''text/html''. При использовании в качестве сервера WMS MapServer может быть использован один из трёх типов: ''text/plain'', ''text/html'' или ''application/vnd.ogc.gml''.
|-
| vendorParams
| {Object}
| Дополнительные параметры, которые будут включены в строку запроса. Например, при таком определении данного свойства: {radius: 10} в запрос добавится подстрока "&RADIUS=10"
|-
| format
| {OpenLayers.Format}
| Формат, используемый для парсинга ответа. По умолчанию OpenLayers.Format.WMSGetFeatureInfo, поэтому для корректного парсинга значение infoFormat контрола должно быть установлено в значение ''application/vnd.ogc.gml''.
|}

Полный список доступных свойств и методов доступен в официальной [http://dev.openlayers.org/releases/OpenLayers-2.11/doc/devdocs/files/OpenLayers/Control/WMSGetFeatureInfo-js.html документации]. Здесь же хотелось бы остановить внимание еще на одном свойстве контрола WMSGetFeatureInfo, наследуемого от OpenLayers.Control - eventListeners. Это объект, который позволяет слушать различные события, происходящие с контролом. Для WMSGetFeatureInfo доступно 3 таких события: ''beforegetfeatureinfo'', ''nogetfeatureinfo'', ''getfeatureinfo''.
* ''beforegetfeatureinfo'' срабатывает перед отправкой запроса на сервер, данное событие удобно использовать, если при каждом запросе к серверу требуется передавать какой-либо изменяющийся параметр. Например:
<syntaxhighlight lang="javascript">
eventListeners: {
    'beforegetfeatureinfo': function() {
        this.vendorParams.settings = Math.random();
    }
}
</syntaxhighlight>
* ''nogetfeatureinfo'' срабатывает в случае если не определено ни одного слоя для запроса.
* ''getfeatureinfo'' наступает в момент получения ответа от сервера.