/usr/share/qt5/doc/qtpositioning/location-positioning-qml.html is in qtlocation5-doc-html 5.2.1-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qml-position.qdoc -->
<title>Positioning (QML) | QtPositioning 5.2</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.2</li>
<li><a href="qtpositioning-index.html">Qt Positioning</a></li>
<li>Positioning (QML)</li>
<li id="buildversion">
Qt 5.2.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#location-positioning">Location Positioning</a></li>
<li class="level2"><a href="#coordinate">Coordinate</a></li>
<li class="level2"><a href="#position">Position</a></li>
<li class="level2"><a href="#positionsource">PositionSource</a></li>
<li class="level2"><a href="#flickr-example"><b>Flickr Example</b></a></li>
</ul>
</div>
<h1 class="title">Positioning (QML)</h1>
<span class="subtitle"></span>
<!-- $$$location-positioning-qml.html-description -->
<div class="descr"> <a name="details"></a>
<a name="location-positioning"></a>
<h2>Location Positioning</h2>
<p>Location data involves a precisely specified position on the Earth's surface — as provided by a latitude-longitude coordinate — along with associated data, such as:</p>
<ul>
<li>The date and time at which the position was reported</li>
<li>The velocity of the device that reported the position</li>
<li>The altitude of the reported position (height above sea level)</li>
<li>The bearing of the device in degrees, relative to true north</li>
</ul>
<p>For more information see <a href="http://en.wikipedia.org/wiki/Geographic_coordinate">Geographic Coordinate</a>.</p>
<p>This data can be extracted through a variety of methods. One of the most well known methods of positioning is GPS (Global Positioning System), a publicly available system that uses radiowave signals received from Earth-orbiting satellites to calculate the precise position and time of the receiver. Another popular method is 'Cell Identifier Positioning', which uses the cell identifier of the cell site that is currently serving the receiving device to calculate its approximate location. These and other positioning methods can all be used with the Location API; the only requirement for a location data source within the API is that it provides a latitude-longitude coordinate with a date/time value, with the option of providing the other attributes listed above.</p>
<a name="coordinate"></a>
<h3>Coordinate</h3>
<p>The <a href="qml-coordinate.html">coordinate</a> is a basic unit of geographical information. The <a href="qml-coordinate.html">coordinate</a> type has attributes to hold the <tt>latitude</tt>, <tt>longitude</tt> and <tt>altitude</tt>.</p>
<a name="position"></a>
<h3>Position</h3>
<p>The three dimensional position of an object such as a mobile device can be specified by giving the latitude, longitude and altitude. That is the values held in the l {coordinate} type. Additionally for computation of future positions we would like to know if the object is moving, what <a href="qml-qtpositioning-position.html#speed-prop">speed</a> it is doing and what is the <a href="qml-qtpositioning-position.html#timestamp-prop">timestamp</a> of the last position data. Position therefore includes values for the <a href="qml-qtpositioning-position.html#coordinate-prop">coordinate</a>, <a href="qml-qtpositioning-position.html#speed-prop">speed</a> and a <a href="qml-qtpositioning-position.html#timestamp-prop">timestamp</a>. <a href="qml-qtpositioning-position.html">Position</a> also takes responsibility for validation of sensible values for these properties. These are exposed as the <a href="qml-qtpositioning-position.html#latitudeValid-prop">latitudeValid</a>, <a href="qml-qtpositioning-position.html#longitudeValid-prop">longitudeValid</a>, <a href="qml-qtpositioning-position.html#altitudeValid-prop">altitudeValid</a>, <a href="qml-qtpositioning-position.html#speedValid-prop">speedValid</a>, <a href="qml-qtpositioning-position.html#horizontalAccuracyValid-prop">horizontalAccuracyValid</a>, and <a href="qml-qtpositioning-position.html#verticalAccuracyValid-prop">verticalAccuracyValid</a> properties.</p>
<a name="positionsource"></a>
<h3>PositionSource</h3>
<p>We have a Position type, a <a href="qml-coordinate.html">coordinate</a> type but where does the data come from? Also it is a good idea to be able to indicate alternative sources. Perhaps instead of directly picking up GPS satellites it might be desirable to do some testing using a datafile.</p>
<p>The <a href="qml-qtpositioning-positionsource.html">PositionSource</a> type provides the developer with control, within the limits allowed by the platform, of the source of the geographical data. Apart from tradtional sources such as GPS and cell data the positional data can be sourced from a logfile which is in NMEA format.</p>
<p><a href="http://en.wikipedia.org/wiki/NMEA">NMEA</a> is a common text-based protocol for specifying navigational data. For convenience, the <a href="qml-qtpositioning-positionsource.html#nmeaSource-prop">nmeaSource</a> property is provided to enable QML applications to read NMEA data from a log file or a TCP socket, the source will emit updates according to the time stamp of each NMEA sentence to produce a "replay" of the recorded data. To use a TCP socket set the "socket" uri scheme.</p>
<pre class="cpp">PositionSource {
nmeaSource: <span class="string">"socket://127.0.0.1:12345"</span>
}</pre>
<a name="flickr-example"></a>
<h3><b>Flickr Example</b></h3>
<p>The <a href="qtpositioning-flickr-example.html">Flickr Example</a> uses the Location to download thumbnail images from Flickr relevant to the current location.</p>
</div>
<!-- @@@location-positioning-qml.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. Documentation contributions included herein are the copyrights of
their respective owners.<br> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br> Digia, Qt and their respective logos are trademarks of Digia Plc in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|