From 82bd6254ca0753fb6ab7ae58548e0b1ed5a01a36 Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:05:32 +0200 Subject: [PATCH 1/7] EXIF fixes --- documentation/reference/exif.en.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/reference/exif.en.md b/documentation/reference/exif.en.md index a9fd83d48..cfb3104a1 100644 --- a/documentation/reference/exif.en.md +++ b/documentation/reference/exif.en.md @@ -5,7 +5,7 @@ tx_slug: documentation_reference_exif # EXIF Data in QField -When using the native QField camera, images will be geotagged with various EXIF metadata fields. Below is a reference table listing the available EXIF tags, their descriptions, examples, and comments about their usage in QField. +When using the internal QField camera, images will be geotagged with various EXIF metadata fields. Below is a reference table listing the available EXIF tags, their descriptions, examples, and comments about their usage in QField. | EXIF Tag | Description | Example | Comments | |-------------------------------------|-----------------------------------------------------------------------|---------------------------|------------------------------------------------| @@ -26,7 +26,7 @@ When using the native QField camera, images will be geotagged with various EXIF | Xmp.tiff.Make | XMP tag for the device make, also set to QField. | QField | Similar to Exif.Image.Make, used for compatibility in XMP metadata. | ## Notes -- QField captures and stores EXIF metadata automatically when using the native camera. +- QField captures and stores EXIF metadata automatically when using the internal (i.e. not the native) camera. - The coordinates (latitude and longitude) are always stored as absolute values, with the hemisphere indicated by the corresponding reference tags (e.g., `GPSLatitudeRef` for N/S). - Altitude is recorded as a positive or negative value depending on whether the elevation is above or below sea level, with `GPSAltitudeRef` used to indicate the direction. - Speed and direction are recorded if the device is moving and the orientation and speed sensors are active at the time of capture. From efb813e8e46bb0f77957e586a5c27b18fbc595c1 Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:07:41 +0200 Subject: [PATCH 2/7] Update exif.en.md --- documentation/reference/exif.en.md | 1 - 1 file changed, 1 deletion(-) diff --git a/documentation/reference/exif.en.md b/documentation/reference/exif.en.md index cfb3104a1..0c096dc1e 100644 --- a/documentation/reference/exif.en.md +++ b/documentation/reference/exif.en.md @@ -29,7 +29,6 @@ When using the internal QField camera, images will be geotagged with various EXI - QField captures and stores EXIF metadata automatically when using the internal (i.e. not the native) camera. - The coordinates (latitude and longitude) are always stored as absolute values, with the hemisphere indicated by the corresponding reference tags (e.g., `GPSLatitudeRef` for N/S). - Altitude is recorded as a positive or negative value depending on whether the elevation is above or below sea level, with `GPSAltitudeRef` used to indicate the direction. -- Speed and direction are recorded if the device is moving and the orientation and speed sensors are active at the time of capture. - Date and time stamps are stored in UTC format for consistency across locations. This reference should assist in understanding the metadata captured during geotagging and how to interpret or extract EXIF data from images taken in QField. From 07028bd360c8b1d9a3561f9e9801e6c4669d0481 Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:11:39 +0200 Subject: [PATCH 3/7] Update exif.en.md --- documentation/reference/exif.en.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/documentation/reference/exif.en.md b/documentation/reference/exif.en.md index 0c096dc1e..42a733046 100644 --- a/documentation/reference/exif.en.md +++ b/documentation/reference/exif.en.md @@ -26,9 +26,7 @@ When using the internal QField camera, images will be geotagged with various EXI | Xmp.tiff.Make | XMP tag for the device make, also set to QField. | QField | Similar to Exif.Image.Make, used for compatibility in XMP metadata. | ## Notes -- QField captures and stores EXIF metadata automatically when using the internal (i.e. not the native) camera. +- QField captures and stores EXIF metadata automatically when using the internal (i.e. not the native) camera. - The coordinates (latitude and longitude) are always stored as absolute values, with the hemisphere indicated by the corresponding reference tags (e.g., `GPSLatitudeRef` for N/S). - Altitude is recorded as a positive or negative value depending on whether the elevation is above or below sea level, with `GPSAltitudeRef` used to indicate the direction. - Date and time stamps are stored in UTC format for consistency across locations. - -This reference should assist in understanding the metadata captured during geotagging and how to interpret or extract EXIF data from images taken in QField. From 12cf341efc0fdf7545bc6a4a8c90d7d921b3cead Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:12:35 +0200 Subject: [PATCH 4/7] Update pictures.en.md --- documentation/how-to/pictures.en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/how-to/pictures.en.md b/documentation/how-to/pictures.en.md index 37a22d529..f33543ad8 100644 --- a/documentation/how-to/pictures.en.md +++ b/documentation/how-to/pictures.en.md @@ -98,7 +98,7 @@ To store the EXIF information, follow these steps: 4. The EXIF tags that QField can capture are listed in the QGIS documentation (link above). However, this list might slightly varies depending on the mobile characteristics. 5. Capturing EXIF tags requires accessing the full physical path of the picture. Be sure to reflect this in the QGIS expression. - For example, the expression `exif(@project_folder + '/' + "path", 'Exif.Image.Orientation')` retrieves the orientation of the picture stored in *path*. For more tags visit the [QField EXIF reference documentation](/reference/exif.md) and the [exiv library documentation](https://exiv2.org/tags.html). + For example, the expression `exif(@project_folder + '/' + "path", 'Exif.Image.Orientation')` retrieves the orientation of the picture stored in *path*. For more tags visit the [QField EXIF reference documentation](../reference/exif.md) and the [exiv library documentation](https://exiv2.org/tags.html). 7. Completed! QField's now capture and store the EXIF tags in the pictures table while taking pictures. ## Maximum picture size From a42f9d3244ef5f467a9341d4394c49483aea869e Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:14:25 +0200 Subject: [PATCH 5/7] Disable link check for external link --- documentation/reference/data-format.en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/reference/data-format.en.md b/documentation/reference/data-format.en.md index 81467d955..cfe4f5725 100644 --- a/documentation/reference/data-format.en.md +++ b/documentation/reference/data-format.en.md @@ -37,7 +37,7 @@ this is inefficient. ### Use COG (Cloud Optimized GeoTIFF) -The [Cloud Optimized Geotiff (COG)](https://www.cogeo.org/) format will offer best user experience for offline basemaps. +The [Cloud Optimized Geotiff (COG)](https://www.cogeo.org/) format will offer best user experience for offline basemaps. Combined with JPEG compression, it will reduce the raster size. The following commands will convert a file called `raster.tif` to a COG file `raster_cog.tif` using JPEG compression. From cfb276ef502284196ef82bd7c9b9d5bf88e63c1f Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:22:32 +0200 Subject: [PATCH 6/7] Update exif.en.md --- documentation/reference/exif.en.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/reference/exif.en.md b/documentation/reference/exif.en.md index 42a733046..d74a795bc 100644 --- a/documentation/reference/exif.en.md +++ b/documentation/reference/exif.en.md @@ -15,7 +15,7 @@ When using the internal QField camera, images will be geotagged with various EXI | Exif.GPSInfo.GPSLongitudeRef | Longitude reference (E = East, W = West). | E | Determines whether the longitude is east or west of the prime meridian. | | Exif.GPSInfo.GPSAltitude | The altitude above sea level (in meters) where the image was taken. | 490 | Positive values indicate above sea level; negative values indicate below. | | Exif.GPSInfo.GPSAltitudeRef | Altitude reference (0 = Below Sea Level, 1 = Above Sea Level). | 1 | Indicates whether altitude is above or below sea level. | -| Exif.GPSInfo.GPSImgDirection | The direction in degrees in which the camera was facing when the image was taken. | 270 | Represents the compass direction (0 = North, 90 = East, 180 = South, 270 = West). | +| Exif.GPSInfo.GPSImgDirection | The direction in degrees in which the camera was facing when the image was taken. | 270 | Represents the compass direction (0 = North, 90 = East, 180 = South, 270 = West) relative to magnetic north. | | Exif.GPSInfo.GPSImgDirectionRef | Direction reference (M = Magnetic North). | M | Specifies whether the direction is relative to magnetic north. | | Exif.GPSInfo.GPSSpeed | The speed of the device when the image was taken, in kilometers per hour (km/h). | 30.5 | Captured if the device is moving at the time of image capture. | | Exif.GPSInfo.GPSSpeedRef | Speed unit (K = kilometers per hour). | K | Currently, speed is recorded in kilometers per hour in QField. | @@ -30,3 +30,4 @@ When using the internal QField camera, images will be geotagged with various EXI - The coordinates (latitude and longitude) are always stored as absolute values, with the hemisphere indicated by the corresponding reference tags (e.g., `GPSLatitudeRef` for N/S). - Altitude is recorded as a positive or negative value depending on whether the elevation is above or below sea level, with `GPSAltitudeRef` used to indicate the direction. - Date and time stamps are stored in UTC format for consistency across locations. +- See the corresponding [how to fetch geotag exif information into the attribute table section](../how-to/pictures.md#fetching-geotags-exif-from-the-image-file-into-the-attribute-table) for instructions how to make use of this From 3bb4b2a4a27ca22a3fe8f1649c39f46ac21ac9d7 Mon Sep 17 00:00:00 2001 From: Matthias Kuhn Date: Sun, 6 Oct 2024 10:23:20 +0200 Subject: [PATCH 7/7] Update mkdocs.yml --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index 28a92e306..da7fd80d6 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -95,6 +95,7 @@ nav: - Technical reference: - reference/index.md - reference/data-format.md + - reference/exif.md - QFieldCloud: - reference/qfieldcloud/concepts.md - reference/qfieldcloud/projects.md