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

0001 .. meta::
0002    :description: digiKam Geolocation Editor Reverse Geocoding
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, geolocation, reverse, geocoding
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_reverse:
0012 
0013 Reverse Geocoding
0014 =================
0015 
0016 .. contents::
0017 
0018 In this tab you can use a public geoname service to look up address details of the geographic position of one or more images and convert them into tags. In order to do that you need a few preparations. You should be already familiar with the idea of tags and how to create, edit and use them. The best entry into this issue you find in the Tags View section of Chapter 2 of the digiKam handbook.
0019 
0020 First you should create a root tag in the Tag Manager or in the tag tree of the Left or Right Sidebar. You might name it Location or Places or ...
0021 
0022 Then you select the image(s) you want to tag (they need to have GPS data assigned), open the Geolocation Editor and click the **Reverse Geocoding** tab. You will see your tag tree and if you click with the right mouse button over a tag, preferable the one you created for the geo tags, you will see this context menu:
0023 
0024 .. figure:: images/geoeditor_reverse1.webp
0025     :alt:
0026     :align: center
0027 
0028     The digiKam Geolocation Editor Reverse Geocoding Context Menu
0029 
0030 In the main section the tags you can add are sorted from the largest region (country) down to the smallest (house number). If you choose **Add All Address Elements** and then fold out the Location tag and all the sub-tags you will have this:
0031 
0032 .. figure:: images/geoeditor_reverse2.webp
0033     :alt:
0034     :align: center
0035 
0036     The digiKam Geolocation Editor Reverse Geocoding Tags Hierarchy To Populate
0037 
0038 These red tags in curly brackets are called control tags. They determine which address elements you want the reverse geolocation service you have chosen at the top under **Select Service** to look for. You can still delete some of them with the help of the context menu if you feel that you don't need them or modify the structure by deleting some control tags and add them in other places of the tree or even build a new tree parallel to the first by adding a control tag to the root tag (here: Location). Arranging the control tags on the same level instead of a tree structure can save a lot of redundant tags since the same city or town name exists in more than one state or country let alone street names. But it can make the whole location branch of your tag tree quite long and therefore incalculable. This is to say that you have to find your own solution to this problem depending on your needs, maybe a mix, and the sooner you find it the less work you have to invest in editing your tag tree and the control tags.
0039 
0040 Let us assume you use the control tags as shown in the above screenshot, select the images you want to tag from the list of images to the left and click **Apply Reverse Geocoding**. Then the tag tree might look similar to this:
0041 
0042 .. figure:: images/geoeditor_reverse3.webp
0043     :alt:
0044     :align: center
0045 
0046     The digiKam Geolocation Editor Reverse Geocoding Tags Hierarchy Populated
0047 
0048 The green tags represent the search result of the selected public reverse geocoding service and are already assigned to the image(s). To save these tags to the image file and the digiKam database click **Apply**. The tags will appear as regular tags in your tag tree which you can see already here or in the tag tree of the Left or Right Sidebar. Of course you can still edit them like any other tag in the Tag Manager or in the Left or Right Sidebar, but not here in the Geolocation Editor.