ASNA Monarch® Framework 10.0

Geolocation Control

What is a DdsGeolocation?

Many mobile Apps take advantage of the built-in ability of mobile devices to pinpoint themselves on the Global Positioning System. ASNA-based Mobile Apps can do the same through the DdsGeolocation Control. It allows the program to access the devices' built-in GPS API, and therefore determine the location of the end-user.

Applicability: These controls can be used exclusively in Mobile RPG pages/apps.

The Mechanics of a DdsGeolocation

This particular control uses a number of "packed" fields, each of which is comprised of three properties. These properties follow the schema: NameField, NameFieldLength, NameFieldDecimals. The runtime values of these three properties define IBM i fields that the program can use to pinpoint the end user's geolocation.

DdsGeolocation Property Tasks

Property for Field Name

Notes

Latitude

Expressed in Decimal Degrees. Bounded by +/- 90°. Positive latitudes are north of the equator. Negative latitudes are south of the equator.

Longitude

Expressed in Decimal Degrees. Bounded by +/- 90°. Positive longitudes are east of the Prime Meridian (Greenwich, England). Negative longitudes are west of the Prime Meridian.

Accuracy

This property determines the accuracy to which the Latitude and Longitude are reported. Expressed in Meters.

Altitude

Expressed in Meters. This reports the altitude of the device relative to the WGS84 ellipsoid (roughly sea level),

AltitudeAccuracy

Expressed in Meters.

ErrorCode

This receives an error code that developers can use for debugging purposes.

ErrorCode

This receives an error message that developers can use for debugging purposes.