Hide Table of Contents
esri
esri/arcgis
esri/dijit
esri/dijit/analysis
esri/dijit/geoenrichment
esri/dijit/geoenrichment/ReportPlayer
esri/geometry
esri/layers
esri/renderers
esri/symbols
esri/tasks
esri/tasks/datareviewer
esri/tasks/geoenrichment
esri/tasks/locationproviders
Class: GeographicTransformation
[ AMD Module Require | Legacy Module Require ]
require(["esri/geometry/GeographicTransformation"], function(GeographicTransformation) { /* code goes here */ });
Description
(Added at v3.24)
Projecting your data between coordinate systems sometimes requires transforming between geographic coordinate systems. Geographic transformations are used to transform coordinates between spatial references that have different geographic coordinate systems, and thus different datums. Using the most suitable transformation ensures the best possible accuracy when converting geometries from one spatial reference to another.
The projection module provides the gettransformation() and getTransformations() methods which return the default geographic transformation for the given projection or a list of suitable geographic transformations.
Things to consider:
-
Only equation-based geographic transformations are supported.
See also:
SpatialReference References Guide
What are map projections
Choosing an appropriate transformation
Geographic transformation methods
Samples
Search for samples that use this class.Constructors
| Name | Summary |
|---|---|
| new GeographicTransformation(params?) | Creates a new GeographicTransformation object. |
Properties
| Name | Type | Summary |
|---|---|---|
| steps | GeographicTransformationStep[] | Geographic transformation steps. |
Methods
| Name | Return type | Summary |
|---|---|---|
| getInverse() | GeographicTransformation | Returns the inverse of the geographic transformation, calling this method or null if the transformation is not invertible. |
Constructor Details
Creates a new GeographicTransformation object.
Parameters:
< |
Optional | See options descriptions for further information. |
params properties: < |
Optional | Geographic transformation steps. Each step represents a geographic transformation that will be used in the process of transforming coordinates from one geographic coordinate system to another. |
Property Details
<GeographicTransformationStep[]
GeographicTransformationStep[]Geographic transformation steps. Each step represents a geographic transformation that will be used in the process of transforming coordinates from one geographic coordinate system to another.
Method Details
Returns the inverse of the geographic transformation, calling this method or
null if the transformation is not invertible. The inverse of a transformation converts coordinates using the same method and parameters, but in the opposite direction of the original object. For example, if the original object represents the NAD_1983_HARN_To_NAD_1983_NSRS2007_1 transformation, then the inverse will transform from NAD 83 (NSRS 2007) to NAD 83 (HARN).Return type:
GeographicTransformation