MAPUNITS

MAPUNITS

Used in: CONFIG   RESPONSE
Servers: Image   Query   Feature   Extract   ArcMap
Parent elements: PROPERTIES

<MAPUNITS	Attribute Description Table
units ="decimal_degrees \| feet \| meters" > No Child Elements </MAPUNITS >
Bold: Attribute or child element is required.

Description:

Defines data map units.

Restrictions:

None

Notes:

In a map configuration file, MAPUNITS is optional. If it is not included, the assumption is that MAPUNITS is in decimal degrees, and no MAPUNITS information is returned in SERVICEINFO.
If MAPUNITS is incorrect in a map configuration file, measurements and scale dependencies may not work correctly.
If FEATURECOORDSYS is included in the map configuration file, MAPUNITS, if present, is ignored. Instead, the MAPUNITS for the coordinate system is automatically calculated. In SERVICEINFO, the correct MAPUNITS for the coordinate system is returned.
In a request, MAPUNITS does not need to be included. The request uses the MAPUNITS in the map configuration file or the MAPUNITS from FEATURECOORDSYS.

Attribute Descriptions for MAPUNITS:

Attribute	Usage	Back to Top
units	1 Map units of the data: decimal_degrees, feet, or meters.

Examples for MAPUNITS:

Example 1: When in CONFIG.

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.21" miny="18.92" maxx="-66.96" maxy="71.41" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to USA ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="CITIES" visible="true" id="2">
      <DATASET name="CITIES" type="point" workspace="shp_ws-0" />
      <SIMPLERENDERER>
        <SIMPLEMARKERSYMBOL type="square" width="5" />
      </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: When 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="-71.0718204242754" miny="42.368904975182" maxx="-71.0475995680561" maxy="42.3869647980717" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
      </PROPERTIES>
      <LAYERINFO type="featureclass" visible="true" name="Streets" id="1" >
        <FCLASS type="line"></FCLASS>
        <EXTENSION type="Geocode" >
          <GCSTYLE name="USAddressZ" />
        </EXTENSION>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>