FEATURECOORDSYS

Used in

Servers

Image Query Feature Extract Geocode ArcMap

Parent elements

DATAFRAME GET_GEOCODE PROPERTIES QUERY SPATIALQUERY

Syntax

<FEATURECOORDSYS	Attribute Description Table
When using ArcMap Server: *(r)id="integer"* *(r)string="string"* When using Image, Extract, Query, or Feature Server: *(r)id="integer"* *(r)string="string"* datumtransformid="integer" datumtransformstring="string" > No Child Elements </FEATURECOORDSYS >
(r): Attribute or child element is required.

Description

Projection coordinate system to which layers in an ArcIMS service are projected.

Restrictions

In a request or in a map configuration file, either id or string must be present, but not both.
In a SERVICINFO response, both id and string may be present in the response.
- For ArcMap Image Services, both id and string are returned unless the projection string has been modified. In this case, only string is returned.
- For Image and Feature Services, if id is present, then only id is returned in the response. If string is present, both string and id are returned unless the projection string has been modified. In this case, only string is returned.
For datum transformations either datumtransformid or datumtransformstring is used, but not both.
In ArcMap Image Services, datumtransformid or datumtransformstring are not valid.

Notes

For a complete list of supported IDs and definition strings, see:
- Projected Coordinate Systems Listing [Sorted by projection ID] [Sorted by name]
- Geographic Coordinate Systems Listing [Sorted by projection ID] [Sorted by name]
- Datum Transformation Listing [Sorted by projection ID] [Sorted by name]
It is highly recommended to include FEATURECOORDSYS and FILTERCOORDSYS in the PROPERTIES of a map configuration file.
FEATURECOORDSYS and FILTERCOORDSYS must contain the same value for id or string in a map configuration file.
When using definition strings, the quotes in the string must be changed to " so the ArcIMS Spatial Server can interpret the string correctly. For example, the definition string for World Mollweide is:

PROJCS["World_Mollweide",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137,298.257223563]],PRIMEM["Greenwich",0],UNIT["Degree",0.017453292519943295]],PROJECTION["Mollweide"],PARAMETER["False_Easting",0],PARAMETER["False_Northing",0],PARAMETER["Central_Meridian",0],UNIT["Meter",1]]

Once the quotes have been changed, the string looks like this:

PROJCS["World_Mollweide",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137,298.257223563]],PRIMEM["Greenwich",0],UNIT["Degree",0.017453292519943295]],PROJECTION["Mollweide"],PARAMETER["False_Easting",0],PARAMETER["False_Northing",0],PARAMETER["Central_Meridian",0],UNIT["Meter",1]]
The attributes datumtransformid and datumtransformstring are used when datum transformation information needs to be included. Only datum transformations to and from WGS 1984 are supported.
- When these attributes are used with COORDSYS and FILTERCOORDSYS, the datum transformation is from a non-WGS 1984 datum to WGS 1984. For example, Pulkovo_1942_To_WGS_1984 (datumtransformid="8157") transforms data from Pulkovo 1942 to WGS 1984.
- When these attributes are used with FEATURECOORDSYS, the datum transformation is from WGS 1984 to a non-WGS 1984 datum. In the above example, the datum transformation is from WGS 1984 to Pulkovo 1942.
When in PROPERTIES, FEATURECOORDSYS defines the default coordinate system for all layers. Using FEATURECOORDSYS in SPATIALQUERY overrides the information in PROPERTIES.
If a layer does not project, double check that a *.prj file or ArcSDE spatial reference table exists for the layer. If not, COORDSYS must be included with the layer.
For more information on the projection elements, see Using Projection Elements.

Attribute Descriptions for FEATURECOORDSYS

Attribute	Usage
datumtransformid	Datum transformation ID. Use either datumtransformid or datumstransformstring, but not both.
datumtransformstring	Datum transformation definition string. Use either datumtransformid or datumstransformstring, but not both.
id	Projected or geographic coordinate system ID. Use either id or string, but not both.
string	Projected or geographic coordinate system definition string. Use either id or string, but not both.

Examples for FEATURECOORDSYS

