gMapping is a simple map browser using the embedded Google Maps API.
Open gMappng to enable mapping features from the Linux desktop providing satellite, road-map, and zoom features. Options to save or copy and retrieve maps with locations, map type and zoom levels.
- Please review "Common System Requirements" and "Critical System Requirements" sections below for basic and critical requirements to run this script successfully.
- Save the gMapping.sh file to a directory.
- Make the gMapping.sh script executable by running the following command in the same directory as the gMapping.sh file:
chmod +x gMapping.sh
- Mapping by address.
- Mapping by location.
- Mapping by Zip/Postal area.
- Mapping by City/Town area.
- Mapping by County/Province area.
- Mapping by Coordinates.
- Save map links for future use.
- Copy saved map links.
- Export saved map links.
- Customize map window by size and position.
- Theme options for system default or custom.
- Use the 'F1' key for documentation from any main window.
When running mRunner the main menu will appear showing options for different ways of creating a map. Choosing a option will bring another menu asking for mapping details including map type and zoom level. Click on the “Map” button to have a Google embedded map appear based on the criteria you have provided.
Each of the menus options when clicked will open a new menu pertaining to the option. For instance as one chooses, "Address", options for locating map features regarding a address will appear. As you choose "City/Town" options for mapping a city or town will be listed. For each option listed, a button for "Save" is listed in the menu. This allows you to save the current view and link to the map for future use. Using the "Saved" button on the main menu will load all saved links for review with further options.
When viewing a menu for the selected map option open, the close button closes the current menu and brings you back to the main menu. When selecting "Exit" from the main menu, all windows of the script will close and gMapping will exit.
Mapping by address is as easy as it sounds:
- After selecting to map by "Address", the Address menu will appear.
- Add the address into the "Address" field.
- Select the option for "Type" and select to view the map in either "Road" or "Satellite" view.
- Select the option for "Zoom" and choose the level of zoom required.
- Click on the button "Map" to open the map using your address input and map selections.
- If needed for future reference, click on the button "Save" button in order to save the current mapping view into the saved listing. This saved link will recall your selections for map type and zoom levels as well as the address.
- After clicking on the "Map" button with your input, the embedded google map will appear for use.
- When viewing the google embedded map, options available will allow you to zoom in or out, select either a road map or satellite view, as well as choosing to view a large map.
- Clicking on the "Close" button in the menu will bring you back to the main menu for all selections.
Each of the options for mapping from the main menu operate in the same way but ask for different input pending on the option selected. Main menu options are described below.
- Address: Map by address. Example: 945 Park Villa Place, Escondido, CA, 92025.
- Location: Map by location. Example: Coronado Bridge, San Diego CA.
- Zip/Postal: Map by zip code or postal code. Example: 59801
Hint: Select zoom level between 8 and 13 in order to show outline of zip code or postal code.
- City/Town: Map by name of city or town. Example: Missoula
Hint: Select zoom level between 8 and 13 in order to show outline of city or town.
- County/Province: Map by County or Province. Example: North County
- Coordinates: Map by Longitude and Latitude. This will pin point your map to a particular location.
- Saved: View saved map links, load a saved map with a double click on the option listed. Details for viewing saved map links are listed below.
- Options: Options will allow you to select a theme for gMapping, as well as changing the map position and size. More information for Options are listed below under "Theme Options" and "Map Position".
- Exit: Closes all menus and windows related to the gMapping script.
Each mapping menu has a option for “Save” which allows the user to save the mapping link for future use. The main menu has the option “Saved” that displays all saved maps and provides the following options:
- Double Click: To load a saved map link, double click on the item listed. This will open the map using the same details for location, map type and zoom level as when saved.
- Selected Detail: This option will show you the details of the highlighted link. The “Detail” window will show you all items of the selected link in detail with options to copy the mapping link or all details of the link.
- Clear List: Clears the “Saved Maps” window of all saved map links.
- Open List: Opens the list into a default text editor.
- Close: Closes the “Saved Maps” window.
The "Options" main menu option allows the user to change settings for the theme being used, map window size and locaton, as well as access to "Help" and "About" options.
When viewing the "Theme" option, the following options are available:
- Load Theme: Allows the user to browse their system for a theme to use.
- Apply Loaded Theme: Applies the loaded theme. Once selected the Options window will close and re-open showing the theme selected in use.
- Mode: Select basic system theme available in the system for "Light Theme" or "Dark Theme". This default uses the "Breeze" theme package located in the "/usr/share/themes/" folder.
- Apply System Theme: Applies the Mode selected for either "Light Theme" or "Dark Theme". Once selected the Options window will close and re-open showing the theme selected in use.
- Browse Themes Folder: Browse the default themes folder "/usr/share/themes/".
- Help: Opens gMapping help documentation.
- About: Opens the about window showing script credits.
- Close: Closes the "Options" window.
This screen contains options to adjust the positioning and size of the mapping window:
- Window Width: Adjust the mapping window width by pixels.
- Window Height: Adjust the mapping window height by pixels.
- Window From Top: Adjust mapping window position from the top of the screen in pixels.
- Window From Left: Adjust mapping window position from the left of the screen in pixels.
Click on the "Save" button to save your changes or select "Cancel" to not save changes and close the settings window.
- Help: Opens gMapping help documentation.
- About: Opens the about window showing script credits.
- gMapping can be ran from any directory.
- gMapping uses the "/tmp/" folder for temporary and .ini files.
- A map location no found will default to the world map.
- Map links extracted will only work within a "FRAME" html element.
Save the following as a file named "gMapping.desktop" in creating a shortcut to this utility. Update the path for "Exec" to where the script is stored.
[Desktop Entry]
Name=gMapping
GenericName=gMapping
Comment=gMapping is a simple map browser using the embedded Google Maps API.
Exec=/PathToScript/gMapping.sh
Type=Application
Icon=text-html
Terminal=false
Common shell commands found in most Linux installations are used to provide system functionalilty for this and other scripts shared from this profile. For thoroughness, these common shell commands are listed in alphabetical order with version and man page link for review: https://github.com/rweckert/gMapping/blob/97f80f847c136989abb1cbba8f3bc787ae7739bd/README-Basic-Requirements.md
Packages listed below provide the core ingredients for graphic display and desired output that enables gMapping to deliver output and are critical for successful execution of the the script:
| Package | Version | Notes |
|---|---|---|
| yad | 14.0+ (GTK+ 3.24.41) | A tool for developing graphical user interfaces in Linux and is used by this script to generate menus and dialog windows, is written by Victor Ananjevsky. Download: https://github.com/v1cont/yad Setup: Step by step instructions are available for either Linux or Microsoft Windows Subsystem for Linux (WSL) using a Debian base: https://github.com/rweckert/yad-14.0-Setup-From-Scratch |
Script interface written by: Robert W. Eckert - rweckert@gmail.com Please feel free to email to submit bugs, changes or requests. This script comes with absolutely no warranty. See the link for the GNU General Public License, version 3 or later listed below for further details.
Project Page:
https://github.com/rweckert/gMapping
Source File:
https://github.com/rweckert/gMapping/blob/fbf31d0c4a3ea1d8de893b029127d02b7bf42163/gMapping.sh
Documentation File:
https://github.com/rweckert/gMapping/blob/fbf31d0c4a3ea1d8de893b029127d02b7bf42163/README.md
Project Screenshot:
https://github.com/rweckert/gMapping/blob/fbf31d0c4a3ea1d8de893b029127d02b7bf42163/screenshot-gMapping.jpg
Project License:
https://github.com/rweckert/gMapping/blob/97f80f847c136989abb1cbba8f3bc787ae7739bd/LICENSE
GitHub Profile Page:
https://github.com/rweckert
