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" show ="strict" When using Image Server: autoresize ="true \| false" [false] show ="layers \| strict \| layers strict" > <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 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.
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 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 ArcI
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".

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>

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