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.
For the complete AS3 code usage, see the demo project here.
import com.myflashlab.air.extensions.gps.Gps;
import com.myflashlab.air.extensions.gps.LocationAccuracy;
import com.myflashlab.air.extensions.gps.Location;
import com.myflashlab.air.extensions.gps.GpsEvent;
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("---------------------------------");
} 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("-----------------------------");
}<!--
FOR ANDROID:
-->
<manifest android:installLocation="auto">
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.INTERNET" />
<!--The new Permission thing on Android works ONLY if you are targetting Android SDK 23 or higher-->
<uses-sdk android:targetSdkVersion="23"/>
<!-- required for GPS -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="com.google.android.providers.gsf.permission.READ_GSERVICES" />
<uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" />
<application android:hardwareAccelerated="true" android:allowBackup="true">
<activity android:hardwareAccelerated="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.BROWSABLE" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
<!-- required for GPS -->
<service android:name="io.nlopez.smartlocation.geocoding.providers.AndroidGeocodingProvider$AndroidGeocodingService" android:exported="false" />
<service android:name="io.nlopez.smartlocation.activity.providers.ActivityGooglePlayServicesProvider$ActivityRecognitionService" android:exported="false" />
<service android:name="io.nlopez.smartlocation.geofencing.providers.GeofencingGooglePlayServicesProvider$GeofencingService" android:exported="false" />
<meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
</application>
</manifest>
<!--
FOR iOS:
-->
<InfoAdditions>
<key>MinimumOSVersion</key>
<string>8.0</string>
<key>UIStatusBarStyle</key>
<string>UIStatusBarStyleBlackOpaque</string>
<key>UIRequiresPersistentWiFi</key>
<string>NO</string>
<key>UIPrerenderedIcon</key>
<true />
<!--required for GPS-->
<key>NSLocationUsageDescription</key>
<string>I need location UsageDescription</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>I need location WhenInUseUsageDescription</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>I need location AlwaysUsageDescription</string>
<key>UIDeviceFamily</key>
<array>
<!-- iPhone support -->
<string>1</string>
<!-- iPad support -->
<string>2</string>
</array>
</InfoAdditions>
<!--
Embedding the ANE:
-->
<extensions>
<extensionID>com.myflashlab.air.extensions.gps</extensionID>
<!-- Required if you are targeting AIR 24+ and have to take care of Permissions mannually -->
<extensionID>com.myflashlab.air.extensions.permissionCheck</extensionID>
<!-- download the dependency ANEs from https://github.com/myflashlab/common-dependencies-ANE -->
<extensionID>com.myflashlab.air.extensions.dependency.androidSupport</extensionID>
<extensionID>com.myflashlab.air.extensions.dependency.overrideAir</extensionID>
<extensionID>com.myflashlab.air.extensions.dependency.googlePlayServices.base</extensionID>
<extensionID>com.myflashlab.air.extensions.dependency.googlePlayServices.basement</extensionID>
<extensionID>com.myflashlab.air.extensions.dependency.googlePlayServices.location</extensionID>
</extensions>
-->- Android API 15 or higher
- iOS SDK 8.0 or higher
- AIR SDK 27 or higher
- This ANE is dependent on androidSupport.ane, googlePlayServices_base.ane, googlePlayServices_basement.ane, googlePlayServices_location.ane and overrideAir.ane You need to add these ANEs to your project too. Download them from here:
- on Android you have to compile on debug or captive (shared compilation will fail)
If you are targeting AIR 24 or higher, you need to take care of the permissions mannually. Below are the list of Permissions this ANE might require. (Note: Necessary Permissions are those that the ANE will NOT work without them and Optional Permissions are those which are needed only if you are using some specific features in the ANE.)
Check out the demo project available at this repository to see how we have used our PermissionCheck ANE to ask for the permissions.
Necessary Permissions:
- PermissionCheck.SOURCE_LOCATION
Optional Permissions:
none
http://www.myflashlabs.com/product/gps-ane-adobe-air-native-extension/
How to embed ANEs into FlashBuilder, FlashCC and FlashDevelop
Dec 15, 2017 - V3.3.2
- Optimized for ANE-LAB software.
May 19, 2017 - V3.3.0
- Added the following command:
Gps.requestAlwaysAuthorization();. Fix for this issue - Updated the Android libraries which resulted in huge decrease in the ANE file size.
- You will need AIR SDK 25 or higher to compile the ANE.
Mar 20, 2017 - V3.2.1
- Even if you are building for iOS only, you still need to include the following ANE as the dependency overrideAir.ane V4.0.0
- Updated Android SDK to V10.2.0 and you need to make sure you are using the latest version of the dependency files.
- MinimumOSVersion to support the ANE is iOS 8.0
Nov 09, 2016 - V3.2.0
- Optimized for Android manual permissions if you are targeting AIR SDK 24+
Jun 05, 2016 - V3.1.0
- Updated GooglePlayServices to V9.0.1. you need to update
googlePlayServices_base.ane,googlePlayServices_basement.aneandgooglePlayServices_location.aneto V9.0.1
Feb 26, 2016 - V3.0.0
- Updated GooglePlayServices to V8.4.0
- manifest services now changed to
<service android:name="io.nlopez.smartlocation.geocoding.providers.AndroidGeocodingProvider$AndroidGeocodingService" android:exported="false" /> <service android:name="io.nlopez.smartlocation.activity.providers.ActivityGooglePlayServicesProvider$ActivityRecognitionService" android:exported="false" /> <service android:name="io.nlopez.smartlocation.geofencing.providers.GeofencingGooglePlayServicesProvider$GeofencingService" android:exported="false" /> - Removed the global dependency to GooglePlayServices and instead, the following ANEs must be added: androidSupport.ane, googlePlayServices_base.ane, googlePlayServices_basement.ane, googlePlayServices_location.ane and overrideAir.ane
Jan 20, 2016 - V2.9.2
- bypassing xCode 7.2 bug causing iOS conflict when compiling with AirSDK 20 without waiting on Adobe or Apple to fix the problem. This is a must have upgrade for your app to make sure you can compile multiple ANEs in your project with AirSDK 20 or greater. https://forums.adobe.com/thread/2055508 https://forums.adobe.com/message/8294948
Dec 20, 2015 - V2.9.1
- minor bug fixes
Nov 03, 2015 - V2.9
- doitflash devs merged into MyFLashLab Team
Sep 18, 2015 - V2.0
- automatic Gps provider picker
- optimized for indoor location finder
- supporting iOS + Android
- supporting geocoding direct and reverse
Nov 10, 2013 - V1.0
- beginning of the journey!