English

How To: Use the FILTERCOORDSYS and FEATURECOORDSYS tags in a GET_LAYOUT request

Summary

The FILTERCOORDSYS and FEATURECOORDSYS tags refer to coordinate systems.

FILTERCOORDSYS is used to specify the coordinate system of the requesting client or the coordinate system of the data frame.

FEATURECOORDSYS is used to specify the resulting coordinate system when you want to change the coordinate system of a data frame.

FILTERCOORDSYS and FEATURECOORDSYS can be used in both the PROPERTIES and DATAFRAME child elements of the GET_LAYOUT request.

For more information please refer to the ArcXML Programmer's Reference Guide topic "Using GET_LAYOUT and LAYOUT with ArcMap Image Services". For information regarding coordinate system ids see "Coordinate IDs and Descriptions" available in the HTML version of the ArcXML Guide. Both can be found following the link given in Related Information, below.

Procedure

  • When FILTERCOORDSYS and FEATURECOORDSYS are used within PROPERTIES the coordinate system specified in the tags refer to all data frames.

    For instance, in the following code the FILTERCOORDSYS id of "4326" indicates a geographic coordinate system for all the data frames within the layout. The FEATURECOORDSYS id of "54030" specifies a coordinate system transformation for all layout data frames from a geographic coordinate system to a Robinson projection.
    Code:
    <PROPERTIES>
     <FILTERCOORDSYS id= "4326" />
     <FEATURECOORDSYS id= "54030" />
    </PROPERTIES >
    Note:
    If the coordinate system specified in FILTERCOORDSYS does not match the coordinate system of the data frame in the original ArcMap document the spatial extent of the data frame in the GET_LAYOUT request may be incorrect.  If there is a mismatch specify the coordinate system within DATAFRAME. 
  • When FILTERCOORDSYS and FEATURECOORDSYS are used within DATAFRAME the coordinate system specified in the tags refer to the specific data frame.

    For instance, in the following code the FILTERCOORDSYS id of "4326" indicates a geographic coordinate system for the requesting client or the specific data frame. The FEATURECOORDSYS id of "54030" specifies a coordinate system transformation for this data frame to a Robinson projection.
    Code:
    <DATAFRAME id= "DataFrameName">
     <FILTERCOORDSYS id= "4326" />
     <FEATURECOORDSYS id= "54030" />
    </DATAFRAME>
    Note:
    FILTERCOORDSYS and FEATURECOORDSYS settings within DATAFRAME will take precedence over those set in PROPERTIES.

Related Information