digikam-doc/geolocation_editor/geoeditor_kmlexport.rst

0001 .. meta::
0002    :description: digiKam Geolocation Editor KML Export Tool
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, location, kml, export
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_kmlexport:
0012
0013 KML Export Tool
0014 ===============
0015
0016 .. contents::
0017
0018 `KML <https://en.wikipedia.org/wiki/Keyhole_Markup_Language>`_ for **Keyhole Markup Language** is an XML notation for expressing geographic annotation and visualization within two-dimensional maps and three-dimensional Earth browsers. KML was developed for use with Google Earth but Open Source Applications can also use this kind of container. KML is an open standard from the `Open Geospatial Consortium <https://en.wikipedia.org/wiki/Open_Geospatial_Consortium>`_.
0019
0020 .. figure:: images/geoeditor_kml_export.webp
0021     :alt:
0022     :align: center
0023
0024     The digiKam Geolocation Editor Exporting GPS Info Into A KML Container
0025
0026 From the right sidebar tab **KML Export** several settings are available to process the list of items loaded in Geolocation Editor, in goal to generate a target as KML container.
0027
0028     - **Target Type**: two kind of container can be generated, one for a local application as Google Earth running on your computer, or another one for a Web Application as Google Maps.
0029
0030     - **Picture Altitude**: configure how the altitude of items to process must be interpreted, as **Clamp To The Ground**, **Relative To Ground**, or in **Absolute**.
0031
0032     - **Destination Directory**: configure the folder from your computer where you want to store the KML container.
0033
0034     - **Destination Path**: configure the url where you want to store the KML container. This option is enabled only if the Target Type is a Web Application.
0035
0036     - **Filename**: the name used to record the KML container.
0037
0038     - **Icon Size**: The icon dimensions registered in KML container and used by KML viewer application to thumbnails on the map.
0039
0040     - **Image Size**: The image dimensions registered in KML container and used by KML viewer application to render contents on the map.
0041
0042     - **Draw GPX Track**: enable this option to include information from a GPX trace in your KML container.
0043
0044     - **GPX File**: the path from your computer to the GPX trace.
0045
0046     - **Time Zone**: the world time zone used to record the GPX trace.
0047
0048     - **Track Width**: the number of items to handle from the GPX trace.
0049
0050     - **Track Color**: the color to use over the map to render the GPX trace.
0051
0052     - **Opacity**: the transparency in percents to render the GPX trace over the map.
0053
0054     - **Track Altitude**: configure how the altitude of GPX trace items must be interpreted, as **Clamp To The Ground**, **Relative To Ground**, or in **Absolute**.
0055
0056 Press **Generate KML File** button to render the container. If errors occurs, a resume dialog must appear with the list of problems. Finally, the exported KML container can be open in a Viewer as in the screenshot below.
0057
0058 .. figure:: images/geoeditor_kml_viewer.webp
0059     :alt:
0060     :align: center
0061
0062     The `Open Source Marble Application <https://marble.kde.org/>`_ Importing A KML Container Generated From digiKam