Example 1: Using a coordinate system ID in a map configuration file.

<?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" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <MAPUNITS units="meters" />
        <FEATURECOORDSYS id="4326" />
        <FILTERCOORDSYS id="4326"  />
      </PROPERTIES>
      <WORKSPACES>
      <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="Cntry94" visible="true" id="0">
        <DATASET name="Cntry94" type="polygon" workspace="shp_ws-0" />
        <COORDSYS id="4326" />
        <SIMPLERENDERER>
           <SIMPLEPOLYGONSYMBOL filltransparency="1.0" fillcolor="27,127,127" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 2: Using a coordinate system definition string.

<?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="-15066114" miny="-9182334" maxx="15311928" maxy="8551044" />
        <MAPUNITS units="meters" />
        <FEATURECOORDSYS string="PROJCS["World_Mollweide",GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137,298.257223563]],PRIMEM["Greenwich",0],UNIT["Degree",0.017453292519943295]],PROJECTION["Mollweide"],PARAMETER["False_Easting",0],PARAMETER["False_Northing",0],PARAMETER["Central_Meridian",0],UNIT["Meter",1]]" />
        <FILTERCOORDSYS id="54008"/>
      </PROPERTIES>
      <WORKSPACES>
      <SHAPEWORKSPACE name="shp_ws-0" directory="<path to WORLD ESRIDATA>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="Cntry94" visible="true" id="0">
        <DATASET name="Cntry94" type="polygon" workspace="shp_ws-0" />
        <COORDSYS id="4326" />
        <SIMPLERENDERER>
           <SIMPLEPOLYGONSYMBOL filltransparency="1.0" fillcolor="27,127,127" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: Using a datum transformation from WGS 1984 to Pulkovo 1942 (datumtransformid="8206").

<?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="25.2483" miny="45.6663" maxx="25.49986079043528" maxy="45.833288705864874" name="Initial_Extent" />
        <MAPUNITS units="decimal_degrees" />
        <FEATURECOORDSYS id="4284" datumtransformid="8206" />
        <FILTERCOORDSYS id="4326" />
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-2" directory="<path to data>" />
      </WORKSPACES>
      <LAYER type="featureclass" name="w84shp" visible="true" id="0">
        <DATASET name="w84shp" type="point" workspace="shp_ws-2" />
        <SIMPLERENDERER>
          <SIMPLEMARKERSYMBOL color="0,227,27" width="10" />
        </SIMPLERENDERER>
      </LAYER>
      <LAYER type="featureclass" name="pulk42" visible="true" id="1">
        <DATASET name="pulk42" type="point" workspace="shp_ws-2" />
        <COORDSYS id="4284" datumtransformid="8206" />
        <SIMPLERENDERER>
          <SIMPLEMARKERSYMBOL color="0,0,255" width="6" />
        </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 4: When in a GET_IMAGE request.

<?xml version="1.0" encoding="UTF-8"?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_IMAGE>
      <PROPERTIES>
        <ENVELOPE minx="-145.0" miny="-30.0" maxx="-125.0" maxy="45.0" />
        <IMAGESIZE width="800" height="600" />
        <FEATURECOORDSYS id="54030"  />
        <FILTERCOORDSYS id="4326" />
      </PROPERTIES>
    </GET_IMAGE>
  </REQUEST>
</ARCXML>

Example 5: When in a GET_FEATURES request.

<?xml version="1.0" encoding="UTF-8" ?>
<ARCXML version="1.1">
  <REQUEST>
    <GET_FEATURES featurelimit="25" beginrecord="0" outputmode="xml" geometry="true" envelope="true" compact="true">
      <LAYER id="4" />
      <SPATIALQUERY subfields="#ALL#" where="POPULATION > 10000000" >
        <FEATURECOORDSYS id="53030" />
        <SPATIALFILTER relation="area_intersection">
          <ENVELOPE minx="-129" miny="16" maxx="-50" maxy="62"/>
        </SPATIALFILTER>
      </SPATIALQUERY>
    </GET_FEATURES>
  </REQUEST>
</ARCXML>