MAPUNITS

Used in

Servers

Image Query Feature Extract

Parent elements

Syntax

<MAPUNITS	Attribute Description Table
(r)units="decimal_degrees \| feet \| meters" > No Child Elements </MAPUNITS >
(r): 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. However, if you expect your users to consume a service in ArcMap, MAPUNITS should be included. Otherwise, ArcMap will not calculate scale dependencies correctly.
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
units	Map units of the data: decimal_degrees, feet, or meters.

Examples for MAPUNITS

Example 1: When in CONFIG.

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

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