\hypertarget{group__Location}{}\section{Location}
\label{group__Location}\index{Location@{Location}}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef struct \hyperlink{struct__Elocation__Accuracy}{\+\_\+\+Elocation\+\_\+\+Accuracy} \hyperlink{group__Location_ga39a951ab9c8a02f3358d866a50aad425}{Elocation\+\_\+\+Accuracy}
\item 
typedef struct \hyperlink{struct__Elocation__Address}{\+\_\+\+Elocation\+\_\+\+Address} \hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address}
\item 
typedef struct \hyperlink{struct__Elocation__Position}{\+\_\+\+Elocation\+\_\+\+Position} \hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position}
\item 
typedef struct \hyperlink{struct__Elocation__Velocity}{\+\_\+\+Elocation\+\_\+\+Velocity} \hyperlink{group__Location_ga70a0c8f4a2438b304023833bb07d3e7e}{Elocation\+\_\+\+Velocity}
\item 
typedef struct \hyperlink{struct__Elocation__Requirements}{\+\_\+\+Elocation\+\_\+\+Requirements} \hyperlink{group__Location_ga3af1c05f084d92d326c6194d3ce0e24b}{Elocation\+\_\+\+Requirements}
\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address} $\ast$ \hyperlink{group__Location_ga748b789c18ab4bbac9030cd1308a70a5}{elocation\+\_\+address\+\_\+new} (void)
\begin{DoxyCompactList}\small\item\em Create a new address object to operate on. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} void \hyperlink{group__Location_gafd4ff166c408ef5f581ed3a3eb007625}{elocation\+\_\+address\+\_\+free} (\hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address} $\ast$address)
\begin{DoxyCompactList}\small\item\em Free an address object. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$ \hyperlink{group__Location_gab08afeffaf64ecec9d3bc7cfd9a8ca09}{elocation\+\_\+position\+\_\+new} (void)
\begin{DoxyCompactList}\small\item\em Create a new position object to operate on. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} void \hyperlink{group__Location_gaa7ab0e1b0c13c0dd0402ad0f57863af3}{elocation\+\_\+position\+\_\+free} (\hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$position)
\begin{DoxyCompactList}\small\item\em Free an position object. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_gac72e7393c0fcefeb003ebef6f8310dc6}{elocation\+\_\+address\+\_\+get} (\hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address} $\ast$address)
\begin{DoxyCompactList}\small\item\em Get the current address information. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_ga63021b1b1bae584f7b18c93299956007}{elocation\+\_\+position\+\_\+get} (\hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$position)
\begin{DoxyCompactList}\small\item\em Get the current position information. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_ga1a8200ff897dc051b523a51c38f51911}{elocation\+\_\+status\+\_\+get} (int $\ast$status)
\begin{DoxyCompactList}\small\item\em Get the current status. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_gac394640141e0ee145e64bc99c16b2cb4}{elocation\+\_\+requirements\+\_\+set} (\hyperlink{group__Location_ga3af1c05f084d92d326c6194d3ce0e24b}{Elocation\+\_\+\+Requirements} $\ast$requirements)
\begin{DoxyCompactList}\small\item\em Set the requirements. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_ga164cd6d9f0e3297d3c00a1518d077608}{elocation\+\_\+position\+\_\+to\+\_\+address} (\hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$position\+\_\+shadow, \hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address} $\ast$address\+\_\+shadow)
\begin{DoxyCompactList}\small\item\em Convert position to address. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_gab317513f3344ee687ae74409cdc15000}{elocation\+\_\+address\+\_\+to\+\_\+position} (\hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address} $\ast$address\+\_\+shadow, \hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$position\+\_\+shadow)
\begin{DoxyCompactList}\small\item\em Convert address to position. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_gad3d98cf4594ae6cecbd3ccd88d562dd0}{elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position} (const char $\ast$freeform\+\_\+address, \hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$position\+\_\+shadow)
\begin{DoxyCompactList}\small\item\em Convert free form address tring to position. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_ga740882bb8b7aa675c9d9c8e632239dbe}{elocation\+\_\+landmarks\+\_\+get} (\hyperlink{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{Elocation\+\_\+\+Position} $\ast$position\+\_\+shadow, \hyperlink{group__Location_ga70097807d0c7c94f6648f98947f57145}{Elocation\+\_\+\+Address} $\ast$address\+\_\+shadow)
\begin{DoxyCompactList}\small\item\em Request a landmark position. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} \hyperlink{group__Eina__Types__Group_ga3fe0caf72e93b1bab1ca8ee3ccf3f226}{Eina\+\_\+\+Bool} \hyperlink{group__Location_gac913c3ae7abe9ecfe5769255d7463750}{elocation\+\_\+init} (void)
\begin{DoxyCompactList}\small\item\em Initialize the elocation subsystem. \end{DoxyCompactList}\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} void \hyperlink{group__Location_ga171f14c512aba57a32743647c07ac2dd}{elocation\+\_\+shutdown} (void)
\begin{DoxyCompactList}\small\item\em Cleanup and shutdown the elocation subsystem. \end{DoxyCompactList}\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gafbc96484eaf8205668222bf464d40dac}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S}
\begin{DoxyCompactList}\small\item\em Available location events that are emitted from the library. \end{DoxyCompactList}\item 
\hypertarget{group__Location_ga46e6af99df73d92e269d8cbec5dee787}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_ga46e6af99df73d92e269d8cbec5dee787}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+O\+S\+I\+T\+I\+O\+N}\label{group__Location_ga46e6af99df73d92e269d8cbec5dee787}

