Search on geo-position

[geeqie.git] / doc / docbook / GuideImageSearchSearch.xml

diff --git a/doc/docbook/GuideImageSearchSearch.xml b/doc/docbook/GuideImageSearchSearch.xml
index ed5a89e..f1719ea 100644 (file)
--- a/doc/docbook/GuideImageSearchSearch.xml
+++ b/doc/docbook/GuideImageSearchSearch.xml
@@ -101,7 +101,11 @@
               </guiicon>\r
             </guibutton>\r
           </code>\r
-          button displays a pop up calendar to enter the date\r
+          button displays a pop up calendar to enter the date.\r
+          <para />\r
+          The\r
+          <emphasis role="strong">Exif date</emphasis>\r
+          checkbox permits searches to be made on the exif date of images. If an image does not have an exif date, it will default to 01 January 1970.\r
         </listitem>\r
       </varlistentry>\r
       <varlistentry>\r
@@ -132,6 +136,31 @@
         </term>\r
         <listitem>The search will match if the file's associated keywords match all, match any, or exclude the entered keywords, depending on the method selected from the drop down menu. Keywords can be separated with a space, comma, or tab character.</listitem>\r
       </varlistentry>\r
+      <varlistentry>\r
+        <term>\r
+          <guilabel>Geocoded position</guilabel>\r
+        </term>\r
+        <listitem>\r
+          The search will match if the file's GPS position is less than or greater than the selected distance from the specified position, or is not geocoded, depending on the method selected from the drop down menu.\r
+          The search location can be specified by\r
+          <itemizedlist>\r
+            <listitem>\r
+              Type in a latitude/longitude in the format\r
+              <code>89.123 179.123</code>\r
+            </listitem>\r
+            <listitem>Drag-and-drop a geocoded image onto the search box</listitem>\r
+            <listitem>If Geeqie's map is displayed, a left-click on the map will store the latitude/longitude under the mouse cursor into the clipboard. It can then be pasted into the search box.</listitem>\r
+            <listitem>Copy-and-paste (in some circumstances drag-and-drop) the result of an Internet search.</listitem>\r
+          </itemizedlist>\r
+          <note>\r
+            In this last case, the result of a search may contain the latitude/longitude embedded in the URL. This may be automatically decoded with the help of an external file:-\r
+            <programlisting xml:space="preserve">~/.config/geeqie/geocode-parameters.awk</programlisting>\r
+            See\r
+            <link linkend="GuideReferenceDecodeLatLong">Decoding Latitude and Longitude</link>\r
+            for details on how to create this file.\r
+          </note>\r
+        </listitem>\r
+      </varlistentry>\r
     </variablelist>\r
     <para />\r
     <para />\r
@@ -210,4 +239,4 @@
     <para>Drag and drop can be initiated with the primary or middle mouse buttons. Dragging a file that is selected will include all selected files in the drag. Dragging a file that is not selected will first change the selection to the dragged file, and clear the previous selection.</para>\r
     <para />\r
   </section>\r
-</section>
+</section>\r