BUFFER  Examples

Used in:  REQUEST  
Servers:  Image   Query   Feature   ArcMap  
Parent elements:  SPATIALFILTER   SPATIALQUERY  

<BUFFER Attribute Description Table

     distance ="double"
     bufferunits ="decimal_degrees | miles | feet | kilometers | meters"  [MAPUNITS defined in PROPERTIES]
     project ="true | false"  [true]
>


     When parent element is SPATIALFILTER:
          No Child Elements

     When parent element is SPATIALQUERY:
     <SPATIALQUERY... />
     <TARGETLAYER... />

</BUFFER >
Bold: Attribute or child element is required.


Description:


Restrictions:


Notes:


Attribute Descriptions for BUFFER:

Attribute Usage Back to Top
bufferunits 1 Specifies units that apply to buffer.
distance 2 Buffer area width in buffer units.
project 3 Generated buffers are projected if FEATURECOORDSYS is in the map configuration file or a request. If project is set to false, the buffer is not projected.
 

Examples for BUFFER:

Example 1: When in a GET_FEATURES request. 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="2" /> <!-- states -->
      <SPATIALQUERY subfields="#SHAPE# NAME">
        <BUFFER distance="1" >
          <TARGETLAYER id="4" /> <!-- cities -->
          <SPATIALQUERY subfields="NAME" />
        </BUFFER>
        <SPATIALFILTER relation="area_intersection" >
          <ENVELOPE minx="-16154208.3772906" miny="-4165319.9729724" maxx="-4904885.23874079" maxy="4271672.38093997" />
        </SPATIALFILTER>
      </SPATIALQUERY>
    </GET_FEATURES>
  </REQUEST>
</ARCXML>

Example 2: When in a GET_IMAGE request. Shows selected features and buffer. Note in this example that the DATASET fromlayer is "CITIES". This refers to the LAYER id in the map configuration file, not the LAYER name. Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="867805.08306143" miny="6771243.45626185" maxx="1576642.8482793" maxy="7302871.78017525"/>
      </PROPERTIES>
      <LAYER type="featureclass" name="theBufferTarget" visible="true" id="buffertarget">
        <DATASET fromlayer="CITIES"/>
        <SPATIALQUERY>
          <BUFFER distance="100" bufferunits="miles">
            <TARGETLAYER id="CITIES"/>
          </BUFFER>
          <SPATIALFILTER relation="area_intersection">
            <ENVELOPE minx="867805.08306143" miny="6771243.45626185" maxx="1576642.8482793" maxy="7302871.78017525"/>
          </SPATIALFILTER>
        </SPATIALQUERY>
        <SIMPLERENDERER>
          <SIMPLEMARKERSYMBOL color="255,0,0" />
        </SIMPLERENDERER>
      </LAYER>
      <LAYER type="featureclass" name="theBuffer" visible="true" id="buffer">
        <DATASET fromlayer="CITIES"/>
        <SPATIALQUERY>
          <BUFFER distance="100" bufferunits="miles" />
          <SPATIALFILTER relation="area_intersection">
            <ENVELOPE minx="867805.08306143" miny="6771243.45626185" maxx="1576642.8482793" maxy="7302871.78017525"/>
          </SPATIALFILTER>
        </SPATIALQUERY>
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL fillcolor="100,100,100" filltype="solid" filltransparency="0.5" />
        </SIMPLERENDERER>
      </LAYER>        
    </GET_IMAGE>
  </REQUEST>
</ARCXML>