add mapping via MapQuest and Waze

Also:
- fix near-zero coordinates handling
- simplify/improve mapping via Bing Maps
- fix wording in action descriptors
- make minor README amendments

Author: s-n-ushakov

README.adoc

@@ -14,9 +14,9 @@ for plotting GPS position thereof using various online mapping services
 https://www.cipa.jp/std/documents/download_e.html?DC-008-Translation-2023-E[Exif] is a standard, specified{nbsp}/ issued
 by JEIDA{nbsp}/ https://www.jeita.or.jp/english/[JEITA]{nbsp}/ https://www.cipa.jp/e/index.html[CIPA], that defines
 formats for media files, as well as ancillary metadata tags, to be used by digital cameras{nbsp}/ scanners and sound
-recorders. MPEG video formats also allow containing metadata in media files. This metadata, besides various camera and
-shooting mode information, such as the camera model and make, aperture, shutter speed, focal length, ISO speed, etc.,
-may also contain geolocation information.
+recorders. MPEG video formats also allow containing metadata in media files. This metadata, besides various technical
+image information, such as camera make and model, aperture, shutter speed, focal length, ISO speed, etc., may also
+contain geolocation information.
 
 https://github.com/linuxmint/nemo[Nemo] is the file manager for the https://github.com/linuxmint/cinnamon[Cinnamon]
 desktop environment, the primary one for https://linuxmint.com/[Linux Mint].
@@ -68,7 +68,7 @@ A release archive contains the following files:
 │     │                                                  :   using 'exif' utility
 │     ├─ exif_metadata_list_exiftool.nemo_action         : ... for displaying Exif metadata
 │     │                                                  :   using 'exiftool' utility
-│     └─ exif_metadata_mapping_*.nemo_action             : ... for displaying GPS position in
+│     └─ exif_metadata_mapping_*.nemo_action             : ... for displaying GPS position using
 │                                                        :   various online mapping services
 │
 ├─ readme/
