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

0001 .. meta::
0002    :description: Overview to digiKam Geolocation Editor
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, gps, geolocation, editor, coordinates
0004 
0005 .. metadata-placeholder
0006 
0007    :authors: - digiKam Team
0008 
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0010 
0011 .. _geoeditor_overview:
0012 
0013 Overview
0014 ========
0015 
0016 .. contents::
0017 
0018 Geolocation means assigning, editing and using metadata which describe the geographic place where images or videos were taken. The source of these metadata can be your camera, a separate GPS receiver or other means of geographical information, in particular maps.
0019 
0020 Not only for professional photographers can it be interesting to link an image to a precise geographical location. Not everybody uses an airplane to overfly and scan a certain area with automatic GPS data recording. Environmental planners, military, police, construction bureaus, real estate agencies, all will have an immediate application.
0021 
0022 But if, after some time, one has forgotten where the image was taken, if one loves the nice feature to open with a simple click a browser displaying a zoom of the area, if you like to send your image as a postcard to another digiKam user (who is then able to locate your shot), or if you simply need the documentation aspect of it - having position data stored in a photo is great.
0023 
0024 GPS (global positioning system) is used as a generic term throughout this document. It just means a location in the common spherical coordinate system that can be displayed on a map. The actual technical implementation that provides the data can be the American GPS, the Russian GLONAS, the European GALILEO or any other system.
0025 
0026 There are four tools regarding geolocation in digiKam and two in Showfoto:
0027 
0028     - The Map mode of the Image Area which displays images with GPS data on a map depending on the selection on the Left Sidebar, e.g. the images in the album you selected in the Album View, the images with a certain tag assigned (selected in the Tag View), with a certain label and so on. This is only available in digiKam.
0029 
0030     - The Map View on the Left Sidebar of digiKam which is the search tool for finding images by their GPS data. This is also only available in digiKam.
0031 
0032     - The Geolocation Editor we describe a little bit further below and which is accessible via :menuselection:`Item --> Edit Geolocation...` :kbd:`(Ctrl+Shift+G)` (:menuselection:`File --> Edit Geolocation...` in Showfoto).
0033 
0034     - The Map tab on the Right Sidebar which shows the location of the image on a map and is purely informative.
0035 
0036 .. figure:: images/geoeditor_main_view.webp
0037     :alt:
0038     :align: center
0039 
0040     The digiKam Geolocation Editor Main Dialog
0041 
0042 .. note::
0043 
0044     These tools work for image formats that have Exif or XMP metadata supports or with items using sidecar file.