summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLars Sutterud <lars.sutterud@qt.io>2024-03-04 12:04:55 +0100
committerLars Sutterud <lars.sutterud@qt.io>2024-03-18 08:14:57 +0100
commit4c3ea1b6eb77a4c56707980bab79c36581925f94 (patch)
tree8633d84328223fae4818c2959aed52a731000798
parent8bfe72e8e386a6a7541e11593a4368bef4370875 (diff)
Lightning Viewer: Update docs to clearly state use of simulated data
Due to the lack of an agreement with the lightning strike data provider, we will only provide simulated lightning strike data for this demo. This change removes info in the documentation about the option to forward real world lightning data, and makes it more clear that the data is simulated. Fixes: QTBUG-122907 Pick-to: 6.7 Change-Id: Ibae18922e79393564b3947d813b1285f0358aaf9 Reviewed-by: MohammadHossein Qanbari <mohammad.qanbari@qt.io> Reviewed-by: Axel Spoerl <axel.spoerl@qt.io>
-rw-r--r--examples/demos/lightningviewer/doc/src/lightningviewer.qdoc27
1 files changed, 10 insertions, 17 deletions
diff --git a/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc b/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc
index 718398554..643792eb5 100644
--- a/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc
+++ b/examples/demos/lightningviewer/doc/src/lightningviewer.qdoc
@@ -19,10 +19,10 @@
\include examples-run.qdocinc
\section1 Overview
- \e{Lightning Viewer} is an application that receives lightning strike data
- from a \l{WebSocket} and displays it on a map in real-time. It features a
- responsive UI that adapts well to mobile, tablet and desktop-sized screens
- in both landscape and portrait orientation. Lightning strikes appear as
+ \e{Lightning Viewer} is an application that receives simulated lightning
+ strike data from a \l{WebSocket} and displays it on a map in real-time. It
+ features a responsive UI that adapts well to mobile, tablet and desktop-sized
+ screens in both landscape and portrait orientation. Lightning strikes appear as
icons on the map, and a separate overlay shows the distance and time of the
last strike. These data layers can be hidden and revealed with toggles that
are accessed by pressing the map layers button. There is also a switch for
@@ -38,7 +38,7 @@
interaction. The \c Controller class manages the data flow between the
\c LightningItemModel and the QML components. The \c LightningProvider class
opens a \l{WebSocket} connection to an online server from which it receives
- a JSON message for each occurring lightning strike. It parses the messages
+ a JSON message for each simulated lightning strike. It parses the messages
and passes the data on to the \c LightningItemModel via a signal connected
to a slot in the \c Controller:
@@ -71,22 +71,15 @@
they are placed in a \l{Drawer} defined in \c MapLayersDrawer.qml.
\section1 Lightning strike data source
- The application receives lightning strike data from a server maintained by
- Qt. The server provides a WebSocket API accepting connections on the
- following URL:
+ The application receives simulated lightning strike data from a server
+ maintained by Qt. The server provides a WebSocket API accepting connections
+ on the following URL:
\code
wss://ewea0y4bn0.execute-api.eu-north-1.amazonaws.com/production/
\endcode
-
- When connected, the server accepts two different JSON messages, included in
- \c lightningprovider.cpp as strings with backslashes to escape
- double-quotes. The first message will trigger the API to forward real world
- lightning strikes. The availability or accuracy of this data can not be
- guaranteed, as it depends on third party data providers. As an alternative
- solution, the second message will trigger the API to send simulated
- lightning strike data:
+ After connecting to the server, the application triggers the live data feed
+ by sending the following JSON message to the server:
\code
- "{\"action\": \"forwardlightningdata\"}"
"{\"action\": \"simulatelightningdata\"}"
\endcode