GET_IMAGE

Used in

Servers

Image ArcMap

Parent elements

Syntax

<GET_IMAGE	Attribute Description Table
When using ArcMap Server: autoresize="true \| false" [false] dataframe="string" returnscale="true \| false" [false] show="strict" When using Image Server: autoresize="true \| false" [false] returnscale="true \| false" [false] show="layers \| strict \| layers strict" useservicedatum="true \| false" [false] > (r)<PROPERTIES... /> <ENVIRONMENT... /> (m)<LAYER... /> <WORKSPACES... /> [Image Server only] </GET_IMAGE >
(r): Attribute or child element is required. (m): Child element can be used multiple times.

Description

Sends a request to generate a map image.

Restrictions

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

Notes

See IMAGE for response.
In order to add new map layers dynamically in a GET_IMAGE request, MAP must be set to dynamic in a map configuration file.
<MAP dynamic="true" />
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
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.
returnscale	When set to "true", SCALE, which includes the relative scale, is returned in the response.
autoresize	The maximum generated image size is based on the image memory limit set when an ArcIMS 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	The attribute show has two values: "layers" and "strict". One or both values are valid in a request. Use a space as a delimiter if both values are used: "layers strict" or "strict layers". When "layers" is used, the layer ID, name, and number of features in the map are returned in the response. This value is valid only with Image Services and is ignored by ArcMap Image Services. When "strict" is used, the list of all layers included in LAYERSLIST must be valid. If a layer ID is invalid, an error message is returned. Acetate and dynamic layers included in the list must also have a valid ID. When "layers strict" or "strict layers" is used, "strict" takes precendence and is checked first before "layers".
useservicedatum	Many users include a datum transformation when using FEATURECOORDSYS and FILTERCOORDSYS in a map configuration file. When useservicedatum is "true", the datum transformation of the service is used if FEATURECOORDSYS and FILTERCOORDSYS in the request are the same as in the map configuration file, even if datumtransformid or datumtransformstring is not included in the request. This behavior is important for users of the WMS Connector, since the specifications for this connector does not provide a way to include datum transformations in requests. If FEATURECOORDSYS and FILTERCOORDSYS in the request are different than in the map configuration file, and no datum transformation information is included in the request, no datum transformation is made. This attribute is needed only with Image Services, since ArcMap Image Services handle the datum transformation internally.

Examples for GET_IMAGE

<?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.

<?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.

<?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>