RING

Used in

Servers

Image Query Feature Extract

Parent elements

Syntax

<RING > No Attributes (r)<COORDS... /> [Or] (r)(m)<POINT... /> [Or] (m)<HOLE... /> </RING >
(r): Attribute or child element is required. (m): Child element can be used multiple times.

Description

Provides the x,y coordinate locations of a polygon feature.

Restrictions

Either COORDS or POINT is required.

Notes

For the different options of representing geometry in an acetate layer, see OBJECT.

Examples for RING

Example 1: When in SPATIALFILTER in CONFIG or REQUEST.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
<REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
      <IMAGESIZE width="643" height="502" />
    </PROPERTIES>
    <LAYER type="featureclass" name="select layer" visible="true" id="selected">
      <DATASET fromlayer="countries" />
      <SPATIALQUERY>
        <SPATIALFILTER relation="area_intersection">
          <POLYGON>
            <RING>
              <POINT x="83.15605550814075" y="38.07185101549165" />
              <POINT x="111.09942196116728" y="-4.70645066589869" />
              <POINT x="155.1079549837513" y="-10.38915084069517" />
              <POINT x="139.1079549837513" y="66.38915084069517" />
              <POINT x="83.15605550814075" y="38.07185101549165" />
            </RING>
          </POLYGON>
        </SPATIALFILTER>
      </SPATIALQUERY>
      <SIMPLERENDERER>
        <SIMPLEPOLYGONSYMBOL fillcolor="0,0,0" filltype="cross" />
      </SIMPLERENDERER>
    </LAYER>
  </GET_IMAGE>
</REQUEST>
</ARCXML>

Example 2: When using RING in an acetate layer.

<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600" />
      </PROPERTIES>
      <LAYER type="acetate" name="acetate1" id="acetate1">
        <OBJECT units="database">
          <SIMPLEPOLYGONSYMBOL fillcolor="0,255,0" />
          <POLYGON>
            <RING>
              <POINT x="83.15605550814075" y="38.07185101549165" />
              <POINT x="111.09942196116728" y="-4.70645066589869" />
              <POINT x="155.1079549837513" y="-10.38915084069517" />
              <POINT x="139.1079549837513" y="66.38915084069517" />
              <POINT x="83.15605550814075" y="38.07185101549165" />
              <HOLE>
                <POINT x="100.15605550814075" y="20.07185101549165" />
                <POINT x="103.09942196116728" y="30.70645066589869" />
                <POINT x="106.1079549837513" y="30.38915084069517" />
                <POINT x="100.15605550814075" y="20.07185101549165" />
              </HOLE>
            </RING>
          </POLYGON>
        </OBJECT>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 3: When in a FEATURES response.

<?xml version="1.0" encoding="UTF8"?>
<ARCXML version="1.1">
<RESPONSE>
  <FEATURES>
    <FEATURE>
      <FIELDS CUST_ID="4" NAME="Customer  4"  #SHAPE#="[Geometry]" #ID#="3" />
      <POLYGON>
        <RING>
          <POINT x="-133.15605550814075" y="78.07185101549165" />
          <POINT x="-131.09942196116728" y="74.70645066589869" />
          <POINT x="-128.1079549837513" y="76.38915084069517" />
          <POINT x="-128.1079549837513" y="76.38915084069517" />
          <POINT x="-133.15605550814075" y="78.07185101549165" />
        </RING>
      </POLYGON>
    </FEATURE>
  <FEATURECOUNT count="1" hasmore="false" />
</FEATURES>
</RESPONSE>
</ARCXML>