\begin{DoxyCompactList}\small\item\em Position changed. \end{DoxyCompactList}\item 
\hypertarget{group__Location_gaf905f923cca1b1f518ef66cb86eca170}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gaf905f923cca1b1f518ef66cb86eca170}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+A\+D\+D\+R\+E\+S\+S}\label{group__Location_gaf905f923cca1b1f518ef66cb86eca170}

\begin{DoxyCompactList}\small\item\em Address changed. \end{DoxyCompactList}\item 
\hypertarget{group__Location_gacc0727e2c95d80653668d6069537d528}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gacc0727e2c95d80653668d6069537d528}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+V\+E\+L\+O\+C\+I\+T\+Y}\label{group__Location_gacc0727e2c95d80653668d6069537d528}

\begin{DoxyCompactList}\small\item\em Velocity changed. \end{DoxyCompactList}\item 
\hypertarget{group__Location_gacbb0cfabbde2b73376e794c811722c63}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gacbb0cfabbde2b73376e794c811722c63}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+G\+E\+O\+C\+O\+D\+E}\label{group__Location_gacbb0cfabbde2b73376e794c811722c63}

\begin{DoxyCompactList}\small\item\em Reply for geocode translation arrived. \end{DoxyCompactList}\item 
\hypertarget{group__Location_ga1e42b28b5cad09e2ba27b8968e7cede6}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_ga1e42b28b5cad09e2ba27b8968e7cede6}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+R\+E\+V\+E\+R\+S\+E\+G\+E\+O\+C\+O\+D\+E}\label{group__Location_ga1e42b28b5cad09e2ba27b8968e7cede6}

\begin{DoxyCompactList}\small\item\em Reply for geocode translation arrived. \end{DoxyCompactList}\item 
\hypertarget{group__Location_gad2c8fbf49d34e4265165176e75849578}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gad2c8fbf49d34e4265165176e75849578}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+N\+M\+E\+A}\label{group__Location_gad2c8fbf49d34e4265165176e75849578}

\begin{DoxyCompactList}\small\item\em N\+M\+E\+A update. \end{DoxyCompactList}\item 
\hypertarget{group__Location_ga21980100de4cf059715a6921f7038c6f}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_ga21980100de4cf059715a6921f7038c6f}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+A\+T\+E\+L\+L\+I\+T\+E}\label{group__Location_ga21980100de4cf059715a6921f7038c6f}

\begin{DoxyCompactList}\small\item\em Satellite info changed. \end{DoxyCompactList}\item 
\hypertarget{group__Location_gaa51d20e59777443f5410cfeb10559cb2}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gaa51d20e59777443f5410cfeb10559cb2}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+O\+I}\label{group__Location_gaa51d20e59777443f5410cfeb10559cb2}

\begin{DoxyCompactList}\small\item\em P\+O\+I reply. \end{DoxyCompactList}\item 
\hypertarget{group__Location_gacc0c3dbccad7000eff258aba6c1069b9}{}\hyperlink{group__Elua_ga3db3556eec8ef18cb8ddb43816974ac8}{E\+A\+P\+I} int \hyperlink{group__Location_gacc0c3dbccad7000eff258aba6c1069b9}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+M\+E\+T\+A\+\_\+\+R\+E\+A\+D\+Y}\label{group__Location_gacc0c3dbccad7000eff258aba6c1069b9}

\begin{DoxyCompactList}\small\item\em Meta provider is ready to be used. \end{DoxyCompactList}\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
enum \hyperlink{group__Location_gaf7d3505d9f0421f0edc84fdc3f5fc085}{Elocation\+\_\+\+Accuracy\+\_\+\+Level} \{ \\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+N\+O\+N\+E} = 0, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+C\+O\+U\+N\+T\+R\+Y} = 1, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+R\+E\+G\+I\+O\+N}, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+L\+O\+C\+A\+L\+I\+T\+Y}, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+P\+O\+S\+T\+A\+L\+C\+O\+D\+E}, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+C\+I\+T\+Y} = 4, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+N\+E\+I\+G\+H\+B\+O\+R\+H\+O\+O\+D} = 5, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+S\+T\+R\+E\+E\+T} = 6, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+D\+E\+T\+A\+I\+L\+E\+D}, 
\\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+A\+C\+C\+U\+R\+A\+C\+Y\+\_\+\+L\+E\+V\+E\+L\+\_\+\+E\+X\+A\+C\+T} = 8
 \}
