# Geolocatie

GPS (Global Positioning System) wordt overal in dit document gebruikt als een algemene term. Het betekent gewoon een locatie in het algemene sferische coördinatensysteem die op een kaart kan worden weergegeven. De werkelijke technische implementatie die de gegevens levert, kan zijn het Amerikaanse GPS, het Russische GLONAS, het Europese Galileo of een ander systeem.

Er zijn vier hulpmiddelen met betrekking tot geolocatie in &digikam-app; en twee in &showfoto;:

1. The Map mode of the Image Area which displays images with GPS data on a map depending on the selection on the Left Sidebar, ⪚ 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-app;.

2. De Kaartweergave in de linker zijbalk van &digikam-app;, die het zoekhulpmiddel is voor zoeken in afbeeldingen op hun GPS-gegevens. Dit is ook beschikbaar in &digikam-app;.

3. De geolocatiebewerker die we iets verderop beschrijven en die toegankelijk is via &Ctrl;&Shift;G Item Geolocatie bewerken... (Bestand Edit Geolocation... in &showfoto;).

4. Het tabblad Kaart in de rechter zijbalk toont de locatie van de afbeelding op een kaart en is puur informatief.

Alle vier zijn gebaseerd op het &marble; widget.

Deze hulpmiddelen werken alleen voor afbeeldingformaten die EXIF- of XMP-metagegevens bevatten ondersteunt door libkexiv2

## Bewerken van geolocatie

De geolocatiebewerker maakt het mogelijk om GPS coördinaten van metagegevens van afbeeldingen toe te voegen en te bewerken. Het geo-gegeven wordt opgeslagen in de afbeelding (EXIF tags) en de locatie kan getoond worden op een interne of externe kaart in een browser. De geolocatiebewerker biedt ook een hulpmiddel voor Omgekeerde geocodering.

De Geolocatiebewerker biedt de hulpmiddelen om afbeeldingen geografisch te lokaliseren in het gebruikelijke sferische coördinatensysteem (gebruikt door GPS/Galileo). Hoogte, breedte-, lengtegraad, snelheid, aantal satellieten, type reparatie en DOP zijn te bewerken.

De bewerker heeft twee methoden om afbeeldingen met coördinaten te markeren:

- Semi-automatische toekenning van coördinaten aan enkele afbeeldingen, toegankelijk via het tabblad Details in het rechter zijpaneel.

- Correlatie in bulk van GPS trackinggegevens met een serie afbeeldingen die u wilt vinden in het tabblad GPS-correlator

Verder biedt de rechter zijbalk nog drie hulpmiddelen:

- Het tabblad Ongedaan maken/opnieuw.

- Het tabblad Omgekeerde geocodering die in staat stelt om geografische namen te vinden (steden, straatnamen, ...) door een publieke service voor omgekeerde geocodering te gebruiken en de GPS-gegevens van een afbeelding.

- Het tabblad Zoeken die in staat stelt posities op de kaart te vinden van geografische namen (steden, monumenten, ...) door een service voor publieke geonamen te gebruiken (GeoNames en OpenStreetMap op het moment van schrijven).

### De kaart

Voor navigeren op de kaart zie het handboek van &marble;, Hoofdstuk 2. Ook voor het contextmenu sky zie de documentatie over &marble;.

Direct onder de kaart vindt u een rij knoppen. Ik zal de teksten in de tekstballonnen gebruiken als aanduidingen in de volgende beschrijving. Van links naar rechts hebben we

- De knop Kaartinstellingen opent een klein menu waarmee u kunt kiezen tussen Google Maps en &marble; en afhankelijk van die keuze het soort kaart dat u wilt gebruiken. Verder kunt u de projectie voor &marble; kiezen (sferisch, Mercator, gelijke rechthoeken) en u kunt een paar extra hulpmiddelen zoals kompas en schaal op de kaart tonen.

- De knop Inzoomen.

- De knop Uitzoomen.

- De knop Schakelaar-tussen-markeringen-en-miniaturen laat u kiezen of u de posities van uw afbeeldingen aangeeft door een markeringssymbool of door een miniatuur op de kaart. Als u miniaturen kiest dan zijn de volgende twee knoppen heel interessant.

- De knop De-miniatuurgrootte-op-de-kaart-vergroten doet gewoon dat en ...

- ... de knop Miniatuurgrootte-verkleinen-op-de-kaart ook.

- De knop Pan-modus laat u de kaart verschuiven door links klikken en ingedrukt houden en dan met de muis verslepen naar waar u het nodig heeft. Het cursorsymbool zal wijzigen naar een handje.

