GET_IMAGE  Examples

Used in:  REQUEST  
Servers:  Image   ArcMap  
Parent elements:  REQUEST  

<GET_IMAGE Attribute Description Table


     When using ArcMap Server:
     autoresize ="true | false"  [false]
     dataframe ="string"

     When using Image Server:
     autoresize ="true | false"  [false]
     show ="layers"
>

     <PROPERTIES... />
     <ENVIRONMENT... />
     (m) <LAYER... />
     <WORKSPACES... />  [Image Server only]

</GET_IMAGE >
Bold: Attribute or child element is required.
(m):  Child element can be used multiple times.


Description:


Restrictions:


Notes:


Attribute Descriptions for GET_IMAGE:

Attribute Usage Back to Top
dataframe 1 Valid with ArcMap Server only. Dataframe image to use when requesting map. By default, the selected image is the default data frame in the ArcMap document. However, alternate data frames can be accessed using this attribute.
autoresize 2 The maximum generated image size is based on the image memory limit set when an Image service is started. For example, an image memory limit of 1 MB allows a map no larger than 262,144 pixels (512 x 512) to be generated. If autoresize is set to "true", a requested map greater than the maximum pixel count will be reduced in size to within the maximum pixel count. If autoresize is set to "false", no image is generated and an error message is returned by the ArcIMS Spatial Server.
show 3 Use this attribute to return layer information in the response including layer ID, name, and number of features in the map.
 

Examples for GET_IMAGE:

Example 1: Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <LAYERLIST>
        <LAYERDEF id="1">
          <SIMPLERENDERER>
            <SIMPLEMARKERSYMBOL size="16" color="0,0,0" />
          </SIMPLERENDERER>
         <SPATIALQUERY>
            <SPATIALFILTER relation="area_intersection">      
            <ENVELOPE maxy="60" maxx="60" miny="0" minx="0" />
         </SPATIALFILTER>
         </SPATIALQUERY>
      </LAYERDEF>
      </LAYERLIST>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
   </PROPERTIES>
  </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 2: Example using projections, queries, selected features, and acetate layers. The IMAGE response includes layer information since the attribute "show" is used. Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE show="layers">
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <IMAGESIZE width="800" height="600" />
        <FEATURECOORDSYS id="54030"  />
        <FILTERCOORDSYS id="4326" />
        <LAYERLIST>
          <LAYERDEF id="0" visible="true" />
          <LAYERDEF id="1" visible="true" />
          <LAYERDEF id="2" visible="false" />
          <LAYERDEF id="3" visible="false" />
          <LAYERDEF id="4" visible="true" >
            <SPATIALQUERY where="POPULATION &gt; 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=&apos;Brazil&apos;" />  
          <SIMPLERENDERER>
            <SIMPLEPOLYGONSYMBOL filltype="solid" fillcolor="255,0,0" />
          </SIMPLERENDERER>
      </LAYER>

      <LAYER type="acetate" name="WorldText" id="444" >
        <OBJECT units="pixel">
          <TEXT size="32" coords="100 44" 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="3333">
        <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 3: When using the attribute dataframe with GET_IMAGE. Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE dataframe="States">
      <PROPERTIES>
        <ENVELOPE minx="-94" miny="32" maxx="-73" maxy="46" />
        <IMAGESIZE width="500" height="400" />
        <LAYERLIST>
          <LAYERDEF id="2" visible="true" /> <!--States-->
          <LAYERDEF id="1" visible="false" /> <!--Roads-->
          <LAYERDEF id="0" visible="false" /> <!--Cities-->
        </LAYERLIST>
      </PROPERTIES>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>