<p class="toc-title">Content</p>
<ul class="toc">
<li><a href="#manager">Location Manager</a></li>
- <li><a href="#criteria">Location Criteria</a></li>
- <li><a href="#privacy">Privacy Policy</a></li>
+ <li><a href="#method">Location Method</a></li>
<li><a href="#settings">Location Settings</a></li>
</ul>
<p class="toc-title">Related Info</p>
<h1>Location</h1>
- <p>Location information has a geographical point on the Earth, and optionally location-related information can also contain information about altitude, accuracy about the geographical point and altitude, and the user speed and course of direction. Location data features include managing location information on the device.</p>
+ <p>Location information has a geographical point on the Earth, and optionally location-related information can also contain information about altitude, accuracy about the geographical point and altitude, and speed and course of direction of the user. Location data features include managing location information on the device.</p>
<p> </p>
<p>The main location features are:</p>
- <ul>
- <li><a href="#manager">Enabling the Location Manager</a></li>
- <li><a href="#criteria">Defining the location criteria</a></li>
- <li><a href="#privacy">Setting the privacy policy</a></li>
- <li><a href="#settings">Defining the location settings</a></li>
+ <ul>
+ <li><a href="#manager">Enabling the Location Manager</a></li>
+ <li><a href="#method">Defining the location method</a></li>
+ <li><a href="#settings">Defining the location settings</a></li>
</ul>
<table class="note">
</table>
<h2 id="manager" name="manager">Location Manager</h2>
- <p>The Location Manager API (in <a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">wearable</a> applications) is used to retrieve the best-effort current location and use the location-based services specified in the <a href="#criteria">location service quality criteria</a>.</p>
- <p>The Location Manager API allows your application to: </p>
+ <p>The Location Manager API (in <a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">wearable</a> applications) provides the current location using the location sources specified in the <a href="#method">location method</a>.</p>
+ <p>Using the <span style="font-family: Courier New,Courier,monospace">Location Manager</span> allows your application to: </p>
<ul>
<li>Get the current location</li>
<li>Get the last known location</li>
<li>Get location updates</li>
</ul>
<p>Asynchronous location-related updates and region monitoring notifications are implemented with callback interfaces (functions whose names end with "cb").</p>
- <p>You can use the location update states as follows:</p>
+ <p>You can use the location state and updates as follows:</p>
<ul>
- <li><p>If the Location Manager is working correctly, the location update state is set to <span style="font-family: Courier New,Courier,monospace">LOCATIONS_ACCESS_STATE_ALLOWED (LOCATIONS_ERROR_NONE)</span>. The device can receive notifications about location updates and accuracy changes only in this update state.</p></li>
- <li><p>If the Location Manager is unable to run on the requested device due to weak radio reception, the location update state is set to <span style="font-family: Courier New,Courier,monospace">LOCATIONS_ACCESS_STATE_NONE (LOCATIONS_ERROR_SERVICE_NOT_AVAILABLE)</span>. If this situation persists for a longer period, it is recommended to cancel the request and try again to conserve the device battery.</p></li>
+ <li><p>If the Location Manager is working correctly, the location state is set to <span style="font-family: Courier New,Courier,monospace">LOCATIONS_SERVICE_ENABLED</span>. The device can receive notifications about location updates and accuracy changes only in this update state.</p></li>
+ <li><p>If the Location Manager is unable to run on the requested device due to weak radio reception, the location update state is set to <span style="font-family: Courier New,Courier,monospace">LOCATIONS_SERVICE_DISABLED (LOCATIONS_ERROR_SERVICE_NOT_AVAILABLE)</span>. If this situation persists for a longer period, it is recommended to stop the service and try again to conserve the device battery.</p></li>
<li><p>If the user revokes a permission for the application to use location information, the location update state is set to <span style="font-family: Courier New,Courier,monospace">LOCATIONS_ACCESS_STATE_DENIED</span>, and the Location Manager stops all on-going services with the application. The application can request the device user for a permission to continue the stopped service.</p></li>
</ul>
- <h2 id="criteria" name="criteria">Location Criteria</h2>
- <p>The location criteria is used for specifying the desired quality of service of the Location Manager. For example, a location-based weather forecast application can require location-related information just to distinguish a city or a neighborhood while a GPS navigation application can require the highest quality level to pinpoint a map location. Selecting the appropriate quality level not only helps the Location Manager to run the system efficiently but also leads to a good user experience.</p>
- <p>Using the <span style="font-family: Courier New,Courier,monospace">location_accuracy_level_e</span> enumerator (in <a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html#ga4878b9a0afa5990dd2bb500850c1828b">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html#ga4878b9a0afa5990dd2bb500850c1828b">wearable</a> applications) allows your application to specify the following levels of location accuracy:</p>
- <ul>
- <li>Finest (detailed) accuracy level</li>
- <li>Accuracy up to street</li>
- <li>Accuracy up to postal</li>
- <li>Accuracy up to local</li>
- <li>Accuracy up to region</li>
- <li>Accuracy up to country</li>
- </ul>
-
- <p>Using the <span style="font-family: Courier New,Courier,monospace">location_method_e</span> enumerator (in <a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html#gaec8a29c8b701753a7c9d91f4f8acfac5">mobile</a> and <a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html#gaec8a29c8b701753a7c9d91f4f8acfac5">wearable</a> applications) allows your application to specify the following methods of the location positioning system:</p>
+ <h2 id="method" name="method">Location Method</h2>
+ <p>The location Method is used for specifying the desired quality of service of the Location Manager. For example, a location-based weather forecast application can require location-related information just to distinguish a city or a neighborhood while a GPS navigation application can require the highest quality level to pinpoint a map location. Selecting the appropriate quality level not only helps the Location Manager to run the system efficiently but also leads to a good user experience.</p>
+ <p>Using the <span style="font-family: Courier New,Courier,monospace">location_method_e</span> structure allows your application to specify the following methods of location positioning system:</p>
<ul>
<li>GPS, which uses the global positioning system</li>
<li>Hybrid, which selects the best method available at the moment</li>
</ul>
- <p>Based on the desired criteria, the Location Manager provides best-effort location-based services, such as an asynchronous location update or region monitoring notification.</p>
-
-
-<h2 id="privacy" name="privacy">Privacy Policy</h2>
- <p>Tizen provides several privacy ensuring mechanisms for user location data:</p>
- <ul>
- <li>Manual settings in the <a href="#settings">device location settings</a> <p>The settings can only be manually modified by the user with application-level access control. </p></li>
- <li>Location indicator on the screen <p>When the application uses the current location of the user, a location indicator is shown at the top of the screen to explicitly notify the user that the current location data is being used.</p> </li>
- </ul>
+ <p>Based on the desired method, the Location Manager provides best-effort location-based services, such as an asynchronous location update or region monitoring notification.</p>
+
+ <h2 id="settings" name="settings">Location Settings</h2>
+ <p>Tizen provides the user a robust way of controlling the usage of their location data through the device location settings. The following figure shows the various options for enabling or disabling specific positioning technologies.</p>
<p class="figure">Figure: Location setting and indicator</p>
- <p align="center"><img alt="Location setting and indicator" src="../../images/location_setting_and_indicator.png" /></p>
- <p>The location-related functions work differently based on whether the location settings are used.</p>
-
-<h2 id="settings" name="settings">Location Settings</h2>
- <p>Tizen provides the user a robust way of controlling the usage of their location data through the device location settings. The following figure shows the various options for enabling or disabling specific positioning technologies and controlling application permissions.</p>
- <p class="figure">Figure: Location settings</p>
- <p align="center"><img alt="Location settings" src="../../images/loc_priv_setting.png" style="display: block; text-align: center; margin-left: auto; margin-right: auto" /></p>
- <p> The <strong>GPS</strong> setting controls the Global Positioning System usage. It takes GPS satellite signals and provides accurate positioning services generally outdoors. The <strong>Network position</strong> setting enables the usage of network-based positioning technology, which includes Wi-Fi- and cell tower-based positioning, and improves the coverage of positioning services to indoors.</p>
- <p>To ensure privacy, all location settings are initially disabled. To enable them, the user must manually toggle the buttons. The manual task required from the user is understood as an implicit user consent.</p>
+ <p align="center"><img alt="Location settings" src="../../images/location_setting_and_indicator.png" style="display: block; text-align: center; margin-left: auto; margin-right: auto" /></p>
+ <p>The location-related functions work differently based on whether the location settings are used.</p>
+ <p> The <strong>GPS</strong> setting controls the Global Positioning System usage. It takes GPS satellite signals and provides accurate positioning services generally outdoors. The <strong>Wireless networks</strong> setting enables the usage of network-based positioning technology, which includes Wi-Fi and cell tower-based positioning, and improves the coverage of positioning services to indoors.</p>
+ <p> </p>
+ <p>All location settings are initially enabled, if the model is support GPS. To disable them, the user must manually toggle the buttons. The manual task required from the user is understood as an implicit user consent.</p>
+
<table class="note">
<tbody>
<tr>
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">Either the <strong>GPS</strong> or the <strong>Network position</strong> setting must be enabled to retrieve the current location of the device user.</td>
+ <td class="note">Either the <strong>GPS</strong> or the <strong>Wireless networks</strong> setting must be enabled to retrieve the current location of the device user.</td>
</tr>
</tbody>
</table>
- <p> Once the <strong>GPS</strong> or <strong>Network position</strong> setting is enabled, the user can control the usage of the location data for each application separately using the privacy setting. If the privacy setting of the application is disabled, location data is no longer available for the application.</p>
+ <p> Once the <strong>GPS</strong> or <strong>Wireless networks</strong> setting is enabled, the user can control the usage of the location data for each application separately using the privacy setting. If the privacy setting of the application is disabled, location data is no longer available for the application.</p>
<p>The applications whose location setting is enabled can get the current and last known location of the user.</p>
</script>
</body>
-</html>
+</html>
\ No newline at end of file
projects / sdk / online-doc.git / commitdiff
