#imagename,coordinate1,coordinate2,z,yaw,pitch,roll IMG_3165.JPG,46.2345612,6.5611445,539.931,38.6,3.5,8.3 IMG_3166.JPG,46.2323423,6.5623423,529.823,44.1,3.4,5.4
The import of image geolocation and orientation is useful when the values are not available in the EXIF/Xmp tags or when using PPK workflows.
The image geolocation file format is a .csv or .txt file. It contains seven or nine columns per line and uses commas "," as column separators.
Note: The .csv or .txt file should not contain a header. It is possible to add a comment in the header of the file by using the "#" special character at the beginning of the first line. For example:
Access: The import of image geolocation and orientation is available after the images are successfully imported by using:
File - Import image geolocations and orientations....
The formats are described in the table below:
- Geographic coordinates, Yaw, Pitch, Roll
- Geographic coordinates, Yaw, Pitch, Roll, and accuracy values
- Projected coordinates, Yaw, Pitch, Roll
- Projected coordinates, Yaw, Pitch, Roll, and accuracy values
Note*: The order of coordinates in the input file needs to
follow the order of axes in the coordinate system definition chosen in the import dialog.
For example, if the coordinate system definition specifies that the first axes is X and the second is Y then the order of the coordinates in the GCP input file needs to be the same.
For more information see
How to check the order of the axes in the coordinate system definition section.
imagename, coordinate1* [decimal degrees], coordinate2* [decimal degrees], z [meter], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees]
IMG_3165.JPG,46.2345612,6.5611445,539.931,38.6,3.5,8.3 IMG_3166.JPG,46.2323423,6.5623423,529.823,44.1,3.4,5.4
The latitude value is between -90° and 90°.
The longitude value is between -180° and 180°.
imagename, coordinate1* [decimal degrees], coordinate2* [decimal degrees], z [meter], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees], Accuracy Horz [meter], Accuracy Vert [meter]
IMG_3165.JPG,46.2345612,6.5611445,539.931,38.6,3.5,8.3,0.02,0.04 IMG_3166.JPG,46.2323423,6.5623423,529.823,44.1,3.4,5.4,0.02,0.04
The latitude value is between -90° and 90°.
The longitude value is between -180° and 180°.
imagename, coordinate1* [units], coordinate2* [units], z [units], yaw [decimal degrees], pitch [decimal degrees], roll [decimal degrees], Accuracy Horz [units], Accuracy Vert [units]
IMG_3165.JPG,474191.175,5091809.612,539.931,38.6,3.5,8.3,0.02,0.04 IMG_3166.JPG,474188.324,5091798.618,529.823,44.1,3.4,5.4,0.02,0.04
How to check the order of the axes in the coordinate system definition
To check the order of axes in the coordinate system definition:
- Open the EPSG Geodetic Parameter Registry website.
- Write the name or the EPSG code in the EPSG Dataset - Text search.
- Click GO and select the correct name in the results.
- Expand the COORDINATE SYSTEM section and check the order in the AXES subsection.
After checking the order of Axes in the coordinate system definition, modify the input file to follow the same order of coordinates.
Example: For the WGS 84 / UTM zone 32N (EPSG code 32632) the order of axes in the coordinate system definition is first
Easting and second
Northing. The GCPs file should be formatted as:
label, Easting [meter], Northing [meter], z [meter]
