ENVELOPE  Examples

Used in:  CONFIG   REQUEST   RESPONSE   MARKUP
Servers:  Image   Query   Feature   Extract   Metadata   ArcMap  
Parent elements:  DATAFRAME   EXTRACT   FCLASS   FEATURE   FEATURES   IMAGE   LAYERINFO   LAYOUT   LAYOUTINFO   METADATA_DATASET   PARTITION   PROPERTIES   PUT_METADATA   SEARCH_METADATA   SPATIALFILTER  

<ENVELOPE Attribute Description Table


     When parent element is ALL except PROPERTIES and SEARCH_METADATA:
     maxx ="double"
     maxy ="double"
     minx ="double"
     miny ="double"

     When parent element is PROPERTIES:
     maxx ="double"
     maxy ="double"
     minx ="double"
     miny ="double"
     name ="Initial_Extent | Extent_Limit"  [Initial_Extent]
     reaspect ="true | false"  [true]

     When parent element is SEARCH_METADATA:
     maxx ="double"
     maxy ="double"
     minx ="double"
     miny ="double"
     spatialoperator ="within | overlaps | overlaps2 | fuzzywithin | fuzzyequals"  [fuzzywithin]
>

     No Child Elements
</ENVELOPE >
Bold: Attribute or child element is required.


Description:


Restrictions:


Notes:


Attribute Descriptions for ENVELOPE:


When parent element is ALL except PROPERTIES and SEARCH_METADATA:
Attribute Usage Back to Top
maxx Right top x-coordinate. Units are in map units for all elements except LAYOUT and LAYOUTINFO, which are in page units.
maxy Right top y-coordinate. Units are in map units for all elements except LAYOUT and LAYOUTINFO, which are in page units.
minx Left bottom x-coordinate. Units are in map units for all elements except LAYOUT and LAYOUTINFO, which are in page units.
miny Left bottom y-coordinate. Units are in map units for all elements except LAYOUT and LAYOUTINFO, which are in page units.

When parent element is PROPERTIES:
Attribute Usage Back to Top
maxx Right top x-coordinate in map units.
maxy Right top y-coordinate in map units.
minx Left bottom x-coordinate in map units.
miny Left bottom y-coordinate in map units.
name Identifies the type of envelope extent in a viewer or map configuration file. "Initial_Extent" is the full extent drawn when a file is first accessed. "Extent_Limit" is the maximum extent allowable when zooming out. The extent limit must be handled by the client. When processing a request, the Spatial Server ignores an ENVELOPE that includes "Extent_Limit".

When an extent limit is used in a viewer configuration file, usually default.axl, two ENVELOPE elements may be present. The two ENVELOPE extents do not need to be the same.
<PROPERTIES>
<ENVELOPE minx="-166" miny="3" maxx="-26" maxy="80" name="Extent_Limit"/>
<ENVELOPE minx="-128.1" miny="18.7" maxx="-53.7" maxy="51.3" name="Initial_Extent"/>
<PROPERTIES>

When an extent limit is included in a viewer configuration file (such as default.axl) and an ArcIMS Java Viewer is used, the area outside of the extent limit is not displayed.

When an extent limit is used in a map configuration file, the ENVELOPE with "Extent_Limit" is included in the SERVICEINFO response. The extent limit is listed for informational purposes only since the Spatial Server ignores this information during a request. Instead, the clients must account for the extent limit. The ArcIMS HTML Viewer does use an extent limit, but the viewer calculates this limit, not the Spatial Server. A service displayed in ArcExplorer 4 has no extent limit, and a user can zoom out at will.

More information on using "Extent_Limit" can be found in Using Map and Viewer Configuration Files.
reaspect Flag indicating whether the ENVELOPE should be stretched to fit the viewing area in the client. By default, the pixel width and height ratio stays the same. By setting reaspect to false, the pixel width and height are stretched. Valid only with Image Services.

