LAYERLIST

LAYERLIST

Used in: REQUEST
Parent elements: PROPERTIES

<LAYERLIST	Attribute Description Table
When parent element is GET_EXTRACT: nodefault ="true \| false" [false] When parent element is GET_IMAGE: dynamicfirst ="true \| false" [false] nodefault ="true \| false" [false] order ="true \| false" [false] > (m) <LAYERDEF... /> </LAYERLIST >
(m): Child element can be used multiple times.

Description:

GET_IMAGE

GET_EXTRACT

Restrictions:

Used only in GET_IMAGE and GET_EXTRACT requests.

Notes:

By default in a GET_IMAGE request, the layers are drawn in the following order:
1. Layers in the MapService in the order they are defined in the MapService including acetate layers.
2. Dynamic layers added in the request in the order they are defined in the request.
The layer order can be changed by using the order attribute. When order is set to true, layers are drawn in the order they are listed in the LAYERLIST. This means that dynamic layers can be intermingled among the layers from the MapService. Both MapService layers and dynamic layers must be identified using LAYERDEF. The LAYER id must be unique among all MapService layers and dynamic layers.
The attribute dynamicfirst is ignored if nodefault and/or order is set to true.
For more information about using LAYERDEF in a request, including more examples, see Using GET_IMAGE and IMAGE and Using GET_EXTRACT and EXTRACT.

Attribute Descriptions for LAYERLIST:

When parent element is GET_EXTRACT:

Attribute	Usage	Back to Top
nodefault	When set to true, only the layers listed in the LAYERLIST are extracted. Only MapService and dynamic layers of type featureclass are extracted. Acetate and image layers included in the LAYERLIST are not extracted. If visible is set to false in LAYERDEF, then the layer is not included.

When parent element is GET_IMAGE:

Attribute	Usage	Back to Top
dynamicfirst	When set to true, draws all dynamic layers before any layers defined in the MapService.
nodefault	When set to true, only MapService and dynamic layers in the LAYERLIST are displayed on the map. MapService layers are displayed first followed by dynamic layers in the order they appear in the map configuration file and request, respectively. When nodefault is false, all dynamic and MapService layers are included. In both cases, if visible is set to false in LAYERDEF, then the layer does not display.
order	When set to true, draws layers in the order listed in the LAYERDEF elements. Only layers in the LAYERLIST are drawn. Can include MapService layers, dynamic layers, and acetate layers in any order. All layers, including acetate layers, must have a unique ID.

Examples for LAYERLIST:

Example 1: When specifying the order that layers should be drawn in a GET_IMAGE request.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE show="">
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600"/>
        <LAYERLIST dynamicfirst="false" nodefault="false" order="true">
          <LAYERDEF id="0" visible="true" />
          <LAYERDEF id="333" visible="true" />
          <LAYERDEF id="2" visible="true" />
          <LAYERDEF id="3" visible="true" />
          <LAYERDEF id="1" visible="true" >
            <SIMPLERENDERER>
              <SIMPLEPOLYGONSYMBOL filltransparency="0.5" filltype="solid" fillcolor="255,255,153" />
              </SIMPLERENDERER>
          </LAYERDEF>
          <LAYERDEF id="4" visible="true" >
            <SPATIALQUERY where="POPULATION > 2000000" >
              <SPATIALFILTER relation="area_intersection">
                <ENVELOPE minx="-14.0" miny="35.0" maxx="33.0" maxy="64.0" />
              </SPATIALFILTER>
            </SPATIALQUERY>
            <SIMPLERENDERER>
              <SIMPLEMARKERSYMBOL type="star" color="0,155,0" width="12.0" />
            </SIMPLERENDERER>
          </LAYERDEF>
        </LAYERLIST>
      </PROPERTIES>

      <LAYER type="featureclass" name="new_CNTRY94" id="333" >
        <DATASET fromlayer="1" />
        <SPATIALQUERY where="NAME='Brazil'" />
        <SIMPLERENDERER>
          <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,0,0" />
        </SIMPLERENDERER>
      </LAYER>

      <LAYER type="acetate" name="WorldText" id="444">
        <OBJECT units="database">
          <TEXT size="32" coords="0 0" label="The World">
            <TEXTMARKERSYMBOL fontstyle="bold" fontsize="32" font="Arial" fontcolor="0,0,0" glowing="255,255,0" />
          </TEXT>
        </OBJECT>
      </LAYER>

      <LAYER type="acetate" name="WorldBox" id="555" >
        <OBJECT units="pixel">
          <LINE coords="10 40;400 40;400 80;10 80;10 40">
            <SIMPLELINESYMBOL color="0,0,0" />
          </LINE>
        </OBJECT>
      </LAYER>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 2: When in a GET_EXTRACT request.

Back to Top

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_EXTRACT>
      <ENVIRONMENT>
        <SEPARATORS cs="#" ts="*" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-130" miny="30" maxx="-90" maxy="60" />
        <LAYERLIST>
          <LAYERDEF id="Ocean" visible="true" />
          <LAYERDEF id="Countries" visible="true" />
          <LAYERDEF id="States" visible="true" />
          <LAYERDEF id="Provinces" visible="false" />
          <LAYERDEF id="Cities" visible="true" >
            <SPATIALQUERY>
              <SPATIALFILTER relation="area_intersection">
                <POLYGON>
                  <RING>
                    <COORDS> -125#39*-125#63*-90#63*-90#39*-125#39 </COORDS>
                  </RING>
                </POLYGON>
              </SPATIALFILTER>
            </SPATIALQUERY>
          </LAYERDEF>
        </LAYERLIST>
      </PROPERTIES>
    </GET_EXTRACT>
  </REQUEST>
</ARCXML>