Component: Location ( Data): Difference between revisions
Created page with "{| style="width:50%" |- | width="20%" style="color:gray;" | Author | MatrixTSL |- | width="20%" style="color:gray;" | Version | 1.0 |- | width="20%" style="color:gray;..." |
m Text replacement - "style="background-color:#EAE1EA;"" to "class="mtx-class-propfolder"" |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 13: | Line 13: | ||
==Location component== | ==Location component== | ||
Component that provides the mobile device's physical location | Component that provides the mobile device's physical location. | ||
==Version information== | ==Version information== | ||
| Line 21: | Line 22: | ||
==Detailed description== | |||
Many mobile devices have the capability of reporting the physical location of the device (e.g. by using an internal GPS sensor). | |||
This component allows access to this information. | |||
==Examples== | ==Examples== | ||
===Plotting geolocation data=== | |||
This example regularly plots the current location of the device onto a canvas object. | |||
{{Fcfile|GeolocationPlotter.fcweb|GeolocationPlotter.fcweb}} | |||
The web app created by this example can be viewed here: [https://www.flowcode.co.uk/example/WebComps/GeolocationPlotter.html GeolocationPlotter Example] | |||
| Line 35: | Line 42: | ||
===Cancel=== | ===Cancel=== | ||
{| class="wikitable | {| class="mtx-class-macrotable wikitable" | ||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''Cancel''' | ||
|- | |- | ||
| colspan="2" | Cancels any continuous retrieval of location information. | | colspan="2" | Cancels any continuous retrieval of location information. | ||
| Line 49: | Line 56: | ||
===GetPosition=== | ===GetPosition=== | ||
{| class="wikitable | {| class="mtx-class-macrotable wikitable" | ||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''GetPosition''' | ||
|- | |- | ||
| colspan="2" | Asks the device to return position information. The OnSuccess callback will be called with appropriate location information is successful. If unsuccessful, the OnFailure callback will provide the reason for failure. Returns false if geolocation is not supported by the browser. | | colspan="2" | Asks the device to return position information. The OnSuccess callback will be called with appropriate location information is successful. If unsuccessful, the OnFailure callback will provide the reason for failure. Returns false if geolocation is not supported by the browser. | ||
| Line 69: | Line 76: | ||
==Property reference== | ==Property reference== | ||
{| class="wikitable | {| class="mtx-class-macrotable wikitable" | ||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]] | ||
| width="90%" | | width="90%" class="mtx-class-macrohead" | '''Properties''' | ||
|- | |- | ||
|- | |- | ||
| Line 85: | Line 92: | ||
| colspan="2" | Called when position info is not returned successfully | | colspan="2" | Called when position info is not returned successfully | ||
|- | |- | ||
| width="10%" align="center" | | width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]] | ||
| width="90%" | | width="90%" class="mtx-class-propfolder" | Options | ||
|- | |- | ||
|- | |- | ||
Latest revision as of 14:37, 13 July 2026
| Author | MatrixTSL |
| Version | 1.0 |
| Category | Data |
Location component
Component that provides the mobile device's physical location.
Version information
Library Version, Component Version, Date, Author, Info 1, 1.0, 23-04-26, ST, Created
Detailed description
Many mobile devices have the capability of reporting the physical location of the device (e.g. by using an internal GPS sensor).
This component allows access to this information.
Examples
Plotting geolocation data
This example regularly plots the current location of the device onto a canvas object.
The web app created by this example can be viewed here: GeolocationPlotter Example
Macro reference
Cancel
|
Cancel |
| Cancels any continuous retrieval of location information. | |
 - VOID
|
Return |
GetPosition
|
|
GetPosition |
| Asks the device to return position information. The OnSuccess callback will be called with appropriate location information is successful. If unsuccessful, the OnFailure callback will provide the reason for failure. Returns false if geolocation is not supported by the browser. | |
 - BOOL
|
Continuous |
| Set to true to continually monitor the position and receive a callback whenever the location has changed | |
| - BOOL
|
Return |
Property reference
|
Properties |
|
OnSuccess |
| Called when position info is successfully found. Latitude, longitude and altitude are provided as parameters. The raw object is also provided for advanced information. | |
|
|
OnFailure |
| Called when position info is not returned successfully | |
|
Options |
|
MaximumAge |
| Maximum age (in ms) of a possible cached position that is acceptable to return. A value of 0 means the device must always attempt to retrieve to actual current position. | |
|
|
Timeout |
| The maximum time (in ms) that the device can take when trying to retrieve a position. | |
|
HighAccuracy |
| Using High Accuracy will provide a more accurate position, but may be slower and increase power consumption. | |
Component Source Code
Please click here to download the component source project: FC_Comp_Source_WEBEXP_Geolocation.fcsx
Please click here to view the component source code (Beta): FC_Comp_Source_WEBEXP_Geolocation.fcsx