The <projection-wkt> element specifies a projection to be used for the map and reporting routines
using the projection's well-known text string. In this element, the well known text string is XML content,
not an attribute like the other IMF configuration items are defined. There is an attribute for the
projection's alias, but the actual projection information for this element is put between opening and closing
element tags, like:
<projection-wkt alias="State Plane">
PROJCS["NAD_1983_StatePlane_Massachusetts_Mainland_FIPS_2001_Feet",
GEOGCS["GCS_North_American_1983",
DATUM["D_North_American_1983",
SPHEROID["GRS_1980",6378137.0,298.257222101]],
PRIMEM["Greenwich",0.0],
UNIT["Degree",0.0174532925199433]],
PROJECTION["Lambert_Conformal_Conic_2SP"],
PARAMETER["False_Easting",656166.6666666665],
PARAMETER["False_Northing",2460625.0],
PARAMETER["Central_Meridian",-71.5],
PARAMETER["Standard_Parallel_1",41.71666666666667],
PARAMETER["Standard_Parallel_2",42.68333333333333],
PARAMETER["Latitude_Of_Origin",41.0],
UNIT["Foot_US",0.3048006096012192]]
</projection-wkt>
A good source of well-known text projection strings can be found in the
"Coordinate IDs and Descriptions" section of ESRI's
ArcXML Programmer's Reference Guide.
| Frequency |
Description (in this context) |
|
PO |
Zero or one projection element may appear within the
<map-center-coordinate> element.
|
|
PO+ |
Zero or more projection element may appear in the
<identify-report-coordinates> element.
|
|
PR1 |
Exactly one allowable projection element must appear within the
<map-projection> element.
|
|
PR+ |
One or more projection elements must appear within the
<upload-projections> element.
|
| |
|
|
|
Attributes |
Description |
|
alias
|
The user name of the projection. Optional.
|
| |
|
|
|
Content Description |
All projections must have some of the following parameters:
- central_meridian - longitude for the natural origin (for rectangular coordinates)
- false_easting - easting value assigned to the natural origin (added to all x coordinates)
- false_northing - northing value assigned to the natural origin (added to all y coordinates)
- latitude_of_origin - latitude of the natural origin (for rectangular coordinates)
- scale_factor - scale factor at the natural origin (along a parallel of latitude)
- standard_parallel_1 - latitude of first standard parallel (true to scale)
- standard_parallel_2 - latitude of second standard parallel (true to scale)
- latitude_true_scale - latitude (parallel) where the scale will equal the scale factor
The valid projection names and the parameters that they require are shown in the following
table.
|
Mercator_1SP
|
- central_meridian
- false_easting
- false_northing
- scale_factor
|
|
Mercator_2SP
|
- central_meridian
- false_easting
- false_northing
- standard_parallel_1
|
|
Transverse_Mercator
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
|
|
Lambert_Conformal_Conic_1SP
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
|
|
Lambert_Conformal_Conic_2SP
Note: Well known text containing the projection named
Lambert_Conformal_Conic will be processed as if it contained the name above.
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- standard_parallel_1
- standard_parallel_2
|
|
Lambert_Conformal_Conic_2SP_Belgium
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- standard_parallel_1
- standard_parallel_2
|
|
Albers_Conic_Equal_Area
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- standard_parallel_1
- standard_parallel_2
|
|
Oblique_Stereographic
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
|
|
Polar_Stereographic
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
- latitude_true_scale
|
|
Polar_Stereographic_Series
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
|
|
Stereographic
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
|
|
Orthographic
|
- central_meridian
- false_easting
- false_northing
- latitude_of_origin
- scale-factor
|
|
| |
|
Example:
<!-- NAD_1983_StatePlane_Hawaii_1_FIPS_5101_Feet -->
<projection-wkt alias="Hawaii State Plane">PROJCS["NAD_1983_StatePlane_Hawaii_1_FIPS_5101_Feet",GEOGCS["GCS_North_American_1983",DATUM["D_North_American_1983",SPHEROID["GRS_1980",6378137.0,298.257222101]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Transverse_Mercator"],PARAMETER["False_Easting",1640416.666666667],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",-155.5],PARAMETER["Scale_Factor",0.9999666666666667],PARAMETER["Latitude_Of_Origin",18.83333333333333],UNIT["Foot_US",0.3048006096012192]]</projection-wkt>
<!-- Note that spaces, tabs, and line feeds are insignificant, so this is OK. -->
<projection-wkt alias="State Plane">
PROJCS["NAD_1983_StatePlane_Massachusetts_Mainland_FIPS_2001_Feet",
GEOGCS["GCS_North_American_1983",
DATUM["D_North_American_1983",
SPHEROID["GRS_1980",6378137.0,298.257222101]],
PRIMEM["Greenwich",0.0],
UNIT["Degree",0.0174532925199433]],
PROJECTION["Lambert_Conformal_Conic_2SP"],
PARAMETER["False_Easting",656166.6666666665],
PARAMETER["False_Northing",2460625.0],
PARAMETER["Central_Meridian",-71.5],
PARAMETER["Standard_Parallel_1",41.71666666666667],
PARAMETER["Standard_Parallel_2",42.68333333333333],
PARAMETER["Latitude_Of_Origin",41.0],
UNIT["Foot_US",0.3048006096012192]]
</projection-wkt>