COORDSYS

Used in

Servers

Image Feature Extract

Parent elements

Syntax

<COORDSYS	Attribute Description Table
*(r)id="integer"* *(r)string="string"* datumtransformid="integer" datumtransformstring="string" > No Child Elements </COORDSYS >
(r): Attribute or child element is required.

Description

Defines the projection coordinate system of a layer. COORDSYS cannot be used to project a layer; its purpose is to provide the metadata for the layer. FEATURECOORDSYS and FILTERCOORDSYS are used to project the layers to a specified projection.

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:
- 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]
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 using COORDSYS in an acetate layer, the COORDSYS element should be placed inside the OBJECT element rather than the LAYER element. COORDSYS is required in order to project objects in an acetate layer.
COORDSYS can be used to designate the current projection of a raster layer. For ArcIMS 9.0 and all 9.0 service packs, COORDSYS must be included for raster layers or the rasters will not project. Beginning with ArcIMS 9.1, if COORDSYS is not included, rasters are projected to the service's FEATURECOORDSYS value, and COORDSYS is not required.
COORDSYS is not needed if no datum transformation information is needed for the layer and:
- A *.prj file is available for a shapefile.
- A *.prj file is available for a coverage in ArcSDE for Coverages.
- A spatial references table is used in ArcSDE.
Datum transformation information is not included in *.prj files and spatial reference tables. Therefore, COORDSYS must be included if a datum transformation is needed.
If a layer does not project, double check that a *.prj file or spatial reference table exists for the layer. If not, COORDSYS must be included.
For more information on the projection elements, see Using Projection Elements.

Attribute Descriptions for COORDSYS

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 COORDSYS

Example 1: Using a coordinate system ID.

<?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 id="54008" />
        <FILTERCOORDSYS id="54008"/>
      </PROPERTIES>
      <WORKSPACES>
        <SHAPEWORKSPACE name="shp_ws-0" directory="<path to data>"/>
      </WORKSPACES>
      <LAYER type="featureclass" name="Cntry94_Mollweide" visible="true" id="0">
      <DATASET name="Cntry94_Mollweide" type="polygon" workspace="shp_ws-0" />
      <COORDSYS 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]]" />
      <SIMPLERENDERER>
         <SIMPLEPOLYGONSYMBOL filltransparency="1.0" fillcolor="27,127,127" />
      </SIMPLERENDERER>
      </LAYER>
    </MAP>
  </CONFIG>
</ARCXML>

Example 3: Using a datum transformation from Pulkovo 1942 to WGS 1984 (datumstransformid="8206"). The overall MapService has a FEATURECOORDSYS in geographic coordinates (id="4326").

<?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="4326" />
        <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>