moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-21 08:45:04 -05:00
Code Issues Releases Wiki Activity

1.6rc2: defined <accuracy/> element to obsolete <error/> element

Browse Source 
git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@2317 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Peter Saint-Andre 2008-10-03 01:12:09 +00:00
parent 4d7ab04fd0
commit 85b2f3c154
1 changed files with 18 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
xep-0080.xml
View File

@ -26,10 +26,10 @@
&hildjj;
&stpeter;
<revision>
<version>1.6rc1</version>
<date>in progress, last updated 2008-09-25</date>
<initials>psa</initials>
<remark><p>Allowed empty geoloc element to signify a pause in publishing.</p></remark>
<version>1.6rc2</version>
<date>in progress, last updated 2008-10-02</date>
<initials>psa/jjh</initials>
<remark><p>Allowed empty geoloc element to signify a pause in publishing; added &lt;accuracy/&gt; element and deprecated &lt;error/&gt; element to change horizontal GPS error from arc minutes to meters, consistent with IMPS and other formats.</p></remark>
</revision>
<revision>
<version>1.5</version>
@ -150,6 +150,12 @@
<th>Definition</th>
<th>Example</th>
</tr>
<tr>
<td>accuracy</td>
<td>xs:decimal</td>
<td>Horizontal GPS error in meters; this element obsoletes the &lt;error/&gt; element</td>
<td>10</td>
</tr>
<tr>
<td>alt</td>
<td>xs:decimal</td>
@ -195,8 +201,8 @@
<tr>
<td>error</td>
<td>xs:decimal</td>
<td>Horizontal GPS error in arc minutes</td>
<td>10</td>
<td>Horizontal GPS error in arc minutes; this element is deprecated in favor of &lt;accuracy/&gt;</td>
<td>290.8882087</td>
</tr>
<tr>
<td>floor</td>
@ -287,6 +293,7 @@
<lat>45.44</lat>
<locality>Venice</locality>
<lon>12.33</lon>
<accuracy>20</accuracy>
</geoloc>
</item>
</publish>
@ -304,6 +311,7 @@
<lat>45.44</lat>
<locality>Venice</locality>
<lon>12.33</lon>
<accuracy>20</accuracy>
</geoloc>
</item>
</items>
@ -340,7 +348,7 @@
</section1>
<section1 topic='Implementation Notes' anchor='impl'>
<p>Avoid "Mars probe" issues: as specified in Table 1, the units for &lt;lat/&gt; and &lt;lon/&gt; MUST be decimal degrees (where South and West are negative, North and East are positive), the units for &lt;alt/&gt; MUST be meters above or below sea level, and the units for &lt;error/&gt; MUST be arc minutes.</p>
<p>Avoid "Mars probe" issues: as specified in Table 1, the units for &lt;lat/&gt; and &lt;lon/&gt; MUST be decimal degrees (where South and West are negative, North and East are positive), the units for &lt;alt/&gt; MUST be meters above or below sea level, and the units for &lt;accuracy/&gt; MUST be meters. <note>The &lt;accuracy/&gt; element obsoletes the older &lt;error/&gt; element, which specified units of arc minutes intead of meters.</note></p>
<p>In applications where updates are sent whenever there is a certain distance change in location, those applications SHOULD account for time as well, to avoid rate-limiting when the user is (for example) on a jet plane. One possible way to do this would be to send updates at most once per minute of time (every time 60 seconds have elapsed).</p>
<p>Inferences SHOULD NOT be made about accuracy from the number of digits specified in the location or altitude.</p>
<p>Why the datum madness? See &lt;<link url='http://www.xmpp.org/extensions/gps_datum.html'>http://www.xmpp.org/extensions/gps_datum.html</link>&gt; for an example.</p>
@ -428,9 +436,9 @@
<td align='center'>&lt;EXTADR/&gt;</td>
</tr>
<tr>
<td align='center'>--</td>
<td align='center'>&lt;accuracy/&gt;</td>
<td align='center'>&lt;Accuracy/&gt;
<note>This element provides accuracy in meters. The location protocol defined in XEP-0080 specifies such an element for XMPP, which SHOULD be used when mapping from IMPS to XMPP.</note>
<note>This element specifies accuracy in meters. When mapping from IMPS to XMPP, the IMPS &lt;Accuracy/&gt; element SHOULD be mapped to the XMPP &lt;accuracy/&gt; element (which specifies accuracy in meters), not the deprecated &lt;error/&gt; element (which specified accuracy in arc minutes).</note>
</td>
<td align='center'>--</td>
<td align='center'>--</td>
@ -484,6 +492,7 @@
<xs:element name='geoloc'>
<xs:complexType>
<xs:sequence minOccurs='0'>
<xs:element name='accuracy' minOccurs='0' type='xs:decimal'/>
<xs:element name='alt' minOccurs='0' type='xs:decimal'/>
<xs:element name='area' minOccurs='0' type='xs:string'/>
<xs:element name='bearing' minOccurs='0' type='xs:decimal'/>