= !MapGuide RFC 6 - Overriding Coordinate Systems in Feature Sources =

This page contains a change request (RFC) for the !MapGuide Open Source project.  
More !MapGuide RFCs can be found on the [wiki:MapGuideRfcs RFCs] page.


== Status == 
 
||RFC Template Version||(1.0)|| 
||Submission Date||February 5, 2007||
||Last Modified||Tony Fang [[Timestamp]]||
||Author||Tony Fang||
||RFC Status||draft||
||Implementation Status||pending||
||Proposed Milestone||1.2||
||Assigned PSC guide(s)||(when determined)||
||'''Voting History'''||(vote date)||
||+1|| ||
||+0|| ||
||-0|| ||
||-1|| ||
 
== Overview ==

The coordinate systems of the data can be overridden by specifying an entry in the SupplementalSpatialContextInfo of the feature source.

== Motivation ==

In the feature source, there is an optional tag called SupplementalSpatialContextInfo. This can contain a SpatialContextType defining a coordinate system override. If an entry exists for a given Spatial Context, then the specified coordinate system override will be used. The coordinate system override will be given preference over the coordinate system defined in the data.

Previously, the SupplementalSpatialContextInfo was intended for data containing spatial contexts with undefined coordinate systems. The SupplementalSpatialContextInfo would allow a coordinate system to be specified for a given spatial context. The SupplementalSpatialContextInfo can now be used to override coordinate systems for all spatial contexts in a feature source -- regardless of whether it contains a coordinate system or not.

== Proposed Solution ==

The schema FeatureSource-1.0.0.xsd does not change. SupplementalSpatialContextInfo already exists in the schema. The schema documentation will be updated to reflect the new behaviour in the server.

{{{
<xs:element name="SupplementalSpatialContextInfo" type="SpatialContextType" minOccurs="0" maxOccurs="unbounded">
  <xs:annotation>
    <xs:documentation>Additional information for a spatial context when the coordinate system is overridden.
    </xs:documentation>
  </xs:annotation>
</xs:element>
}}}

When the server returns the data for a given feature source. it will check for entries in the SupplementalSpatialContextInfo. If there is a spatial context containing a coordinate system override, then that is the coordinate system used for the data.

== Implications ==

SupplementalSpatialContextInfo is an optional field. If the feature source does not contain an override, then the server will use the coordinate system contained in the data.

For previous versions of the server, the SupplementalSpatialContextInfo field is not used when the coordinate system is defined in the data.

== Test Plan ==

Add unit tests to test coordinate system overrides.

== Funding/Resources ==

Autodesk to supply