View source

__NOTOC__
__NOEDITSECTION__
{{KBCS}}
{{CodeSnippet
|id=CS001289
|platform=S60 5th Edition
|devices=Nokia 5800 XpressMusic
|category=Flash Lite
|subcategory=Location
|creationdate=January 26, 2009
|keywords=Service.Location, location.GetLocation()
}}

==Overview==

This code snippet demonstrates how to discover the location (latitude and longitude) of the device using the Location Platform Service for Flash Lite supported from S60 5th Edition onwards.

==Preconditions==

'''Note''': To get the location data the device's GPS needs to be active.

==Source==

<code actionscript>
// Import Platform Service Interface
import com.nokia.lib.Service;
</code>

<code actionscript>
// Heading of the application
heading_txt.text = "Location Information";

// Create new Service object which has location information
var location = new Service("Service.Location", "ILocation");

// Define input parameters
var inParams = {LocationInformationClass:"GenericLocationInfo"};

// Define result value
var outParams = location.GetLocation(inParams);

// Check if getting the location information was successful
if (outParams.ErrorCode == 0) {
    // If no errors get Location information (longitude and latitude)
    var outList = outParams.ReturnValue;  
    var longitude = outList.Longitude;  // Contains longitudinal data.
    var latitude = outList.Latitude;    // Contains latitudinal data.
    text_txt.text = "Longitude: "+longitude+"\rLatitude: "+latitude;
} else {
    var errorId = outParam.ErrorCode;
    text_txt.text = "Error: "+errorId;
}

stop();
</code>

'''Note''': This example code illustrates how to retrieve details of the specific location information using <tt>GetLocation()</tt> synchronously.

==Postconditions== 

The current location (longitude and latitude) of the device is displayed.

==Example application== 

The following sample application has been tested in the Nokia 5800 XpressMusic (S60 5th Edition, Flash Lite 3.0).
[[Image:FlashLite_Finding_Position.zip]]

==See also==

* Flash Lite API reference: Location Information in the [http://library.forum.nokia.com/topic/Flash_Lite_Developers_Library/GUID-128337DF-18EC-46DE-9097-AA1D02E0D433_cover.html Flash Lite Developer's Library]
* [[CS001286 - Calculating the distance between two locations in Flash Lite]] 
* [[CS001293 - Tracking changes in the current location in Flash Lite]] 

[[Category:Flash Lite]][[Category:S60 Platform Services]][[Category:S60 5th Edition]][[Category:Location Based Services]][[Category:Code Examples]]