{"id":8620,"date":"2022-11-03T14:50:48","date_gmt":"2022-11-03T14:50:48","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=8620"},"modified":"2022-11-06T00:00:41","modified_gmt":"2022-11-06T00:00:41","slug":"web-api-display-users-by-fixed-float-state","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-display-users-by-fixed-float-state\/","title":{"rendered":"Web API, Display Users by Fixed \/ Float State"},"content":{"rendered":"<p>This article describes the contents of the <strong><em>Display Users By RTK State <\/em><\/strong><em>Report <\/em>which the Web API provides.\u00a0 <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> allows requesting this report remotely with any browser by authorized users.\u00a0 An active <a href=\"https:\/\/www.use-snip.com\/downloads\/snip_web\/\">Web API Plug-in<\/a> is required for this feature.\u00a0 First <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-login\/\"><strong>Login<\/strong> <\/a>from an authorized account with either <em>read-write<\/em> privileges, or with <em>read-only<\/em> privileges.<\/p>\n<p>You reach this report by traversing from the Web <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-top-page\/\">Top Page<\/a> to the section marked \u00a0<em>Current Client Connections and Accounts<\/em> then press the button <strong>Users-FFA<\/strong>.\u00a0 [<span style=\"color: #008000;\"><strong>Aside<\/strong><\/span>: The button <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-display-all-connected-users\/\"><strong>Users-ALL<\/strong><\/a>\u00a0 displays all the connected users both with and without any NMEA information, sorted by the Base station being used.]<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignright wp-image-8630\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-201x300.png\" alt=\"\" width=\"340\" height=\"507\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-201x300.png 201w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-687x1024.png 687w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-768x1145.png 768w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-34x50.png 34w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-920x1372.png 920w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-600x895.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed-320x477.png 320w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/ReportUsers_wFFAgreyed.png 1018w\" sizes=\"auto, (max-width: 340px) 100vw, 340px\" \/><\/a>The Report entries are sorted into three groups:<\/p>\n<ul>\n<li>Users in a <span style=\"color: #339966;\"><strong>Fixed RTK<\/strong><\/span> State<\/li>\n<li>Users in a <span style=\"color: #ff6600;\"><strong>Float RTK<\/strong><\/span> State<\/li>\n<li>Users in an <span style=\"color: #000000;\"><strong>Autonomous<\/strong><\/span> RTK State (and \u00a0any other state)<\/li>\n<\/ul>\n<p>At the right is a report fragment showing some representative connections (click to enlarge). The data and the links have been mangled to preserve privacy.<\/p>\n<p>The format used is similar to the one in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-display-all-connected-users\/\"><em>Display Connected Users<\/em><\/a> report.<\/p>\n<p>A summary of the connection is provided (data in and out and the time connected). The <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/a-table-of-the-most-common-html-agent-strings-used-by-ntrip-clients\/\">NTRIP Agent string<\/a> is also presented. \u00a0The last <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/nmea-gga-strings-in-ntrip-clients\/\">NMEA sentence<\/a> is also presented, and the LLH data is decoded and shown along with the distance to the base and the Fixed\/Float mode.<\/p>\n<p>You can easily look at the details of these connections.\u00a0 At the right (this image was taken from the RTK2go.com Caster on November 3rd 2022) you will see a variety of <strong>fixed<\/strong> RTK users with connection times ranging from minutes to several hours and thousands of NMEA messages.\u00a0 Similar information can be seen at the bottom of the report for the users who are reporting an <strong>anonymous<\/strong> navigation mode (often such users are in fact using RTK but not reporting it in the NMEA $GGA sentences).<\/p>\n<p>In the middle section (those users with a <strong>float<\/strong> state of RTK) you can see three users.\u00a0 Often this is the section you will want to look at closely to try to determine why a given user (<a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/question-what-is-an-ntrip-client\/\">NTRIP Client<\/a> device) has not been able to move from float into a fixed mode. Here we see that two of the users have each been connected for several hours, the other for just over 4 minutes.\u00a0 Looking further, we can see that the baseline distance for each of these is rather large (42.4, 17.3, and 80.5 km) and this likely explains the inability to reach a fixed mode.<\/p>\n<p>Be aware also that this report shows the last $GGA sentence, and it may be that the user was in another mode before that point.\u00a0 You can plot the user&#8217;s prior position using the fixed\/float value as a color theme (see <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-plots-with-themes\/\">this article<\/a> and the section <strong>Colorize by GNSS State<\/strong>) when there is a need to explore this further.<\/p>\n<p>In the same way commonly used by most Web API reports, these links connect to related reports about:<\/p>\n<ul>\n<li>The <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-base-reports\/\">Base Station<\/a><\/li>\n<li>The <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/web-api-user-reports\/\">User Connection<\/a><\/li>\n<li>The <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/common-ips-tasks\/\">IP used<\/a><\/li>\n<\/ul>\n<p>And each of these provides suitable Google maps and movement plots as are appropriate.<\/p>\n<h3>The Connected users Dialog<\/h3>\n<p>One can also quickly see the Fixed &#8211; Float state of connected users in the <a href=\"https:\/\/www.use-snip.com\/kb\/knowledge-base\/viewing-current-users\/\">Connected Users Dialog<\/a> box.\u00a0 A newly added column shows the reported NMEA fix state (fix\/float\/anon) in a colorized form.\u00a0 This is displayed before the NMEA count and NMEA Age columns. \u00a0\u00a0Like other columns, this is sort-able when you click on the header.<\/p>\n<p><a href=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-8627\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-300x129.png\" alt=\"\" width=\"509\" height=\"219\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-300x129.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-768x330.png 768w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-50x22.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-920x396.png 920w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-600x258.png 600w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA-320x138.png 320w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2022\/11\/CurrentUsers_wFFA.png 1018w\" sizes=\"auto, (max-width: 509px) 100vw, 509px\" \/><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>This article describes the contents of the Display Users By RTK State Report which the Web API provides.\u00a0 SNIP allows requesting this report remotely with any browser by authorized users.\u00a0 An active Web API Plug-in is required for this feature.\u00a0 First Login from an authorized account with either read-write privileges, [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[418],"ht-kb-tag":[247,201,263,222],"class_list":["post-8620","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-reports","ht_kb_tag-nmea-gga","ht_kb_tag-reports","ht_kb_tag-rtk","ht_kb_tag-user-connections"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8620","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=8620"}],"version-history":[{"count":13,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8620\/revisions"}],"predecessor-version":[{"id":8656,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/8620\/revisions\/8656"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=8620"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=8620"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=8620"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}