Warning, /documentation/digikam-doc/geolocation_editor/geoeditor_map.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: digiKam Geolocation Editor Map
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, gps, geolocation, map, world, group, reverse, geocoding
0005 .. metadata-placeholder
0007    :authors: - digiKam Team
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0011 .. _geoeditor_map:
0013 Geolocation Map
0014 ===============
0016 .. contents::
0018 The Map Utils
0019 -------------
0021 The Geolocation Editor allows for adding and editing GPS coordinates of picture metadata. The geo-data is stored into the image (Exif tags) and the location can be displayed in an internal or external browser map. The Geolocation Editor also offers a :ref:`Reverse Geocoding <geoeditor_reverse>` tool.
0023 Geolocation Editor can be opened via menu entry :menuselection:`Item --> Edit Geolocation` or via pressing :kbd:`Ctrl+Shift+G`. It requires at least one image to be selected otherwise it will not open.
0025 .. figure:: images/geoeditor_edit_coordinates.webp
0026     :alt:
0027     :align: center
0029     The digiKam Geolocation Tool Used to Edit Item Coordinates Using OpenStreeMap
0031 The Geolocation Editor provides the tools to localize pictures geographically in the common spherical coordinate system (used by GPS/Galileo). **Altitude**, **Latitude**, **Longitude**, **Speed**, **Number of Satellites**, **Fix Type**, and **DOP** are editable.
0033 The editor has two methods to mark the pictures with coordinates:
0035     - Semi-automatic coordinate attribution to single pictures, accessible via the **Details** tab on the Right Sidebar.
0037     - Batch correlation of GPS tracking data with a series of images you will find in the :ref:`GPS Correlator <gps_correlator>` tab.
0039 Furthermore the Right Sidebar offers three more tools:
0041     - The **Undo/Redo** tab.
0043     - The **Reverse Geocoding** tab which allows to find geographic names (cities, street names, ...) by using a public reverse geocoding service and the GPS data of an image.
0045     - The **Search** tab which allows to find positions on the map from geographic names (cities, monuments, ...) by using a public geoname service (GeoNames and OpenStreetMap at the time of writing).
0047 The Map View
0048 ------------
0050 For navigating on the map, refer to the :ref:`Map Search section <mapsearch_view>`.
0052 Right under the map you find a row of buttons. I shall use the tooltip texts as designations in the following description. From left to right we have:
0054     - The Map-settings button opens a small menu which allows you to choose between OpenStreeMap and Off-line Maps, and depending on that choice to choose the kind of map you want to use. Furthermore you can select the projection (**Spherical**, **Mercator**, **Equi-Rectangular**) and you can display a few additional tools like compass and scale on the map.
0056     - The **Zoom In** button.
0058     - The **Zoom Out** button.
0060     - The **Switch Between Markers And Thumbnails** button lets you choose whether you want the positions of your images indicated by a marker symbol or by a thumbnail on the map. If you choose thumbnails the next two buttons are of particular interest.
0062     .. note::
0064         The Markers color over the map depends of the number of items grouped at a location, and it depends of the zoom level. Colors available are listed below:
0066         =========== =======================
0067         Color       Number of Grouped Items
0068         =========== =======================
0069         Cyan        1
0070         Green       2
0071         Yellow      10
0072         Orange      50
0073         Red         100
0074         =========== =======================
0076     - The **Increase The Thumbnail Size On The Map** button is doing just that and the **Decrease The Thumbnail Size On The Map button** as well.
0078     - The **Pan Mode** button lets you move the map by click with the left mouse button and holding on it and then drag it with the mouse to where you need it. The cursor symbol will change to a hand.
0080     - The **Zoom Into A Group** button is useful if you have images so close to each other on the map that all but the topmost are obscured. Once you click on the visible image the zoom factor will be adjusted so that all the other images behind it become visible. If you click on a group of images and nothing really happens they either have exactly the same geographic position and/or the zoom factor is already at its maximum.
0082     .. note::
0084         **Group** in this context here *has nothing to do* with grouped images as described in :ref:`this chapter from the manual <grouping_photograph>`. Here the term refers to images which are very close to each other on the map (depending on the zoom factor) or have exactly the same geographic position.
0086     - The **Select Images** button toggles the selection of an image or a group of images in the list of images right below the buttons once you click on it on the map. The selection status of all other images in the list remain unchanged. Be aware of the fact that there is a kind of two-stage selection! If you click on a thumbnail or marker on the map the selected image(s) in the list of images will become a light blue background. If you click on it in the list the background will become a darker blue and if there where more than one image with light blue background before the others will become un-selected. Only clicking on an image in the list will let its preview appear to the right of the list.
0088     - The **Display Bookmarked Positions On The Map** button can be used to display on the map the places already registered in the :ref:`Bookmarks Manager <geoeditor_bookmarks>`.
0090 From the context menu on the map only Copy Coordinates is of interest for geotagging. It copies the geographic coordinates at the cursor position to the clipboard. For all other menu items see Marble handbook.
0092 Note that you can change the layout from one map to two maps, beside or above each other via the little drop-down menu at the bottom of the Geolocation Editor.
0094 .. _geoeditor_bookmarks:
0096 The Bookmarks Manager
0097 ---------------------
0099 The digiKam geolocation **Bookmarks Manager** is a tool to register a nested list of favorite places which can be re-used later to geolocalize items taken at the same positions.
0101 The digiKam Bookmarks Manager is available from the items list context menu as you can see to the screenshot below.
0103 .. figure:: images/geoeditor_bookmark_menu.webp
0104     :alt:
0105     :align: center
0107     The digiKam Geolocation Bookmarks Manager Available From The Items List Context Menu
0109 From this menu you can:
0111     - **Add Bookmark**: if the current selected item from list has GPS information, these ones can be registered to the manager with this option. A dialog to populate the bookmark properties must appears.
0113     .. figure:: images/geoeditor_bookmark_add.webp
0114         :alt:
0115         :align: center
0117         The digiKam Geolocation Bookmarks Manager Dialog To Register A New Entry
0119     You can customize the name, a comment to describe the location, and the place in the bookmarks hierarchy
0121     - **Edit Bookmarks**: this will show you a dialog with the complete hierarchy of bookmarks managed. You can change item properties, the place in hierarchy using drag and drop, and display the corresponding location on a map from the right side. In the Hierarchy you can append new branches using **Add Folder** button. The **Remove** button allows you to delete an item in the hierarchy.
0123     .. figure:: images/geoeditor_bookmark_edit.webp
0124         :alt:
0125         :align: center
0127         The digiKam Geolocation Bookmarks Editor Dialog
0129     - Access quickly to the bookmarks hierarchy to assign a location to the current selected item.
0131 .. important::
0133     The **Map View** provide also a **Add Bookmark** option in the context menu available over the map. This feature do not come from digiKam and works independently of the digiKam **Bookmarks Manager** feature.