Difference between revisions of "Geolocation"

From GiderosMobile
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
<languages />
 
<!-- GIDEROSOBJ:Geolocation -->
 
'''<translate>Supported platforms</translate>:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform winrt.png]]<br/>
 
'''<translate>Available since</translate>:''' Gideros 2012.8<br/>
 
'''<translate>Inherits from</translate>:''' [[Special:MyLanguage/Object|Object]]<br/>
 
=== <translate>Description</translate> ===
 
<translate><br />
 
The [[Special:MyLanguage/Geolocation|Geolocation]] class is used to configure the parameters and dispatching of location and heading related events.<br />
 
<br /></translate>
 
=== <translate>Examples</translate> ===
 
'''Example'''<br/>
 
<source lang="lua">geolocation = Geolocation.new()
 
  
 +
'''Supported platforms:''' [[File:Platform android.png]][[File:Platform ios.png]][[File:Platform winrt.png]]<br/>
 +
'''Available since:''' Gideros 2012.8<br/>
 +
'''Inherits from:''' [[Object]]<br/>
 +
 +
=== Description ===
 +
The [[Geolocation]] class is used to configure the parameters and dispatching of location and heading related events.
 +
 +
=== Examples ===
 +
 +
<source lang="lua">
 +
geolocation = Geolocation.new()
 
local function onLocationUpdate(event)
 
local function onLocationUpdate(event)
 
print("location: ", event.latitude, event.longitude, event.altitude)
 
print("location: ", event.latitude, event.longitude, event.altitude)
Line 23: Line 22:
 
geolocation:addEventListener(Event.LOCATION_UPDATE, onLocationUpdate)
 
geolocation:addEventListener(Event.LOCATION_UPDATE, onLocationUpdate)
 
geolocation:addEventListener(Event.HEADING_UPDATE, onHeadingUpdate)
 
geolocation:addEventListener(Event.HEADING_UPDATE, onHeadingUpdate)
geolocation:start()</source>
+
geolocation:start()
 +
</source>
 +
 
 
{|-
 
{|-
 +
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
=== <translate>Methods</translate> ===
+
 
[[Special:MyLanguage/Geolocation.getAccuracy|Geolocation.getAccuracy]] ''<translate>returns the previously set desired accuracy</translate>''<br/><!-- GIDEROSMTD:Geolocation.getAccuracy() returns the previously set desired accuracy -->
+
=== Methods ===
[[Special:MyLanguage/Geolocation.getThreshold|Geolocation.getThreshold]] ''<translate>returns the previously set minimum distance threshold</translate>''<br/><!-- GIDEROSMTD:Geolocation.getThreshold() returns the previously set minimum distance threshold -->
+
[[Geolocation.getAccuracy]] ''returns the previously set desired accuracy''<br/>
[[Special:MyLanguage/Geolocation.isAvailable|Geolocation.isAvailable]] ''<translate>does this device have the capability to determine current location?</translate>''<br/><!-- GIDEROSMTD:Geolocation.isAvailable() does this device have the capability to determine current location? -->
+
[[Geolocation.getThreshold]] ''returns the previously set minimum distance threshold''<br/>
[[Special:MyLanguage/Geolocation.isHeadingAvailable|Geolocation.isHeadingAvailable]] ''<translate>does this device have the capability to determine heading?</translate>''<br/><!-- GIDEROSMTD:Geolocation.isHeadingAvailable() does this device have the capability to determine heading? -->
+
[[Geolocation.isAvailable]] ''does this device have the capability to determine current location?''<br/>
[[Special:MyLanguage/Geolocation.new|Geolocation.new]] ''<translate>Creates new Geolocation instance</translate>''<br/><!-- GIDEROSMTD:Geolocation.new() Creates new Geolocation instance -->
+
[[Geolocation.isHeadingAvailable]] ''does this device have the capability to determine heading?''<br/>
[[Special:MyLanguage/Geolocation.setAccuracy|Geolocation.setAccuracy]] ''<translate>of the location data</translate>''<br/><!-- GIDEROSMTD:Geolocation.setAccuracy(accuracy) of the location data -->
+
[[Geolocation.new]] ''Creates new Geolocation instance''<br/>
[[Special:MyLanguage/Geolocation.setThreshold|Geolocation.setThreshold]] ''<translate>threshold</translate>''<br/><!-- GIDEROSMTD:Geolocation.setThreshold(threshold) threshold -->
+
[[Geolocation.setAccuracy]] ''of the location data''<br/>
[[Special:MyLanguage/Geolocation:start|Geolocation:start]] ''<translate>starts the generation of updates that report the current location and heading</translate>''<br/><!-- GIDEROSMTD:Geolocation:start() starts the generation of updates that report the current location and heading -->
+
[[Geolocation.setThreshold]] ''threshold''<br/>
[[Special:MyLanguage/Geolocation:startUpdatingHeading|Geolocation:startUpdatingHeading]] ''<translate>starts the generation of updates that report the heading</translate>''<br/><!-- GIDEROSMTD:Geolocation:startUpdatingHeading() starts the generation of updates that report the heading -->
+
[[Geolocation:start]] ''starts the generation of updates that report the current location and heading''<br/>
[[Special:MyLanguage/Geolocation:startUpdatingLocation|Geolocation:startUpdatingLocation]] ''<translate>starts the generation of updates that report the current location</translate>''<br/><!-- GIDEROSMTD:Geolocation:startUpdatingLocation() starts the generation of updates that report the current location -->
+
[[Geolocation:startUpdatingHeading]] ''starts the generation of updates that report the heading''<br/>
[[Special:MyLanguage/Geolocation:stop|Geolocation:stop]] ''<translate>stops the generation of updates that report the current location and heading</translate>''<br/><!-- GIDEROSMTD:Geolocation:stop() stops the generation of updates that report the current location and heading -->
+
[[Geolocation:startUpdatingLocation]] ''starts the generation of updates that report the current location''<br/>
[[Special:MyLanguage/Geolocation:stopUpdatingHeading|Geolocation:stopUpdatingHeading]] ''<translate>stops the generation of updates that report the heading</translate>''<br/><!-- GIDEROSMTD:Geolocation:stopUpdatingHeading() stops the generation of updates that report the heading -->
+
[[Geolocation:stop]] ''stops the generation of updates that report the current location and heading''<br/>
[[Special:MyLanguage/Geolocation:stopUpdatingLocation|Geolocation:stopUpdatingLocation]] ''<translate>stops the generation of updates that report the current location</translate>''<br/><!-- GIDEROSMTD:Geolocation:stopUpdatingLocation() stops the generation of updates that report the current location -->
+
[[Geolocation:stopUpdatingHeading]] ''stops the generation of updates that report the heading''<br/>
 +
[[Geolocation:stopUpdatingLocation]] ''stops the generation of updates that report the current location''<br/>
 +
 
 
| style="width: 50%; vertical-align:top;"|
 
| style="width: 50%; vertical-align:top;"|
=== <translate>Events</translate> ===
+
 
[[Special:MyLanguage/Event.ERROR|Event.ERROR]]<br/><!-- GIDEROSEVT:Event.ERROR error-->
+
=== Events ===
[[Special:MyLanguage/Event.HEADING_UPDATE|Event.HEADING_UPDATE]]<br/><!-- GIDEROSEVT:Event.HEADING_UPDATE headingUpdate-->
+
[[Event.ERROR]]<br/>
[[Special:MyLanguage/Event.LOCATION_UPDATE|Event.LOCATION_UPDATE]]<br/><!-- GIDEROSEVT:Event.LOCATION_UPDATE locationUpdate-->
+
[[Event.HEADING_UPDATE]]<br/>
=== <translate>Constants</translate> ===
+
[[Event.LOCATION_UPDATE]]<br/>
 +
 
 +
=== Constants ===
 +
 
 
|}
 
|}
 +
 +
----
 +
{{Special:PrefixIndex/Geolocation}}
 +
<br/>
 +
 +
{{Special:PrefixIndex/Event.ERROR}}
 +
{{Special:PrefixIndex/Event.HEADING_UPDATE}}
 +
{{Special:PrefixIndex/Event.LOCATION_UPDATE}}
 +
<br/>

Revision as of 23:22, 2 December 2019


Supported platforms: Platform android.pngPlatform ios.pngPlatform winrt.png
Available since: Gideros 2012.8
Inherits from: Object

Description

The Geolocation class is used to configure the parameters and dispatching of location and heading related events.

Examples

geolocation = Geolocation.new()
local function onLocationUpdate(event)
	print("location: ", event.latitude, event.longitude, event.altitude)
end

local function onHeadingUpdate(event)
	print("heading: ", event.magneticHeading, event.trueHeading)
end

geolocation:addEventListener(Event.LOCATION_UPDATE, onLocationUpdate)
geolocation:addEventListener(Event.HEADING_UPDATE, onHeadingUpdate)
geolocation:start()

Methods

Geolocation.getAccuracy returns the previously set desired accuracy
Geolocation.getThreshold returns the previously set minimum distance threshold
Geolocation.isAvailable does this device have the capability to determine current location?
Geolocation.isHeadingAvailable does this device have the capability to determine heading?
Geolocation.new Creates new Geolocation instance
Geolocation.setAccuracy of the location data
Geolocation.setThreshold threshold
Geolocation:start starts the generation of updates that report the current location and heading
Geolocation:startUpdatingHeading starts the generation of updates that report the heading
Geolocation:startUpdatingLocation starts the generation of updates that report the current location
Geolocation:stop stops the generation of updates that report the current location and heading
Geolocation:stopUpdatingHeading stops the generation of updates that report the heading
Geolocation:stopUpdatingLocation stops the generation of updates that report the current location

Events

Event.ERROR
Event.HEADING_UPDATE
Event.LOCATION_UPDATE

Constants