\hypertarget{elementary_main_intro}{}\section{Introduction}\label{elementary_main_intro}
Elocation is meant as a convenience library to ease application developers the usage of geo information in their apps. Adding a geo tag to a picture or translating an address to a G\+PS position and show it on a map widget are just some of the use cases.

In the beginning elocation will rely on the Geo\+Clue D\+Bus service. Its has providers for various techniques to get hold off the current position. Ranging from Geo\+IP over wifi and G\+SM cell location to G\+PS. As well as provider to translates between location in a textual form to coordinates (Geo\+Code).

Elocation covers all of these interfaces but in the end it depends on your system and the installed Geo\+Clue providers what can be used.

Currently it offer the following functionality\+: \begin{DoxyItemize}
\item Request current address in textual form \item Request current position in G\+PS format \item Translate a position into and address or an address in a position\end{DoxyItemize}
You can find the A\+PI documentation at \mbox{\hyperlink{group__Location}{Location}} 