Geolocation

From NSB App Studio
Revision as of 22:22, 9 April 2014 by Ghenne (talk | contribs)
Jump to navigation Jump to search

AppStudio programs can use the capabilities of the web browser. As a result, they can inherit a lot of the properties of the environment they run in. You can access these properties from within your app.

It is not a complete list: there are additional items in the full HTML documentation. In addition, some browsers may have additional properties not shown here.

navigator.geolocation.getCurrentPosition(showMap)

showMap is the name of a function in your program, which will be called by the above statement. It is passed a single parameter: an object with the following fields:

geolocation object members

location.coords.longitude The current longitude of the device. GPS required.
location.coords.latitude The current latitude of the device. GPS required.
location.coords.altitude The height of the location. GPS required.
location.coords.accuracy The accuracy of the location. GPS required.
location.coords.altitudeAccuracy The accuracy of the altitude. GPS required.
location.coords.heading Degrees clockwise from North. GPS required.
location.coords.speed Speed, meter per second. GPS required.
location.coords.timestamp time and date of the observation. GPS required.

For more information on Google Maps, read http://code.google.com/apis/maps/documentation/staticmaps/.

Example

REM Geolocation
Function handler(location)
  Dim s
  Print "Longitude: " + location.coords.longitude 
  Print "Latitude: " + location.coords.latitude 
  Print "Accuracy: " + location.coords.accuracy
  s = "<img src='http://maps.google.com/maps/api/staticmap?center=" & _
  location.coords.latitude & "," & location.coords.longitude & _
  "&zoom=14&size=300x200&maptype=roadmap&sensor=false'>"
  print s
End Function

navigator.geolocation.getCurrentPosition(handler);

Example (JavaScript)

// Geolocation

function handler(location) {
  var s;
  NSB.Print("Longitude: " + location.coords.longitude);
  NSB.Print("Latitude: " + location.coords.latitude);
  NSB.Print("Accuracy: " + location.coords.accuracy);
  s = "<img src='http://maps.google.com/maps/api/staticmap?center=";
  s += location.coords.latitude + "," + location.coords.longitude;
  s += "&zoom=14&size=300x200&maptype=roadmap&sensor=false'>";
  NSB.Print(s);
}

navigator.geolocation.getCurrentPosition(handler);

Output

Longitude: -79.2098782
Latitude: 43.73776441
Accuracy: 100
(map of current location)