The Project geometry tool projects a geometry field to a new coordinate system.
Examples
The Project geometry tool can be used in scenarios such as the following:
- You have two datasets that contain geometry fields with different coordinate systems and you want the geometry fields to have the same coordinate system. Project one or both geometry fields to the target coordinate system.
- You have a dataset containing a geometry field in a geographic coordinate system and want to use it in a spatial join using planar distances. Use this tool to project the field to a projected coordinate system.
Parameters
The following table outlines the parameters used in the Project geometry tool:
| Parameter | Description |
|---|---|
Input dataset | The dataset containing the geometry field that will be projected. |
Geometry field | The geometry field that will be projected. |
Coordinate system | The target output coordinate system. |
Usage notes
Use the Coordinate system parameter to set the coordinate system that the specified geometry field will be projected to. The Project geometry tool will transform the geometry field to the new coordinate system and update the schema to reflect the new coordinate system ID. The new coordinate system will be visible in the schema preview.
Some coordinate systems do not transform effectively, in which case an error will occur indicating that the transformation cannot be resolved.
Transformations can significantly alter the locations of the data. If possible, use the map preview after projection to verify the new locations using records where ground-truth is known.
Outputs
The tool output contains the same fields as the input dataset. The input geometry field will contain new, projected values.
Limitations
The tool does not create a new geometry field. This means that the input geometry values will not be maintained. The input geometry field will be returned with new, projected values.
Licensing requirements
The following licensing and configurations are required:
- Creator or Professional user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role
To learn more about Data Pipelines requirements, see Requirements.