GET_FEATURES | Examples |
<GET_FEATURES | Attribute
Description Table |
attributes ="true | false" [true]
beginrecord ="integer" [0] checkesc ="true | false" [false] compact ="true | false" [false] dataframe ="string" envelope ="true | false" [false] featurelimit ="integer" [all features] geometry ="true | false" [true] globalenvelope ="true | false" [false] outputmode ="binary | xml | newxml" [binary] skipfeatures ="true | false" [false] > <LAYER... /> <QUERY... /> [Or] <SPATIALQUERY... /> [Or] <ENVIRONMENT... /> </GET_FEATURES > | |
Bold: Attribute or child element is
required. |
Attribute | Usage | Back to Top |
---|---|---|
attributes | Determines whether attribute data for selected features is returned in the response. | |
beginrecord | Index of first extracted record. | |
checkesc | Used to determine if the returned data
should include escaped characters for ampersand, single quote, double
quote, less than, and greater than. For example, if the value for
SUB_REGION is "P&NW", then:
| |
compact | For ArcXML response, switches geometry to compact form. See Using GET_FEATURES and FEATURES for more details. | |
dataframe | Valid with ArcMap Server only. Dataframe to use when requesting feature attributes. The active data frame in the ArcMap document is accessed by default. However, alternate data frames can be accessed using this attribute. | |
envelope | Used to request the bounding envelope of each returned feature. | |
featurelimit | Maximum number of returned features. | |
geometry | Requests feature coordinates. | |
globalenvelope | When set to true, the overall envelope for all the features returned is included in the response. Since the number of features returned depends on beginrecord and featurelimit, only the actual records extracted based on featurelimit are included in the overall envelope. Note that in order for the global envelope to be returned, subfields in the SPATIALQUERY must include either #SHAPE# or #ALL#. | |
outputmode | If outputmode is binary, data is compressed into a binary stream. This is valid only for Feature Services. If the value of "xml" is used, data is returned in ArcXML format. This format uses a shorthand format that is faster to parse in an HTML client. If "newxml" is used, the data is returned in a longer format. See Using GET_FEATURES and FEATURES for more details. | |
skipfeatures | When set to "true", only the number of features is returned without including any information on individual features. The number of features returned depends on beginrecord and featurelimit. To get the total number of features in a layer, a query can be specified with an empty where clause. Note that even when skipfeatures is set to "true", the query is executed and features are actually extracted before they are counted. This attribute is valid only when outputmode is "xml" or "newxml". |
Example 1: | Back to Top |
<?xml version="1.0"
encoding="UTF-8"?> <ARCXML version="1.1"> <REQUEST> <GET_FEATURES featurelimit="25" beginrecord="0" outputmode="xml" geometry="false" envelope="true" compact="true"> <LAYER id="4" /> <SPATIALQUERY subfields="#ALL#" where="NAME = 'Los Angeles'" > </SPATIALQUERY> </GET_FEATURES> </REQUEST> </ARCXML> |
Example 2: When using projection elements. | Back to Top |
<?xml version="1.0"
encoding="UTF-8" ?> <ARCXML version="1.1"> <REQUEST> <GET_FEATURES featurelimit="25" beginrecord="0" outputmode="xml" geometry="true" envelope="true" compact="true"> <LAYER id="4" /> <SPATIALQUERY subfields="#ALL#" where="POPULATION > 10000000" > <FILTERCOORDSYS id="53030" /> <FEATURECOORDSYS id="53030" /> <SPATIALFILTER relation="area_intersection"> <ENVELOPE minx="-11395772" miny="930558" maxx="-3878142" maxy="6419621"/> </SPATIALFILTER> </SPATIALQUERY> </GET_FEATURES> </REQUEST> </ARCXML> |