FEATURECOORDSYS

FEATURECOORDSYS

Used in: CONFIG REQUEST
Parent elements: GET_GEOCODE PROPERTIES QUERY SPATIALQUERY

<FEATURECOORDSYS	Attribute Description Table
*id ="integer"* *string ="string"* datumtransformid ="integer" datumtransformstring ="string" > No child elements </FEATURECOORDSYS >
Bold: Attribute or child element is required.

Description:

FEATURECOORDSYS is the projection coordinate system that layers in a MapService are projected to.

Restrictions:

Must use either id or string, but not both.
For datum transformations either datumtransformid or datumtransformstring is used, but not both.

Notes:

For a complete list of supported IDs and definition strings, see:
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.
If FEATURECOORDSYS is used in a map configuration file, then FILTERCOORDSYS also needs to be present.
If a MapService with FEATURECOORDSYS is used in the ArcIMS HTML Viewer, ArcIMS Java Standard or Custom Viewers, or ArcExplorer 3, FEATURECOORDSYS and FILTERCOORDSYS must use the same value for id or string.
When in PROPERTIES, FEATURECOORDSYS defines the default coordinate system for all layers. Using FEATURECOORDSYS in SPATIALQUERY overrides the information in PROPERTIES.
When used as a child element of SPATIALQUERY in a GET_FEATURES request, it applies only to the layer in that request.
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	Back to Top
datumtransformid	Datum transformation ID.
datumtransformstring	Datum transformation definition string.
id	Projected or geographic coordinate system ID.
string	Projected or geographic coordinate system definition string.

Examples for FEATURECOORDSYS:

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

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" />
    </ENVIRONMENT>
    <MAP>
      <PROPERTIES>
        <ENVELOPE minx="-180.0" miny="-90.0" maxx="180.0" maxy="90.0" />
        <MAPUNITS units="meters" />
        <FEATURECOORDSYS id="54008" />
        <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.

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="-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: When in a GET_IMAGE request.	Back to Top
<?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 4: When in a GET_FEATURES request.

Back to Top

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

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

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="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>