\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
enum \hyperlink{group__Location_gab88cd08d8d12e09816070877ab23b7d8}{Elocation\+\_\+\+Resource\+\_\+\+Flags} \{ \\*
{\bfseries E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+O\+N\+E} = 0, 
\\*
\hyperlink{group__Location_gab88cd08d8d12e09816070877ab23b7d8a7d21bb47bf041e20ea85e72ccd5aa4b1}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+E\+T\+W\+O\+R\+K} = 1 $<$$<$ 0, 
\\*
\hyperlink{group__Location_gab88cd08d8d12e09816070877ab23b7d8ac24689a848e4ae4a3a6533e0e2dcdbc8}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+C\+E\+L\+L} = 1 $<$$<$ 1, 
\\*
\hyperlink{group__Location_gab88cd08d8d12e09816070877ab23b7d8ae932cb8fe341e4caed9c61cb49b18ce6}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+G\+P\+S} = 1 $<$$<$ 2, 
\\*
\hyperlink{group__Location_gab88cd08d8d12e09816070877ab23b7d8a1b75c580364630545a940e0e198dc8b4}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+A\+L\+L} = (1 $<$$<$ 10) -\/ 1
 \}
\end{DoxyCompactItemize}


\subsection{Detailed Description}


\subsection{Typedef Documentation}
\hypertarget{group__Location_ga39a951ab9c8a02f3358d866a50aad425}{}\index{Location@{Location}!Elocation\+\_\+\+Accuracy@{Elocation\+\_\+\+Accuracy}}
\index{Elocation\+\_\+\+Accuracy@{Elocation\+\_\+\+Accuracy}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Accuracy}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Elocation\+\_\+\+Accuracy}}\label{group__Location_ga39a951ab9c8a02f3358d866a50aad425}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Information about the accuracy of the reported location. For details about the level of accuracy see \hyperlink{group__Location_gaf7d3505d9f0421f0edc84fdc3f5fc085}{Elocation\+\_\+\+Accuracy\+\_\+\+Level}. It also covers horizontal and vertical accuracy. The values depend on the used provider and may very in quality. \hypertarget{group__Location_ga70097807d0c7c94f6648f98947f57145}{}\index{Location@{Location}!Elocation\+\_\+\+Address@{Elocation\+\_\+\+Address}}
\index{Elocation\+\_\+\+Address@{Elocation\+\_\+\+Address}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Address}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Elocation\+\_\+\+Address}}\label{group__Location_ga70097807d0c7c94f6648f98947f57145}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Location information in textual form. Depending on the used provider this can cover only the country or a detailed address with postcode and street. The level of detail varies depending on the used provider. A timestamp is available to calculate the age of the address data. \hypertarget{group__Location_ga82f0edab60c70181bc2977f5f9938a57}{}\index{Location@{Location}!Elocation\+\_\+\+Position@{Elocation\+\_\+\+Position}}
\index{Elocation\+\_\+\+Position@{Elocation\+\_\+\+Position}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Position}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Elocation\+\_\+\+Position}}\label{group__Location_ga82f0edab60c70181bc2977f5f9938a57}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Location information based on the G\+P\+S grid. Latitude, longitude and altitude. A timestamp is available to calculate the age of the address data. \hypertarget{group__Location_ga70a0c8f4a2438b304023833bb07d3e7e}{}\index{Location@{Location}!Elocation\+\_\+\+Velocity@{Elocation\+\_\+\+Velocity}}
\index{Elocation\+\_\+\+Velocity@{Elocation\+\_\+\+Velocity}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Velocity}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Elocation\+\_\+\+Velocity}}\label{group__Location_ga70a0c8f4a2438b304023833bb07d3e7e}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Velocity information. So far this interface is only offered with G\+P\+S based providers. It offers information about speed, direction and climb. A timestamp is available to calculate the age of the address data.

F\+I\+X\+M\+E\+: check units and formats of this values coming in from Geo\+Clue \hypertarget{group__Location_ga3af1c05f084d92d326c6194d3ce0e24b}{}\index{Location@{Location}!Elocation\+\_\+\+Requirements@{Elocation\+\_\+\+Requirements}}
\index{Elocation\+\_\+\+Requirements@{Elocation\+\_\+\+Requirements}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Requirements}]{\setlength{\rightskip}{0pt plus 5cm}{\bf Elocation\+\_\+\+Requirements}}\label{group__Location_ga3af1c05f084d92d326c6194d3ce0e24b}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Requirement settings for the location provider. Requirements can be a level of accuracy or allowed resources like network access or G\+P\+S. See \hyperlink{group__Location_gab88cd08d8d12e09816070877ab23b7d8}{Elocation\+\_\+\+Resource\+\_\+\+Flags} for all available resource flags.