- De knop Zoomen-in-een-groep is nuttig als u afbeeldingen zo dicht op elkaar op de kaart dat alleen de bovenste zichtbaar is. Wanneer u klikt op de zichtbare afbeelding zal de zoomfactor aangepast worden zodat alle andere afbeeldingen erachter zichtbaar worden. Als u op een groep afbeeldingen klikt en er gebeurt echt niets dan hebben ze ofwel exact dezelfde geografische positie en/of de zoomfactor is al op zijn maximum.

  Merk op dat groep in deze context hier niets van doen heeft met de gegroepeerde afbeeldingen zoals beschreven in hoofdstuk 2 van het Handbook van &digikam-app;. Hier refereert de term naar afbeeldingen die zeer dicht bij elkaar liggen op de kaart (afhankelijk van de zoomfactor) of exact dezelfde geografische positie hebben.

- 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.

- De knop Bladwijzerposities-op-de-kaart-tonen werkt niet op het moment van schrijven omdat het gehele probleem van bladwijzer gereorganiseerd moet worden. Dit heeft ook effect op het item Bladwijzers Bladwijzers bewerken... in het contextmenu op de lijst met afbeeldingen onder de kaart en het item Bladwijzer toevoegen in het contextmenu op de kaart.

Het gebruik van Bladwijzer toevoegen in het contextmenu op de kaart kan leiden tot verlies van uw bladwijzers in &marble;!

Van het contextmenu op de kaart is alleen Coördinaten kopiëren van belang voor geo-tags. Het kopieert de geografische coördinaten op de cursorpositie naar het klembord. Voor alle andere menu-items zie het handboek van &marble;.

Merk op dat u de indeling van één kaart naar twee kaarten kunt wijzigen, naast of boven elkaar via het kleine afrolmenu onderaan de Geolocatiebewerker.

### Coördinaten bewerken

De coördinaten kunnen handmatig ingesteld worden in het tabblad Details (zie bovenstaande schermafdruk). De locatie is te vinden en iteratief vast te leggen met de getoonde kaart. Verplaats de muiscursor naar het van belang zijnde gebied, zoom in, pas de locatie aan, zoom opnieuw in enzovoort totdat voldoende nauwkeurigheid is bereikt. Merk op dat het centrum voor zoomen zich altijd op de cursorpositie bevindt. Klik uiteindelijk rechts op de gewenste positie en kies Coördinaten kopiëren. U kunt dan naar de lijst met afbeeldingen onder de kaart gaan en een of meer afbeeldingen selecteren, klik rechts op ze en kies Coördinaten plakken. De coördinaten zullen dan getoond worden in de velden Breedtegraad en Lengtegraad rechts van de kaart. Om uw wijzigingen op te slaan klikt u op de knop Toepassen rechts onder het veld DOP.

Als u een of meer afbeeldingen hebt die al GPS gegevens bezitten, dan kunt u de coördinaten van een van deze kopiëren en ze plakken op een of meer andere afbeeldingen door de respectievelijke items uit het contextmenu op de lijst mat afbeeldingen te gebruiken. Dit wordt handig als er een serie foto's genomen is op dezelfde locatie.

Rechts van de kaart zijn er naast breedte- en lengtegraad, velden voor hoogte, snelheid, aantal satellieten, type reparatie en onzekerheid (DOP). U kunt deze velden al ingevuld zinen als u een foto selecteert waar uw camera deze informatie al in de EXIF gegevens heeft geschreven. Anders kunt u ze handmatig invullen als u deze gegevens ergens anders vandaan hebt, ⪚ een aparte GPS ontvanger. Merk op dat u het relevante keuzevakje moet activeren voordat u een veld kan bewerken (onder &Windows; moet u mogelijk dubbelklikken). Alleen voor Hoogte is deze toegekend aan de foto door het item Ontbrekende waarden van hoogte uit het contextmenu op de lijst met afbeeldingen, die er voor zorgt dat de bewerker dit gegeven uit de kaartgegevens, gegeven de positie (breedte- en lengtegraad), haalt.

Om geolocatiegegevens te verwijderen moet u het relevante keuzevakje deactiveren en op de knop Toepassen drukken recht onder het veld DOP. Anders dan dat biedt het contextmenu op de lijst met afbeeldingen items om enige van de gegevens uit de afbeelding te verwijderen. Met betrekking tot het laatste item Bladwijzers kijk hier.

### De correlator

Om uw afbeeldingen te correleren met geografische gegevens moet u GPS trackinginformatie beschikbaar hebben als een XML-bestand in `gpx` formaat (gpsbabel en gpsman kan trackinggegevens downloaden en converteren uit een GPS apparaat voor u). Het idee is: bij het nemen van uw foto's houdt u een GPS apparaat actief en draagt u het samen met de camera. Nadat u klaar bent, downloadt u de foto's en de GPS tracks en activeert u de correlator.

Selecteer de afbeeldingen die u wilt correleren in de hoofdweergave van de toepassing, roep daarna de geolocatiebewerker op met &Ctrl;&Shift;G en schakel om naar het tabblad GPS correlator in de rechter zijbalk. De bovenstaande dialoog zal verschijnen met de geselecteerde afbeeldingen in de lijst onder de kaart. Om een mogelijke correlatie tussen tijden/locatie aan te geven moet u een trackbestand laden met GPX bestand laden die GPS gegevens bevat genomen op dezelfde tijd en locatie als de afbeeldingen.

