Inputs and Behaviors
The following table lists the possible GetFeatureInfo request inputs.
| Input | Required | Description |
|---|---|---|
VERSION=version |
Yes | Request version. Spectrum Technology Platform WMS supports both version 1.1.1 and 1.3.0 of the OGC specification. |
REQUEST=GetFeatureInfo |
Yes | Request name. For a GetFeatureInfo request this is always GetFeatureInfo. |
<map_request_copy> |
Yes | Partial copy of the GetMap request parameters that generated the map for which information is desired. The spatial reference system, bounding box, width, height, and layers of the GetMap request are required parameters. See the sample request below. |
QUERY_LAYERS=layer_list |
Yes | Comma-separated list of one or more layers to be queried. You do not need to include every layer included in the initial GetMap request. |
INFO_FORMAT=output_format |
YES for 1.3 (optional for 1.1.1) | Return format of feature information (MIME type). Current supported values are text/xml and application/json (for a GeoJSON output). |
FEATURE_COUNT=number |
No | The maximum number of features about which to return information. |
X=pixel_column |
Yes for 1.1.1 | X-coordinate in pixels of feature (measured from the upper left corner which is 0).This parameter is only used for 1.1.1 versions of the OGC specification. |
Y=pixel_row |
Yes for 1.1.1 | Y-coordinate in pixels of feature (measured from the upper left corner which is 0).This parameter is only used for 1.1.1 versions of the OGC specification. |
I=pixel_column |
Yes for 1.3.0 | I-coordinate in pixels of feature (measured from the upper left corner which is 0).This parameter is only used for 1.3.0 versions of the OGC specification. |
J=pixel_row |
Yes for 1.3.0 | J-coordinate in pixels of feature (measured from the upper left corner which is 0).This parameter is only used for 1.3.0 versions of the OGC specification. |
PIXELSEARCHRADIUS |
No | The distance in pixels within which a GetFeatureInfo operation will search all features in the layer. This value overrides the DefaultPixelSearchRadius that may be set at the service and/or layer levels. If not present in the request, nor is specified for the service or layer levels, a pixel radius value of 3 is used. |
The request parameters are always sent as an HTTP query string. The following are sample GetFeatureInfo requests:
WMS version 1.1.1:
http://server:port/rest/Spatial/WMS/?VERSION=1.1.1&SERVICE=WMS&REQUEST=GetFeatureInfo
&SRS=EPSG:4326&BBOX=-100,0,90,100&WIDTH=400&HEIGHT=300&LAYERS=World&QUERY_LAYERS=World&X=1&Y=1
&PIXELSEARCHRADIUS=10
http://server:port/rest/Spatial/WMS/?VERSION=1.1.1&SERVICE=WMS&REQUEST=GetFeatureInfo
&SRS=EPSG:4326&BBOX=-100,0,90,100&WIDTH=400&HEIGHT=300&LAYERS=World
&INFO_FORMAT=application/json&QUERY_LAYERS=World&X=1&Y=1&PIXELSEARCHRADIUS=10WMS version 1.3:
http://server:port/rest/Spatial/WMS/?VERSION=1.3.0&SERVICE=WMS&REQUEST=GetFeatureInfo
&CRS=EPSG:4326&BBOX=-100,0,90,100&WIDTH=400&HEIGHT=300&LAYERS=World&INFO_FORMAT=text/xml
&QUERY_LAYERS=World&I=1&J=1&PIXELSEARCHRADIUS=10
http://server:port/rest/Spatial/WMS/?VERSION=1.3.0&SERVICE=WMS&REQUEST=GetFeatureInfo
&CRS=EPSG:4326&BBOX=-100,0,90,100&WIDTH=400&HEIGHT=300&LAYERS=World
&INFO_FORMAT=application/json&QUERY_LAYERS=World&I=1&J=1&PIXELSEARCHRADIUS=10Note: The code above should all be on a single line with no breaks. Due to space
limitations, we cannot display the request in such a way in this document.