Based on this setting the best provider is chosen between the available providers of Geo\+Clue. 

\subsection{Enumeration Type Documentation}
\hypertarget{group__Location_gaf7d3505d9f0421f0edc84fdc3f5fc085}{}\index{Location@{Location}!Elocation\+\_\+\+Accuracy\+\_\+\+Level@{Elocation\+\_\+\+Accuracy\+\_\+\+Level}}
\index{Elocation\+\_\+\+Accuracy\+\_\+\+Level@{Elocation\+\_\+\+Accuracy\+\_\+\+Level}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Accuracy\+\_\+\+Level}]{\setlength{\rightskip}{0pt plus 5cm}enum {\bf Elocation\+\_\+\+Accuracy\+\_\+\+Level}}\label{group__Location_gaf7d3505d9f0421f0edc84fdc3f5fc085}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Different location accuracy levels from country level up to detailed, e.\+g. G\+P\+S, information. \hypertarget{group__Location_gab88cd08d8d12e09816070877ab23b7d8}{}\index{Location@{Location}!Elocation\+\_\+\+Resource\+\_\+\+Flags@{Elocation\+\_\+\+Resource\+\_\+\+Flags}}
\index{Elocation\+\_\+\+Resource\+\_\+\+Flags@{Elocation\+\_\+\+Resource\+\_\+\+Flags}!Location@{Location}}
\subsubsection[{Elocation\+\_\+\+Resource\+\_\+\+Flags}]{\setlength{\rightskip}{0pt plus 5cm}enum {\bf Elocation\+\_\+\+Resource\+\_\+\+Flags}}\label{group__Location_gab88cd08d8d12e09816070877ab23b7d8}
\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Flags for available system resources to be used for locating. So far they cover physical resources like network connection, cellular network connection and G\+P\+S. \begin{Desc}
\item[Enumerator]\par
\begin{description}
\index{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+E\+T\+W\+O\+R\+K@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+E\+T\+W\+O\+R\+K}!Location@{Location}}\index{Location@{Location}!E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+E\+T\+W\+O\+R\+K@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+E\+T\+W\+O\+R\+K}}\item[{\em 
\hypertarget{group__Location_gab88cd08d8d12e09816070877ab23b7d8a7d21bb47bf041e20ea85e72ccd5aa4b1}{}E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+N\+E\+T\+W\+O\+R\+K\label{group__Location_gab88cd08d8d12e09816070877ab23b7d8a7d21bb47bf041e20ea85e72ccd5aa4b1}
}]Internet connection is available. \index{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+C\+E\+L\+L@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+C\+E\+L\+L}!Location@{Location}}\index{Location@{Location}!E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+C\+E\+L\+L@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+C\+E\+L\+L}}\item[{\em 
\hypertarget{group__Location_gab88cd08d8d12e09816070877ab23b7d8ac24689a848e4ae4a3a6533e0e2dcdbc8}{}E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+C\+E\+L\+L\label{group__Location_gab88cd08d8d12e09816070877ab23b7d8ac24689a848e4ae4a3a6533e0e2dcdbc8}
}]Cell network information, e.\+g. G\+S\+M, is available \index{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+G\+P\+S@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+G\+P\+S}!Location@{Location}}\index{Location@{Location}!E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+G\+P\+S@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+G\+P\+S}}\item[{\em 
\hypertarget{group__Location_gab88cd08d8d12e09816070877ab23b7d8ae932cb8fe341e4caed9c61cb49b18ce6}{}E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+G\+P\+S\label{group__Location_gab88cd08d8d12e09816070877ab23b7d8ae932cb8fe341e4caed9c61cb49b18ce6}
}]G\+P\+S information is available. \index{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+A\+L\+L@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+A\+L\+L}!Location@{Location}}\index{Location@{Location}!E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+A\+L\+L@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+A\+L\+L}}\item[{\em 
\hypertarget{group__Location_gab88cd08d8d12e09816070877ab23b7d8a1b75c580364630545a940e0e198dc8b4}{}E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+R\+E\+S\+O\+U\+R\+C\+E\+\_\+\+A\+L\+L\label{group__Location_gab88cd08d8d12e09816070877ab23b7d8a1b75c580364630545a940e0e198dc8b4}
}]All resources are available. \end{description}
\end{Desc}


