FEATURES

Used in

Servers

Query Feature

Parent elements

Syntax

<FEATURES > No Attributes (r)<FEATURECOUNT... /> <ENVELOPE... /> (m)<FEATURE... /> </FEATURES >
(r): Attribute or child element is required. (m): Child element can be used multiple times.

Description

Returns attribute data, feature geometry data, or both. Data is returned in a binary stream from the Feature Server or in ArcXML format from the Query Server.

Notes

See GET_FEATURES for request.
If outputmode in the request is binary, the response is a binary stream. If outputmode is xml or newxml, the response is in ArcXML. Outputmode should be set to "xml" or "newxml" for Image Services.
In ArcXML mode, feature geometry is returned only if the #shape# field is included in the request. The geometry can be returned in a compact or noncompact format also based on the request.
ENVELOPE is used two ways in a FEATURES response:
- As the extent for each feature returned.
- As the extent of all the features returned in the response.
Two methods can be used to retrieve the number of selected features without returning FEATURE elements:
- To get the total number of seclected features but not a global envelope, you can use GET_FEATURES skipfeatures="true". In the FEATURES response, only FEATURECOUNT is returned. You can include a global envelope by setting both GET_FEATURES skipfeatures and globalenvelope to "true".
- To get the total number of selected features and a corresponding global envelope, you can use the following combination of attributes in GET_FEATURES:
  - attributes="false"
  - geometry="false"
  - envelope="false"
  - globalenvelope = "true"
  When attributes, geometry, and envelope are set to "false", only FEATURECOUNT is returned. If globalenvelope is set to "true", the global envelope is included using ENVELOPE. If globalenvelope is set to "false", no ENVELOPE is returned. If at least one attribute among attributes, geometry, and envelope is set to "true", FEATURE elements are returned.
For more details on using GET_FEATURES and FEATURES including additional examples, see Using GET_FEATURES and FEATURES.

Examples for FEATURES

Example 1: When envelope and globalenvelope are both requested.

<?xml version="1.0" encoding="UTF8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <FEATURES>
      <FEATURE>
        <ENVELOPE minx="-124.731422424316" miny="45.5432510375977" maxx="-116.918151855469" maxy="49.0000038146973"/>
      </FEATURE>
      <FEATURE>
        <ENVELOPE minx="-124.558395385742" miny="41.9877891540527" maxx="-116.469444274902" maxy="46.2362594604492"/>
      </FEATURE>
      <FEATURE>
        <ENVELOPE minx="-124.391471862793" miny="32.5357246398926" maxx="-114.124450683594" maxy="42.0023460388184"/>
      </FEATURE>
      <FEATURE>
        <ENVELOPE minx="-160.245178222656" miny="18.9247817993164" maxx="-154.793869018555" maxy="22.2324924468994"/>
      </FEATURE>
      <FEATURE>
        <ENVELOPE minx="-178.215026855469" miny="51.5844345092773" maxx="-129.990539550781" maxy="71.4066467285156"/>
      </FEATURE>
      <FEATURECOUNT count="5" hasmore="false" />
      <ENVELOPE minx="-178.215026855469" miny="18.9247817993164" maxx="-114.124450683594" maxy="71.4066467285156"/>
    </FEATURES>
  </RESPONSE>
</ARCXML>

Example 2: When attributes are included.

<?xml version="1.0" encoding="UTF8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <FEATURES>
      <FEATURE>
        <ENVELOPE minx="-99.127571105957" miny="19.4270458221436" maxx="-99.127571105957" maxy="19.4270458221436"/>
        <FIELDS NAME="Mexico City" POPULATION="14100000" #SHAPE#="[Geometry]" />
      </FEATURE>
      <FEATURE>
        <ENVELOPE minx="-74.0999984741211" miny="40.75" maxx="-74.0999984741211" maxy="40.75"/>
        <FIELDS NAME="New York" POPULATION="16472000" #SHAPE#="[Geometry]" />
      </FEATURE>
      <FEATURECOUNT count="2" hasmore="false" />
      <ENVELOPE minx="-99.127571105957" miny="19.4270458221436" maxx="-74.0999984741211" maxy="40.75"/>
    </FEATURES>
  </RESPONSE>
</ARCXML>

Example 3: When retrieving only the feature count and the global envelope. In the GET_FEATURES request, the attributes envelope, geometry, and attributes are set to "false". The attribute globalenvelope is set to "true".

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <FEATURES>
      <FEATURECOUNT count="32" hasmore="false" />
      <ENVELOPE minx="-97.1244430541992" miny="48.1409759521484" maxx="150.780014038086" maxy="68.9635467529297"/>
    </FEATURES>
  </RESPONSE>
</ARCXML>