The Project geometry tool projects a geometry field to a new spatial reference.
Examples
The Project geometry tool can be used in scenarios such as the following:
- You have two datasets that contain geometry fields with different spatial references and you want the geometry fields to have the same spatial reference. Project one or both geometry fields to the target spatial reference.
- 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. |
Spatial reference | The target output spatial reference. |
Usage notes
Use the Spatial reference parameter to set the spatial reference that the specified geometry field will be projected to. The Project geometry tool will transform the geometry field to the new spatial reference and update the schema to reflect the new spatial reference ID. The new spatial reference will be visible in the schema preview.
Some spatial references 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.