\subsection{Function Documentation}
\hypertarget{group__Location_ga748b789c18ab4bbac9030cd1308a70a5}{}\index{Location@{Location}!elocation\+\_\+address\+\_\+new@{elocation\+\_\+address\+\_\+new}}
\index{elocation\+\_\+address\+\_\+new@{elocation\+\_\+address\+\_\+new}!Location@{Location}}
\subsubsection[{elocation\+\_\+address\+\_\+new(void)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Elocation\+\_\+\+Address}$\ast$ elocation\+\_\+address\+\_\+new (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Location_ga748b789c18ab4bbac9030cd1308a70a5}


Create a new address object to operate on. 

\begin{DoxyReturn}{Returns}
Address object.
\end{DoxyReturn}
The returned address object is safe to be operated on. It can be used for all other elocation functions. Once finished with it it need to be destroyed with a call to \hyperlink{group__Location_gafd4ff166c408ef5f581ed3a3eb007625}{elocation\+\_\+address\+\_\+free}.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}
\hypertarget{group__Location_gafd4ff166c408ef5f581ed3a3eb007625}{}\index{Location@{Location}!elocation\+\_\+address\+\_\+free@{elocation\+\_\+address\+\_\+free}}
\index{elocation\+\_\+address\+\_\+free@{elocation\+\_\+address\+\_\+free}!Location@{Location}}
\subsubsection[{elocation\+\_\+address\+\_\+free(\+Elocation\+\_\+\+Address $\ast$address)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} void elocation\+\_\+address\+\_\+free (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Address} $\ast$}]{address}
\end{DoxyParamCaption}
)}\label{group__Location_gafd4ff166c408ef5f581ed3a3eb007625}


Free an address object. 


\begin{DoxyParams}{Parameters}
{\em address} & Address object to be freed.\\
\hline
\end{DoxyParams}
Destroys an address object created with \hyperlink{group__Location_ga748b789c18ab4bbac9030cd1308a70a5}{elocation\+\_\+address\+\_\+new}. Should be used during the cleanup of the application or whenever the address object is no longer needed.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+R\+R.

\hypertarget{group__Location_gab08afeffaf64ecec9d3bc7cfd9a8ca09}{}\index{Location@{Location}!elocation\+\_\+position\+\_\+new@{elocation\+\_\+position\+\_\+new}}
\index{elocation\+\_\+position\+\_\+new@{elocation\+\_\+position\+\_\+new}!Location@{Location}}
\subsubsection[{elocation\+\_\+position\+\_\+new(void)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Elocation\+\_\+\+Position}$\ast$ elocation\+\_\+position\+\_\+new (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Location_gab08afeffaf64ecec9d3bc7cfd9a8ca09}


Create a new position object to operate on. 

\begin{DoxyReturn}{Returns}
Position object.
\end{DoxyReturn}
The returned address object is safe to be operated on. It can be used for all other elocation functions. Once finished with it it need to be destroyed with a call to \hyperlink{group__Location_gafd4ff166c408ef5f581ed3a3eb007625}{elocation\+\_\+address\+\_\+free}.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}
\hypertarget{group__Location_gaa7ab0e1b0c13c0dd0402ad0f57863af3}{}\index{Location@{Location}!elocation\+\_\+position\+\_\+free@{elocation\+\_\+position\+\_\+free}}
\index{elocation\+\_\+position\+\_\+free@{elocation\+\_\+position\+\_\+free}!Location@{Location}}
\subsubsection[{elocation\+\_\+position\+\_\+free(\+Elocation\+\_\+\+Position $\ast$position)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} void elocation\+\_\+position\+\_\+free (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Position} $\ast$}]{position}
\end{DoxyParamCaption}
)}\label{group__Location_gaa7ab0e1b0c13c0dd0402ad0f57863af3}


Free an position object. 


\begin{DoxyParams}{Parameters}
{\em position} & Position object to be freed.\\
\hline
\end{DoxyParams}
Destroys a position object created with \hyperlink{group__Location_ga748b789c18ab4bbac9030cd1308a70a5}{elocation\+\_\+address\+\_\+new}. Should be used during the cleanup of the application or whenever the location object is no longer needed.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+R\+R.

\hypertarget{group__Location_gac72e7393c0fcefeb003ebef6f8310dc6}{}\index{Location@{Location}!elocation\+\_\+address\+\_\+get@{elocation\+\_\+address\+\_\+get}}
\index{elocation\+\_\+address\+\_\+get@{elocation\+\_\+address\+\_\+get}!Location@{Location}}
\subsubsection[{elocation\+\_\+address\+\_\+get(\+Elocation\+\_\+\+Address $\ast$address)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+address\+\_\+get (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Address} $\ast$}]{address}
\end{DoxyParamCaption}
)}\label{group__Location_gac72e7393c0fcefeb003ebef6f8310dc6}


Get the current address information. 


