Component: Location ( Data): Difference between revisions

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.

GeolocationPlotter.fcweb

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

@@ Line 45: / Line 45: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Cancel'''
+| width="90%" class="mtx-class-macrohead" | '''Cancel'''
 |-
 | colspan="2" | Cancels any continuous retrieval of location information.&nbsp;
@@ Line 59: / Line 59: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetPosition'''
+| 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.&nbsp;
@@ Line 79: / Line 79: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
@@ Line 92: / Line 92: @@
 | colspan="2" | Called when position info is not returned successfully&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Options
+| width="90%" class="mtx-class-propfolder" | Options
 |-
 |-

SteveT (talk | contribs)