When the file is loaded and Show tracks on map is checked the track is displayed on the map. You can load more than one file and &digikam; will assign different colors to them and display the tracks on the map accordingly.

GPS track data is invariably recorded in UTC (Universal Time Coordinated), so you need to match the camera time with UTC, which can be done with Camera time zone:. Select Same as system if you took the photographs in your home time zone and &digikam; will figure out the difference to UTC from your system time. If you took the photographs somewhere else you got to check Manual: and choose the appropriate difference from the drop-down field to the right. You can use the same mechanism as well to correct a simple mis-adjustment of your camera time for whatever reasons or an offset of a gpx-file due to quirks of a software used to convert other track file formats into gpx. Here comes Fine offset (mm:ss) into play where you can add or subtract up to 59 minutes and 59 seconds to your time difference chosen in the field above.

The Max. time gap (sec.): setting specifies the limit within which GPS time and camera time shall be deemed coincident. The maximum value is 2000 seconds. This means that if no entry in the gpx-file matches the time stamp of the photograph exactly, the position of the entry with the smallest time gap to the photograph will become assigned to it as long as this time gap is smaller than the Max. time gap (sec.): setting. If you wonder which value you should specify here a look into the settings of your track recording device/software or into the gpx-file (which is easily possible with a text editor) might help. The faster you were moving while taking the photograph(s) the more important this decision will be.

Interpolate offers another option in case there is no exact match between the time stamp of your photograph(s) and an entry in the gpx-file and as long as you were moving more or less straight between two recorded GPS positions it will be the more precise option. Here the position of the photograph is calculated (linear interpolated) from the positions of the two closest entries in the gpx-file and the respective differences in time. If, for instance, the time gaps between the two closest entries and the photograph are equal the position assigned will be on a straight line between the positions of the two entries right in the middle.

Max. interpol. time gap (min): has nothing to do with policeman Max from Interpol ;-) Instead it determines whether a GPS point is eligible for interpolation. If its time is farther away from the picture time than this limit, it cannot be used. 240 minutes is the maximum time difference that can be introduced here.

Once your settings are done you click on the Correlate button. If there is no match at all you will get the message "Could not correlate any image - please make sure the timezone and gap settings are correct." Otherwise you will get something like "2 out of 4 images have been correlated. Please check the timezone and gap settings if you think that more images should have been correlated." Best case you get "All images have been correlated. You can now check their position on the map."

If you want to follow this recommendation it is a good idea to change to the Details tab since there you have a preview of the images which can help a lot to identify them on the map. Remember that you always have to click on an image in the list under the map to make its preview show up. Once you are satisfied with the results click the Apply button at the bottom of the Geolocation Editor to save the changes to the image file and the database.

### Ongedaan maken/opnieuw

In the Undo/Redo tab a history is being recorded about all the changes you apply to the images loaded into the Geolocation Editor. The history shows changes made in only one tab or in several tabs and will be deleted only once you leave the editor. After a few actions in the different tabs the record might look like this:

The last step is highlighted when you enter the tab. The first step is always labeled empty and represents the status the images had when they were loaded. You can click on every step and, depending on what kind of changes you did, you might see the images appearing, disappearing or moving on the map or see the differences in the list of images under the map. Note that the list is configurable by right-clicking on the header.

Now let's assume that you realize that the move in the last step was wrong. You just click on the step before (Details changed), you go to the Search tab (described further below) and you do another move. After returning to the Undo/Redo tab it might look like this:

### Omgekeerde geocodering

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-app; handbook.

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 ...

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 right-click a tag, preferable the one you created for the geo tags, you will see this context menu:

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:

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.

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:

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.

### Zoeken

In the Search tab you can look up places by their geographic names using public geoname services (GeoNames and OpenStreetMap at the time of writing). You just type in a name of a place (city, monument, hotel, ...) into the input field at the top and click Search. In the result list below you will get something like this:

Obviously Paris does not only exist in France. So if you were looking for the capital of France you can either scroll down the list until you find an entry that undoubtedly belongs to there like "Arc de Triomphe" and click on it or specify your search a little bit more precise like "Paris, Arc de Triomphe" or "Paris, France". Once you click on an entry in the list the map will become centered to that place and you can now zoom in with the zoom-in button (second from the left below the map). Using this example with GeoNames you will notice that you still get a lot of results and even two labeled only "Arc de Triomphe", the second one a street a few hundred meters away from the arch. With OSM you get only one result. You got to play a bit with the different services in different regions, with more or less precise search terms and then you will get an idea about how to best conduct your searches.

For the buttons right above the result list refer to their tooltips! The context menu on search result entries offers

- Copy coordinates which you can paste later to one or more images in the image list under the map

- Move selected images to this position which is basically the same but more straightforward provided you have the images already loaded into the geolocation editor

- Remove from results list which is particular useful in conjunction with the Keep-the-results-of-old-searches-... button above the results list.