\begin{DoxyParams}{Parameters}
{\em address} & Address struct to be filled with information. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Request the latest address. The requested to the underling components might be asynchronous so better check the timestamp if the data has changed. To get events when the address changes one can also subscribe to the \hyperlink{group__Location_gaf905f923cca1b1f518ef66cb86eca170}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+A\+D\+D\+R\+E\+S\+S} ecore event which will have the address object as event.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Location_ga63021b1b1bae584f7b18c93299956007}{}\index{Location@{Location}!elocation\+\_\+position\+\_\+get@{elocation\+\_\+position\+\_\+get}}
\index{elocation\+\_\+position\+\_\+get@{elocation\+\_\+position\+\_\+get}!Location@{Location}}
\subsubsection[{elocation\+\_\+position\+\_\+get(\+Elocation\+\_\+\+Position $\ast$position)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+position\+\_\+get (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Position} $\ast$}]{position}
\end{DoxyParamCaption}
)}\label{group__Location_ga63021b1b1bae584f7b18c93299956007}


Get the current position information. 


\begin{DoxyParams}{Parameters}
{\em position} & Position struct to be filled with information. \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Request the latest position. The requested to the underling components might be asynchronous so better check the timestamp if the data has changed. To get events when the position changes one can also subscribe to the \hyperlink{group__Location_ga46e6af99df73d92e269d8cbec5dee787}{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+O\+S\+I\+T\+I\+O\+N} ecore event which will have the position object as event.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Location_ga1a8200ff897dc051b523a51c38f51911}{}\index{Location@{Location}!elocation\+\_\+status\+\_\+get@{elocation\+\_\+status\+\_\+get}}
\index{elocation\+\_\+status\+\_\+get@{elocation\+\_\+status\+\_\+get}!Location@{Location}}
\subsubsection[{elocation\+\_\+status\+\_\+get(int $\ast$status)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+status\+\_\+get (
\begin{DoxyParamCaption}
\item[{int $\ast$}]{status}
\end{DoxyParamCaption}
)}\label{group__Location_ga1a8200ff897dc051b523a51c38f51911}


Get the current status. 


\begin{DoxyParams}{Parameters}
{\em status} & Status \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, and E\+I\+N\+A\+\_\+\+T\+R\+U\+E.

\hypertarget{group__Location_gac394640141e0ee145e64bc99c16b2cb4}{}\index{Location@{Location}!elocation\+\_\+requirements\+\_\+set@{elocation\+\_\+requirements\+\_\+set}}
\index{elocation\+\_\+requirements\+\_\+set@{elocation\+\_\+requirements\+\_\+set}!Location@{Location}}
\subsubsection[{elocation\+\_\+requirements\+\_\+set(\+Elocation\+\_\+\+Requirements $\ast$requirements)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+requirements\+\_\+set (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Requirements} $\ast$}]{requirements}
\end{DoxyParamCaption}
)}\label{group__Location_gac394640141e0ee145e64bc99c16b2cb4}


Set the requirements. 


\begin{DoxyParams}{Parameters}
{\em requirements} & Requirements \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Set the requirements for selecting a provider.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}
\hypertarget{group__Location_ga164cd6d9f0e3297d3c00a1518d077608}{}\index{Location@{Location}!elocation\+\_\+position\+\_\+to\+\_\+address@{elocation\+\_\+position\+\_\+to\+\_\+address}}
\index{elocation\+\_\+position\+\_\+to\+\_\+address@{elocation\+\_\+position\+\_\+to\+\_\+address}!Location@{Location}}
\subsubsection[{elocation\+\_\+position\+\_\+to\+\_\+address(\+Elocation\+\_\+\+Position $\ast$position\+\_\+shadow, Elocation\+\_\+\+Address $\ast$address\+\_\+shadow)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+position\+\_\+to\+\_\+address (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Position} $\ast$}]{position\+\_\+shadow, }
\item[{{\bf Elocation\+\_\+\+Address} $\ast$}]{address\+\_\+shadow}
\end{DoxyParamCaption}
)}\label{group__Location_ga164cd6d9f0e3297d3c00a1518d077608}


Convert position to address. 


\begin{DoxyParams}{Parameters}
{\em position\+\_\+shadow} & Position input \\
\hline
{\em address\+\_\+shadow} & Address output \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Use a Geo\+Code provider to translate from a given G\+P\+S coordinate representation of a location to a representation in textual form.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, E\+I\+N\+A\+\_\+\+T\+R\+U\+E, eldbus\+\_\+message\+\_\+iter\+\_\+basic\+\_\+append(), eldbus\+\_\+message\+\_\+iter\+\_\+container\+\_\+close(), eldbus\+\_\+message\+\_\+iter\+\_\+container\+\_\+new(), eldbus\+\_\+message\+\_\+iter\+\_\+get(), eldbus\+\_\+message\+\_\+unref(), eldbus\+\_\+proxy\+\_\+method\+\_\+call\+\_\+new(), eldbus\+\_\+proxy\+\_\+send(), and E\+R\+R.