@@ -85,7 +85,7 @@ A release archive contains the following files:
 ```
 
 The approach with scripts separation from related actions into a nested folder was borrowed from
-https://github.com/smurphos/nemo_actions_and_cinnamon_scripts[smurphos 'Nemo Actions & Cinnamon Scripts' repo].
+https://github.com/smurphos/nemo_actions_and_cinnamon_scripts[GitHub : smurphos : Nemo Actions & Cinnamon Scripts].
 
 ### Usage
 
@@ -134,7 +134,7 @@ The solution currently has the following provisions for internationalization:
 * `LANGUAGE` variable defined in `exif_metadata__settings.bash`:
 ** overrides{nbsp}/ shadows similar user profile variable;
 ** defaults to shortened language-code-only user profile setting as `"${LANGUAGE/_*/}"`;
-** has effect on language settings of the utilities and on online mapping services;
+** has effect on language settings of the utilities and of online mapping services;
 * context menu item names and comment lines for metadata display actions, specified in related action descriptors.
 
 #### Browser for displaying GPS position in online mapping services

nemo/actions/action_scripts/exif_metadata__functions.bash

@@ -14,18 +14,18 @@
 #   - altitude               : shared 'altitude' variable
 obtain_gps_position_using_exif () {
   # obtain specific GPS-related metadata
-  local latitude=$(exif --machine-readable --ifd=GPS --tag GPSLatitude "$1")
+  local latitude=$(LC_NUMERIC=POSIX exif --machine-readable --ifd=GPS --tag GPSLatitude "$1")
   local latitude_ref=$(exif --machine-readable --ifd=GPS --tag GPSLatitudeRef "$1")
-  local longitude=$(exif --machine-readable --ifd=GPS --tag GPSLongitude "$1")
+  local longitude=$(LC_NUMERIC=POSIX exif --machine-readable --ifd=GPS --tag GPSLongitude "$1")
   local longitude_ref=$(exif --machine-readable --ifd=GPS --tag GPSLongitudeRef "$1")
   altitude=$(exif --machine-readable --ifd=GPS --tag GPSAltitude "$1")
 
   # if GPS position is present, convert to degrees
   if [ -n "${latitude}" ] ; then
     local latitude_tokens=(${latitude//, / })
     local longitude_tokens=(${longitude//, / })
-    local latitude_degrees=$(echo "scale=6 ; ${latitude_tokens[0]} + ${latitude_tokens[1]} / 60 + ${latitude_tokens[2]//,/.} / 3600" | bc)
-    local longitude_degrees=$(echo "scale=6 ; ${longitude_tokens[0]} + ${longitude_tokens[1]} / 60 + ${longitude_tokens[2]//,/.} / 3600" | bc)
+    local latitude_degrees=$(echo "scale=6 ; ${latitude_tokens[0]} + ${latitude_tokens[1]} / 60 + ${latitude_tokens[2]} / 3600" | bc | sed 's/^\./0./')
+    local longitude_degrees=$(echo "scale=6 ; ${longitude_tokens[0]} + ${longitude_tokens[1]} / 60 + ${longitude_tokens[2]} / 3600" | bc | sed 's/^\./0./')
     gps_position="${latitude_degrees}${latitude_ref}, ${longitude_degrees}${longitude_ref}"
   else
     gps_position=''

nemo/actions/action_scripts/exif_metadata_mapping_bing.bash

@@ -14,28 +14,13 @@
 #
 # See https://social.msdn.microsoft.com/Forums/en-US/1ee6dfc4-b4cd-4bfc-a3ad-71acf80c61c3/bing-maps-beta-how-do-i-create-an-http-link-to-bring-up-the-address-on-a-bing-map?forum=vemapcontroldev
 # for discussions on Microsoft forum
+#
+# Still experiments suggest that the simplest 'q=' query is the most efficient...
 #-----------------------------------------------------------------------------------------------------------------------
 
-# source the script file with reusable function definitions
-. "$(dirname "$0")/exif_metadata__functions.bash"
-
 # define specific function for URL formatting, specified in 'exif_metadata__mapping.bash'
 format_url () {
-  # obtain coordinates in numeric signed format
-  declare lat_signed lng_signed ; coordinates_as_numeric_signed lat_signed lng_signed "$1"
-
-  if [ -n "${lat_signed}" ] ; then
-    # one of possible implementation options: use 'rtp' url param;
-    # looks reliable, but displays an unnecessary 'Directions' pane for route planning
-    url="https://www.bing.com/maps?setLang=${LANGUAGE}&rtp=pos.${lat_signed}_${lng_signed}"
-
-    # another possible implementation option: use 'cp' and 'sp' url params;
-    # unfinished, as currently produces no visible point/marker on the map
-    #   url="https://www.bing.com/maps?setLang=${LANGUAGE}&cp=${lat_signed}~${lng_signed}&sp=point.${lat_signed}_${lng_signed}_titleString_notesString_linkURL_photoURL"
-  else
-    # make an attempt to display error message in the browser address line
-    url="https://_/ERROR: unexpected GPS position syntax: [$1]"
-  fi
+  url="https://www.bing.com/maps?setLang=${LANGUAGE}&q=${1/, /%2C+}"
 }
 
 # source/call the generic script for handling GPS locations or for action condition evaluation

nemo/actions/action_scripts/exif_metadata_mapping_mapquest.bash

@@ -0,0 +1,24 @@
+#! /bin/bash
+#-----------------------------------------------------------------------------------------------------------------------
+# Script to implement rendering of GPS locations from Exif metadata in MapQuest mapping service
+# and for evaluation of conditions for related Nemo action to be displayed in the context menu.
+#-----------------------------------------------------------------------------------------------------------------------
+
+# source the script file with reusable function definitions
+. "$(dirname "$0")/exif_metadata__functions.bash"
+
+# define specific function for URL formatting, specified in 'exif_metadata__mapping.bash'
+format_url () {
+  # obtain coordinates in numeric signed format
+  declare lat_signed lng_signed ; coordinates_as_numeric_signed lat_signed lng_signed "$1"
+
+  if [ -n "${lat_signed}" ] ; then
+    url="https://www.mapquest.com/latlng/${lat_signed}%2C${lng_signed}"
+  else
+    # make an attempt to display error message in the browser address line
+    url="https://_/ERROR: unexpected GPS position syntax: [$1]"
+  fi
+}
+
+# source/call the generic script for handling GPS locations
+. "$(dirname "$0")/exif_metadata__mapping.bash"

nemo/actions/action_scripts/exif_metadata_mapping_waze.bash

@@ -0,0 +1,24 @@
+#! /bin/bash
+#-----------------------------------------------------------------------------------------------------------------------
+# Script to implement rendering of GPS locations from Exif metadata in Waze mapping service
+# and for evaluation of conditions for related Nemo action to be displayed in the context menu.
+#-----------------------------------------------------------------------------------------------------------------------
+
+# source the script file with reusable function definitions
+. "$(dirname "$0")/exif_metadata__functions.bash"
+
+# define specific function for URL formatting, specified in 'exif_metadata__mapping.bash'
+format_url () {
+  # obtain coordinates in numeric signed format
+  declare lat_signed lng_signed ; coordinates_as_numeric_signed lat_signed lng_signed "$1"
+
+  if [ -n "${lat_signed}" ] ; then
+    url="https://www.waze.com/${LANGUAGE}/live-map/directions?latlng=${lat_signed}%2C${lng_signed}"
+  else
+    # make an attempt to display error message in the browser address line
+    url="https://_/ERROR: unexpected GPS position syntax: [$1]"
+  fi
+}
+
+# source/call the generic script for handling GPS locations
+. "$(dirname "$0")/exif_metadata__mapping.bash"

nemo/actions/exif_metadata_mapping_google.nemo_action

@@ -19,10 +19,10 @@ Active=true
 
 # The name to show in the menu, locale supported with standard desktop spec.
 Name[en]=Display GPS position in 'Google Maps'
-Name[ru]=Показать GPS-позицию в сервисе '2ГИС'
+Name[ru]=Показать GPS-позицию в сервисе 'Google Карты'
 
 # Tool tip, locale supported (Appears in the status bar)
-Comment[en]=Display GPS position for '%f' in '2GIS' online mapping service
+Comment[en]=Display GPS position for '%f' in 'Google Maps' online mapping service
 Comment[ru]=Показать GPS-позицию для файла '%f' в онлайн-сервисе 'Google Карты'
 
 # What to run.  Enclose in < > to run an executable that resides in the actions folder.

nemo/actions/exif_metadata_mapping_mapquest.nemo_action

@@ -0,0 +1,49 @@
+[Nemo Action]
+#-----------------------------------------------------------------------------------------------------------------------
+# A Nemo action file to display GPS location from media file Exif metadata in MapQuest mapping service.
+#
+# See 'https://www.cipa.jp/std/documents/download_e.html?DC-008-Translation-2023-E' for Exif 3.0 metadata specification.
+#-----------------------------------------------------------------------------------------------------------------------
+# See 'https://github.com/linuxmint/nemo/blob/master/files/usr/share/nemo/actions/sample.nemo_action' for a sample of
+# Nemo action file with detailed comments.
+#-----------------------------------------------------------------------------------------------------------------------
+# NOTE on debugging:
+#
+# Run Nemo in debug mode using with NEMO_DEBUG set to include 'Actions', i.e.:
+#     $ nemo --quit
+#     $ NEMO_DEBUG=Actions nemo --debug
+#-----------------------------------------------------------------------------------------------------------------------
+
+# Whether this action is active.  For troubleshooting.
+Active=true
+
+# The name to show in the menu, locale supported with standard desktop spec.
+Name[en]=Display GPS position in 'MapQuest'
+Name[ru]=Показать GPS-позицию в сервисе 'MapQuest'
+
+# Tool tip, locale supported (Appears in the status bar)
+Comment[en]=Display GPS position for '%f' in 'MapQuest' online mapping service
+Comment[ru]=Показать GPS-позицию для файла '%f' в онлайн-сервисе 'MapQuest'
+
+# What to run.  Enclose in < > to run an executable that resides in the actions folder.
+Exec=<action_scripts/exif_metadata_mapping_mapquest.bash %F>
+
+# Icon name to use in the menu - must be a theme icon name
+Icon-Name=view-pin-symbolic
+
+# What type selection: [s]ingle, [m]ultiple, any, notnone, none (background click), or
+# a number representing how many files must be selected to display.
+Selection=s
+
+# What mime-types to display on - this is an array, end with a semicolon
+Mimetypes=image/jpeg;video/mp4;
+
+# Dependencies - program executables required for this action to work.
+# This is an array, separate entries with semi-colon, and terminate with a semicolon.
+#Dependencies=exiftool;
+
+# Conditions - semicolon-separated array of special conditions
+Conditions=exec <action_scripts/exif_metadata_mapping_mapquest.bash %F --condition>;
+
+# Run in terminal - set to true to execute the Exec line in a spawned terminal window.
+#Terminal=false

nemo/actions/exif_metadata_mapping_openstreetmap.nemo_action

@@ -1,6 +1,6 @@
 [Nemo Action]
 #-----------------------------------------------------------------------------------------------------------------------
-# A Nemo action file to display GPS location from media file Exif metadata in 2GIS mapping service.
+# A Nemo action file to display GPS location from media file Exif metadata in OpenStreetMap mapping service.
 #
 # See 'https://www.cipa.jp/std/documents/download_e.html?DC-008-Translation-2023-E' for Exif 3.0 metadata specification.
 #-----------------------------------------------------------------------------------------------------------------------

nemo/actions/exif_metadata_mapping_vk.nemo_action

@@ -1,6 +1,6 @@
 [Nemo Action]
 #-----------------------------------------------------------------------------------------------------------------------
-# A Nemo action file to display GPS location from media file Exif metadata in 2GIS mapping service.
+# A Nemo action file to display GPS location from media file Exif metadata in VK Maps.
 #
 # See 'https://www.cipa.jp/std/documents/download_e.html?DC-008-Translation-2023-E' for Exif 3.0 metadata specification.
 #-----------------------------------------------------------------------------------------------------------------------

nemo/actions/exif_metadata_mapping_waze.nemo_action

@@ -0,0 +1,49 @@
+[Nemo Action]
+#-----------------------------------------------------------------------------------------------------------------------
+# A Nemo action file to display GPS location from media file Exif metadata in Waze mapping service.
+#
+# See 'https://www.cipa.jp/std/documents/download_e.html?DC-008-Translation-2023-E' for Exif 3.0 metadata specification.
+#-----------------------------------------------------------------------------------------------------------------------
+# See 'https://github.com/linuxmint/nemo/blob/master/files/usr/share/nemo/actions/sample.nemo_action' for a sample of
+# Nemo action file with detailed comments.
+#-----------------------------------------------------------------------------------------------------------------------
+# NOTE on debugging:
+#
+# Run Nemo in debug mode using with NEMO_DEBUG set to include 'Actions', i.e.:
+#     $ nemo --quit
+#     $ NEMO_DEBUG=Actions nemo --debug
+#-----------------------------------------------------------------------------------------------------------------------
+
+# Whether this action is active.  For troubleshooting.
+Active=true
+
+# The name to show in the menu, locale supported with standard desktop spec.
+Name[en]=Display GPS position in 'Waze'
+Name[ru]=Показать GPS-позицию в сервисе 'Waze'
+
+# Tool tip, locale supported (Appears in the status bar)
+Comment[en]=Display GPS position for '%f' in 'Waze' online mapping service
+Comment[ru]=Показать GPS-позицию для файла '%f' в онлайн-сервисе 'Waze'
+
+# What to run.  Enclose in < > to run an executable that resides in the actions folder.
+Exec=<action_scripts/exif_metadata_mapping_waze.bash %F>
+
+# Icon name to use in the menu - must be a theme icon name
+Icon-Name=view-pin-symbolic
+
+# What type selection: [s]ingle, [m]ultiple, any, notnone, none (background click), or
+# a number representing how many files must be selected to display.
+Selection=s
+
+# What mime-types to display on - this is an array, end with a semicolon
+Mimetypes=image/jpeg;video/mp4;
+
+# Dependencies - program executables required for this action to work.
+# This is an array, separate entries with semi-colon, and terminate with a semicolon.
+#Dependencies=exiftool;
+
+# Conditions - semicolon-separated array of special conditions
+Conditions=exec <action_scripts/exif_metadata_mapping_waze.bash %F --condition>;
+
+# Run in terminal - set to true to execute the Exec line in a spawned terminal window.
+#Terminal=false