GET_IMAGE

GET_IMAGE

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:

Sends a request to the Image Server to generate a map image.

Restrictions:

Valid workspace types include SHAPEWORKSPACE, IMAGEWORKSPACE, and SDEWORKSPACE and are valid with the Image Server only.

Notes:

See IMAGE for response.
For more details on using GET_IMAGE and IMAGE, including additional examples, see Using GET_IMAGE and IMAGE with Image Services or Using GET_IMAGE and IMAGE with ArcMap Image Services.

Attribute Descriptions for GET_IMAGE:

Attribute	Usage	Back to Top
dataframe	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	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	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 width="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 > 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="pixel">
          <TEXT 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" /> 
          <LAYERDEF id="1" visible="false" /> 
          <LAYERDEF id="0" visible="false" /> 
        </LAYERLIST>
      </PROPERTIES>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>