\hypertarget{group__Location_gab317513f3344ee687ae74409cdc15000}{}\index{Location@{Location}!elocation\+\_\+address\+\_\+to\+\_\+position@{elocation\+\_\+address\+\_\+to\+\_\+position}}
\index{elocation\+\_\+address\+\_\+to\+\_\+position@{elocation\+\_\+address\+\_\+to\+\_\+position}!Location@{Location}}
\subsubsection[{elocation\+\_\+address\+\_\+to\+\_\+position(\+Elocation\+\_\+\+Address $\ast$address\+\_\+shadow, Elocation\+\_\+\+Position $\ast$position\+\_\+shadow)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+address\+\_\+to\+\_\+position (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Address} $\ast$}]{address\+\_\+shadow, }
\item[{{\bf Elocation\+\_\+\+Position} $\ast$}]{position\+\_\+shadow}
\end{DoxyParamCaption}
)}\label{group__Location_gab317513f3344ee687ae74409cdc15000}


Convert address to position. 


\begin{DoxyParams}{Parameters}
{\em address\+\_\+shadow} & Address input \\
\hline
{\em position\+\_\+shadow} & Position output \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Use a Geo\+Code provider to translate from a given textual form representation of a location to a representation as G\+P\+S coordinates.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, E\+I\+N\+A\+\_\+\+T\+R\+U\+E, eldbus\+\_\+message\+\_\+iter\+\_\+arguments\+\_\+append(), eldbus\+\_\+message\+\_\+iter\+\_\+container\+\_\+close(), eldbus\+\_\+message\+\_\+iter\+\_\+container\+\_\+new(), eldbus\+\_\+message\+\_\+iter\+\_\+get(), eldbus\+\_\+message\+\_\+unref(), eldbus\+\_\+proxy\+\_\+method\+\_\+call\+\_\+new(), eldbus\+\_\+proxy\+\_\+send(), and E\+R\+R.

