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
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_overview:
0013 Overview
0014 ========
0016 .. contents::
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.
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.
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.
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.
0026 There are four tools regarding geolocation in digiKam and two in Showfoto:
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.
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.
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).
0034     - The Map tab on the Right Sidebar which shows the location of the image on a map and is purely informative.
0036 .. figure:: images/geoeditor_main_view.webp
0037     :alt:
0038     :align: center
0040     The digiKam Geolocation Editor Main Dialog
0042 .. note::
0044     These tools work for image formats that have Exif or XMP metadata supports or with items using sidecar file.