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:

When FEATURECOORDSYS is invalid in a map configuration file, MAPUNITS type has no value in a SERVICEINFO response. To fix this problem, check that the FEATURECOORDSYS value is correct.

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	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" />
        <FILTERCOORDSYS id="4326" />
        <FEATURECOORDSYS id="4326"/>
      </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=";"/>
        <CAPABILITIES forbidden="" disabledtypes=""/>
        <SCREEN dpi="96"/>
        <IMAGELIMIT pixelcount="1048576" />
      </ENVIRONMENT>
      <PROPERTIES>
        <FEATURECOORDSYS id="4326"/>
        <FILTERCOORDSYS id="4326"/>
        <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" maxscale="0.0000470313026173583">
        <FCLASS type="line"></FCLASS>
        <EXTENSION type="Geocode" >
          <GCSTYLE name="USAddressZ" />
        </EXTENSION>
      </LAYERINFO>
    </SERVICEINFO>
  </RESPONSE>
</ARCXML>