When parent element is SEARCH_METADATA:
Attribute Usage Back to Top
maxx Right top x-coordinate in map units.
maxy Right top y-coordinate in map units.
minx Left bottom x-coordinate in map units.
miny Left bottom y-coordinate in map units.
spatialoperator The restrictions on the envelope.
  • within - finds metadata documents where the document's envelope falls entirely within the specified search box. The document's spatial envelope can touch the search box boundary.
  • overlaps - finds metadata documents in which part or all of the metadata document's envelope falls within the specified search box. Anything the search box touches is found.
  • overlaps2 - same as "overlaps", except that the metadata document's envelope cannot completely contain the search box.
  • fuzzywithin - finds metadata documents in which the document's spatial extent is roughly within the specified search box. The specified search box is expanded by ten percent and returns metadata documents that fall within the expanded outer border and intersect the original search box. Edge touching is allowed.
  • fuzzyequals - finds metadata documents in which the document's spatial extent is roughly equal to the specified search box. The specified search box is expanded ten percent inside and outside. Returns documents that are completely contained by the outer expanded search area and completely contain the inner expanded search area.
 

Examples for ENVELOPE:

Example 1: Used in CONFIG to set the initial extent. Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <CONFIG>
    <ENVIRONMENT>
      <LOCALE country="US" language="en" variant="" />
      <UIFONT color="0,0,0" name="Arial" size="12" style="regular" />
      <SCREEN dpi="96" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
       <ENVELOPE minx="-178.2" miny="18.9" maxx="-66.9" maxy="71.4" name="Initial_Extent" />
       <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
       <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="STATES" visible="true" id="0">
       <DATASET name="STATES" type="polygon" workspace="shp_ws-0" />
       <SIMPLERENDERER>
         <SIMPLEPOLYGONSYMBOL fillcolor="255,255,153" filltype="solid" />
       </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When in a GET_IMAGE REQUEST to set the selection area for the spatial filter (first ENVELOPE) and the overall extent of the map (second ENVELOPE). Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
  <GET_IMAGE>
    <PROPERTIES>
      <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" />
      <LAYERLIST>
        <LAYERDEF id="Cities">
          <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>
   </PROPERTIES>
  </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 3: Identifies the initial extent and the extent of a layer in a SERVICEINFO response. Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <RESPONSE>
    <SERVICEINFO>
      <ENVIRONMENT>
        <LOCALE language="en" country="US" />
        <UIFONT name="Arial" color="0,0,0" size="12" style="regular" />
        <SEPARATORS cs=" " ts=";"/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <ENVELOPE minx="-180" miny="-90" maxx="180" maxy="90" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Cities" id="0">
        <FCLASS type="point">
          <ENVELOPE minx="-165.270004272461" miny="-53.1500015258789" maxx="177.130187988281" maxy="78.1999969482422" />
        </FCLASS>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>

Example 4: When using in GET_LAYOUT. Note the ENVELOPE in the PROPERTIES section is in page units. Back to Top
<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_LAYOUT>
      <PROPERTIES>
        <ENVELOPE minx="0" miny="0" maxx="8.5" maxy="11" />
        <FILTERCOORDSYS id="54030" />
        <FEATURECOORDSYS id="54030" />
        <IMAGESIZE width="800" height="600" />
        <OUTPUT type="jpg" />
      </PROPERTIES>
      <DATAFRAME id="Layers" >
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326" />
        <ENVELOPE minx="-121" miny="36" maxx="-112" maxy="44" />
      </DATAFRAME>
    </GET_LAYOUT>
  </REQUEST>
</ARCXML>

Example 5: When limiting a metadata search to the region defined within the ENVELOPE. Back to Top
<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_METADATA>
      <SEARCH_METADATA operator="and">
        <ENVELOPE minx="-176.98" miny="18.93" maxx="-66.97" maxy="71.35" spatialoperator="within" />
        <TAGVALUE tag="metadata/dataqual/lineage/srcinfo/srccite/citeinfo/pubdate" greaterthan="1990" />
        <FULLTEXT word="cities"/>
        <SEARCH_METADATA operator="or">
          <TAGTEXT tag="metadata/idinfo/citation/citeinfo/geoform" word="data"/>
          <TAGTEXT tag="metadata/idinfo/citation/citeinfo/geoform" word="digital"/>
        </SEARCH_METADATA>
      </SEARCH_METADATA>
    </GET_METADATA>
  </REQUEST>
</ARCXML>