Class: QgsExifTools

class qgis.core.QgsExifTools

Bases: sip.wrapper

Contains utilities for working with EXIF tags in images.

Methods

geoTagImage

Writes geotags to the image at imagePath.

getGeoTag

Returns the geotagged coordinate stored in the image at imagePath.

hasGeoTag

Returns True if the image at imagePath contains a valid geotag.

readTag

Returns the value of of an exif tag key stored in the image at imagePath.

readTags

Returns a map object containing all exif tags stored in the image at imagePath.

Attributes

staticMetaObject

class GeoTagDetails

Bases: sip.wrapper

Extended image geotag details.

New in version 3.6.

elevation
geoTagImage(imagePath: str, location: QgsPointXY, details: QgsExifTools.GeoTagDetails = QgsExifTools.GeoTagDetails())bool

Writes geotags to the image at imagePath.

The location argument indicates the GPS location to write to the image, as a WGS84 latitude/longitude coordinate.

If desired, extended GPS tags (such as elevation) can be specified via the details argument.

Returns True if writing was successful.

See also

getGeoTag()

Parameters
  • imagePath (str) –

  • location (QgsPointXY) –

  • details (QgsExifTools.GeoTagDetails = QgsExifTools.GeoTagDetails()) –

Return type

bool

getGeoTag(imagePath: str)Tuple[QgsPoint, bool]

Returns the geotagged coordinate stored in the image at imagePath.

If a geotag was found, ok will be set to True.

If the image contains an elevation tag then the returned point will contain the elevation as a z value.

See also

geoTagImage()

Parameters

imagePath (str) –

Return type

Tuple[QgsPoint, bool]

hasGeoTag(imagePath: str)bool

Returns True if the image at imagePath contains a valid geotag.

See also

getGeoTag()

Parameters

imagePath (str) –

Return type

bool

readTag(imagePath: str, key: str)Any

Returns the value of of an exif tag key stored in the image at imagePath.

New in version 3.22.

Parameters
  • imagePath (str) –

  • key (str) –

Return type

Any

readTags(imagePath: str)Dict[str, Any]

Returns a map object containing all exif tags stored in the image at imagePath.

New in version 3.22.

Parameters

imagePath (str) –

Return type

Dict[str, Any]

staticMetaObject = <PyQt5.QtCore.QMetaObject object>