Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/myflashlab/GPS-ANE
GPS AIR Native Extension gives you access to device's gps tool
https://github.com/myflashlab/GPS-ANE
Last synced: 3 months ago
JSON representation
GPS AIR Native Extension gives you access to device's gps tool
- Host: GitHub
- URL: https://github.com/myflashlab/GPS-ANE
- Owner: myflashlab
- Archived: true
- Created: 2015-09-18T11:39:40.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-08-06T11:11:57.000Z (over 4 years ago)
- Last Synced: 2024-08-03T05:03:13.145Z (6 months ago)
- Language: ActionScript
- Homepage:
- Size: 45.4 MB
- Stars: 15
- Watchers: 6
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
Awesome Lists containing this project
- awesome-actionscript-sorted - GPS-ANE - get current device GPS location as fast as possible by automatically checking the best available provider (Native Extension / Hardware ANE)
README
# GPS ANE for Android+iOS
Although there is a GPS API coming with AIR SDK, in a real app development scenario, you need a better GPS solution. You need an exact and faster Gps solution which you can really trust. That's why we decided to build this cool GPS extension. it's highly optimized for automatic provider picker to ensure your app will get user location as fast as possible even if indoor. it's also optimized for battery usage so you don't have to worry about your app's battery usage at all. try the extension right now for free and see how fast it is.
**Main Features:**
* start/stop GPS service periodically
* get one time location finder for better battery usage
* geocoding reverse to convert gps coordinates to real addresses
* geocoding reverse to convert gps coordinates to real addresses
[find the latest **asdoc** for this ANE here.](http://myflashlab.github.io/asdoc/com/myflashlab/air/extensions/gps/package-detail.html)
# AIR Usage - location
For the complete AS3 code usage, see the [demo project here](https://github.com/myflashlab/GPS-ANE/blob/master/AIR/src/MainFinal.as).
```actionscript
import com.myflashlab.air.extensions.gps.*;
/*
Make sure you have asked for location permission using the
permissionCheck ANE.
*/
Gps.init(); // call init only once in your project
// will return null if no known last location has been found
Gps.location.getLastLocation(onLocationResult);
// may take a while depending on when gps info is found
Gps.location.getCurrentLocation(onLocationResult);
function onLocationResult($result:Location):void
{
if (!$result)
{
trace("location is null");
return;
}
trace("accuracy = " + $result.accuracy);
trace("altitude = " + $result.altitude);
trace("bearing = " + $result.bearing);
trace("latitude = " + $result.latitude);
trace("longitude = " + $result.longitude);
trace("provider = " + $result.provider);
trace("speed = " + $result.speed);
trace("time = " + $result.time);
trace("---------------------------------");
}
// use the start method to get gps information periodically (the gps icon will be shown at your device status bar)
Gps.location.addEventListener(GpsEvent.LOCATION_UPDATE, onLocationUpdate);
Gps.location.start(LocationAccuracy.HIGH, 0, 5000);
// simply stop the gps service when you don't need to get location information periodically anymore.
Gps.location.removeEventListener(GpsEvent.LOCATION_UPDATE, onLocationUpdate);
Gps.location.stop();
function onLocationUpdate(e:GpsEvent):void
{
trace(" ------------------------------- onLocationUpdate");
var loc:Location = e.param;
trace("accuracy = " + loc.accuracy);
trace("altitude = " + loc.altitude);
trace("bearing = " + loc.bearing);
trace("latitude = " + loc.latitude);
trace("longitude = " + loc.longitude);
trace("provider = " + loc.provider);
trace("speed = " + loc.speed);
trace("time = " + loc.time);
trace("---------------------------------");
}
```
# AIR Usage - Geocoding
```actionscript
Gps.geocoding.reverse(-33.7969235, 150.9224326, onResultGeocodingReverse);
function onResultGeocodingReverse($address:Array):void
{
// there might be more than one address found for this location
trace("$address.length = " + $address.length);
trace("$address = " + JSON.stringify($address));
trace("-----------------------------");
}
Gps.geocoding.direct("Sydney", onResultGeocodingDirect);
function onResultGeocodingDirect($location:Array):void
{
// there might be more than one location found for this address
trace("$location.length = " + $location.length);
trace("$location = " + JSON.stringify($location));
trace("-----------------------------");
}
```
# AIR .xml manifest
```xml
MinimumOSVersion
10.0
UIStatusBarStyle
UIStatusBarStyleBlackOpaque
UIRequiresPersistentWiFi
NO
UIPrerenderedIcon
NSLocationWhenInUseUsageDescription
I need location reason
NSLocationAlwaysUsageDescription
I need location reason
NSLocationAlwaysAndWhenInUseUsageDescription
I need location reason
UIDeviceFamily
1
2
com.myflashlab.air.extensions.gps
com.myflashlab.air.extensions.permissionCheck
com.myflashlab.air.extensions.dependency.androidx.core
com.myflashlab.air.extensions.dependency.androidx.lifecycle
com.myflashlab.air.extensions.dependency.overrideAir
com.myflashlab.air.extensions.dependency.googlePlayServices.base
com.myflashlab.air.extensions.dependency.googlePlayServices.basement
com.myflashlab.air.extensions.dependency.googlePlayServices.location
-->
```
# Requirements
* Android API 19+
* iOS SDK 10.0+
* AIR SDK 33+
# Permissions
Below are the list of Permissions this ANE might require. Check out the demo project available at this repository to see how we have used the [PermissionCheck ANE](http://www.myflashlabs.com/product/native-access-permission-check-settings-menu-air-native-extension/) to ask for the permissions.
Necessary | Optional
--------------------------- | ---------------------------
[SOURCE_LOCATION](https://myflashlab.github.io/asdoc/com/myflashlab/air/extensions/nativePermissions/PermissionCheck.html#SOURCE_LOCATION) for Android | [SOURCE_LOCATION_ALWAYS](https://myflashlab.github.io/asdoc/com/myflashlab/air/extensions/nativePermissions/PermissionCheck.html#SOURCE_LOCATION_ALWAYS) for iOS
[SOURCE_LOCATION_WHEN_IN_USE](https://myflashlab.github.io/asdoc/com/myflashlab/air/extensions/nativePermissions/PermissionCheck.html#SOURCE_LOCATION_WHEN_IN_USE) for iOS | -
# Commercial Version
https://www.myflashlabs.com/product/gps-ane-adobe-air-native-extension/
[](https://www.myflashlabs.com/product/gps-ane-adobe-air-native-extension/)
# Tutorials
[How to embed ANEs into **FlashBuilder**, **FlashCC** and **FlashDevelop**](https://www.youtube.com/watch?v=Oubsb_3F3ec&list=PL_mmSjScdnxnSDTMYb1iDX4LemhIJrt1O)
# Premium Support #
[](https://www.myflashlabs.com/product/myflashlabs-support/)
If you are an [active MyFlashLabs club member](https://www.myflashlabs.com/product/myflashlabs-club-membership/), you will have access to our private and secure support ticket system for all our ANEs. Even if you are not a member, you can still receive premium help if you purchase the [premium support package](https://www.myflashlabs.com/product/myflashlabs-support/).