\hypertarget{group__Location_gad3d98cf4594ae6cecbd3ccd88d562dd0}{}\index{Location@{Location}!elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position@{elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position}}
\index{elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position@{elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position}!Location@{Location}}
\subsubsection[{elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position(const char $\ast$freeform\+\_\+address, Elocation\+\_\+\+Position $\ast$position\+\_\+shadow)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+freeform\+\_\+address\+\_\+to\+\_\+position (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{freeform\+\_\+address, }
\item[{{\bf Elocation\+\_\+\+Position} $\ast$}]{position\+\_\+shadow}
\end{DoxyParamCaption}
)}\label{group__Location_gad3d98cf4594ae6cecbd3ccd88d562dd0}


Convert free form address tring to position. 


\begin{DoxyParams}{Parameters}
{\em freeform\+\_\+address} & Address string in free form \\
\hline
{\em position\+\_\+shadow} & Position output \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Similar Geo\+Code translation from textual form to G\+P\+S coordinates as \hyperlink{group__Location_gab317513f3344ee687ae74409cdc15000}{elocation\+\_\+address\+\_\+to\+\_\+position} but in this case the address is a simple string which hopefully contains enough information for the provider to understand and translate.

Useful for an easy search interface in an application but also more error prone regarding correct results.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, E\+I\+N\+A\+\_\+\+T\+R\+U\+E, eldbus\+\_\+proxy\+\_\+call(), and E\+R\+R.

\hypertarget{group__Location_ga740882bb8b7aa675c9d9c8e632239dbe}{}\index{Location@{Location}!elocation\+\_\+landmarks\+\_\+get@{elocation\+\_\+landmarks\+\_\+get}}
\index{elocation\+\_\+landmarks\+\_\+get@{elocation\+\_\+landmarks\+\_\+get}!Location@{Location}}
\subsubsection[{elocation\+\_\+landmarks\+\_\+get(\+Elocation\+\_\+\+Position $\ast$position\+\_\+shadow, Elocation\+\_\+\+Address $\ast$address\+\_\+shadow)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+landmarks\+\_\+get (
\begin{DoxyParamCaption}
\item[{{\bf Elocation\+\_\+\+Position} $\ast$}]{position\+\_\+shadow, }
\item[{{\bf Elocation\+\_\+\+Address} $\ast$}]{address\+\_\+shadow}
\end{DoxyParamCaption}
)}\label{group__Location_ga740882bb8b7aa675c9d9c8e632239dbe}


Request a landmark position. 


\begin{DoxyParams}{Parameters}
{\em position\+\_\+shadow} & Position ouput \\
\hline
{\em address\+\_\+shadow} & Address input \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
Request a landmark position also known as Point Of Interest (P\+O\+I) from Geo\+Clue.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, E\+I\+N\+A\+\_\+\+T\+R\+U\+E, eldbus\+\_\+message\+\_\+iter\+\_\+basic\+\_\+append(), eldbus\+\_\+message\+\_\+iter\+\_\+get(), eldbus\+\_\+message\+\_\+unref(), eldbus\+\_\+proxy\+\_\+method\+\_\+call\+\_\+new(), eldbus\+\_\+proxy\+\_\+send(), and E\+R\+R.

\hypertarget{group__Location_gac913c3ae7abe9ecfe5769255d7463750}{}\index{Location@{Location}!elocation\+\_\+init@{elocation\+\_\+init}}
\index{elocation\+\_\+init@{elocation\+\_\+init}!Location@{Location}}
\subsubsection[{elocation\+\_\+init(void)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} {\bf Eina\+\_\+\+Bool} elocation\+\_\+init (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Location_gac913c3ae7abe9ecfe5769255d7463750}


Initialize the elocation subsystem. 

\begin{DoxyReturn}{Returns}
E\+I\+N\+A\+\_\+\+T\+R\+U\+E for success and E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E for failure.
\end{DoxyReturn}
This function must be called before using any of the Elocation functionality in your application to make sure it it setup correctly for usage.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References ecore\+\_\+event\+\_\+handler\+\_\+add(), ecore\+\_\+event\+\_\+type\+\_\+new(), ecore\+\_\+init(), E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E, eina\+\_\+init(), eina\+\_\+log\+\_\+domain\+\_\+register(), E\+I\+N\+A\+\_\+\+L\+O\+G\+\_\+\+E\+R\+R, E\+I\+N\+A\+\_\+\+T\+R\+U\+E, eldbus\+\_\+connection\+\_\+get(), eldbus\+\_\+init(), eldbus\+\_\+name\+\_\+owner\+\_\+changed\+\_\+callback\+\_\+add(), eldbus\+\_\+object\+\_\+get(), eldbus\+\_\+proxy\+\_\+call(), eldbus\+\_\+proxy\+\_\+get(), E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+A\+D\+D\+R\+E\+S\+S, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+G\+E\+O\+C\+O\+D\+E, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+M\+E\+T\+A\+\_\+\+R\+E\+A\+D\+Y, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+N\+M\+E\+A, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+O\+I, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+P\+O\+S\+I\+T\+I\+O\+N, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+R\+E\+V\+E\+R\+S\+E\+G\+E\+O\+C\+O\+D\+E, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+A\+T\+E\+L\+L\+I\+T\+E, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S, E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+V\+E\+L\+O\+C\+I\+T\+Y, and E\+R\+R.

\hypertarget{group__Location_ga171f14c512aba57a32743647c07ac2dd}{}\index{Location@{Location}!elocation\+\_\+shutdown@{elocation\+\_\+shutdown}}
\index{elocation\+\_\+shutdown@{elocation\+\_\+shutdown}!Location@{Location}}
\subsubsection[{elocation\+\_\+shutdown(void)}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} void elocation\+\_\+shutdown (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__Location_ga171f14c512aba57a32743647c07ac2dd}


Cleanup and shutdown the elocation subsystem. 

This function must be called when the application is no longer using any of the Elocation functionality to allow the subsystem to shutdown cleanly.

\begin{DoxySince}{Since}
1.\+13 
\end{DoxySince}


References ecore\+\_\+shutdown(), eina\+\_\+log\+\_\+domain\+\_\+unregister(), eina\+\_\+shutdown(), eldbus\+\_\+connection\+\_\+unref(), eldbus\+\_\+name\+\_\+owner\+\_\+changed\+\_\+callback\+\_\+del(), eldbus\+\_\+proxy\+\_\+call(), eldbus\+\_\+proxy\+\_\+unref(), eldbus\+\_\+shutdown(), and E\+R\+R.



\subsection{Variable Documentation}
\hypertarget{group__Location_gafbc96484eaf8205668222bf464d40dac}{}\index{Location@{Location}!E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S}}
\index{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S@{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S}!Location@{Location}}
\subsubsection[{E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S}]{\setlength{\rightskip}{0pt plus 5cm}{\bf E\+A\+P\+I} int E\+L\+O\+C\+A\+T\+I\+O\+N\+\_\+\+E\+V\+E\+N\+T\+\_\+\+S\+T\+A\+T\+U\+S}\label{group__Location_gafbc96484eaf8205668222bf464d40dac}


Available location events that are emitted from the library. 

\begin{DoxySince}{Since}
1.\+13
\end{DoxySince}
Ecore events emitted by the library. Applications can register ecore event handlers to react on such events. After the initial query this can be used to keep track of changes and update your U\+I or data accordingly.\+Status changed 

Referenced by elocation\+\_\+init().

