Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Using GPS and Location Based Services

Simulating GPS location information

You can simulate movement between fixed GPS locations.

A location represents one end point of a path. A route can contain one or more paths. The BlackBerry Smartphone Simulator emulates movement between locations on a route across one or more paths. You can create and save multiple locations that you can simulate.

Once you save the route, run the simulation.

Add a GPS location

The valid range for latitude is -90 to 90. The valid range for longitude is -180 to 180.
  1. On the Simulate menu, click GPS Location.
  2. In the Location section, click Add.
  3. In the Name field, type a name.
  4. In the Latitude and Longitude fields, type a latitude and longitude.
  5. In the Altitude field, type an altitude in meters above or below the WGS 84 reference ellipsoid.
  6. In the Satellites field, type the number of satellites that are visible from the location. You determine the value, but it must be 0 or higher, and 4 is the minimum for a reliable location.
  7. Click Save.

Change a GPS location

The valid range for latitude is -90 to 90. The valid range for longitude is -180 to 180.
  1. On the Simulate menu, click GPS Location.
  2. In the Location drop-down list, click a location.
  3. Click Edit and change the values in the appropriate fields.

    Renaming a location can cause existing routes that contain that location name to fail.

  4. Click Save.

Delete a GPS location

  1. On the Simulate menu, click GPS Location.
  2. In the Location drop-down list, click a location to delete.
  3. Click Delete.

Managing GPS routes

To simulate movement between different GPS locations, set up a route with one or more paths. Each path represents a straight line between two adjacent locations. Each path contains information about the rate of speed used to travel between the path start and end locations.

You can use the following rates of speed: metres per second (m/s), kilometres per hour (km/h), metres per hour (m/h), and feet per second (f/s). The speed limit in terms of metres per second is 655 m/s, with respective limits set for other rates.

Create a GPS route by using existing locations

  1. On the Simulate menu, click GPS Location.
  2. In the Route section, click Add.
  3. Click existing locations.
  4. Type a name for the new route.
  5. Select the starting location of the route.
  6. Type a speed value and set the rate of speed for the path.
  7. Click Insert to insert this location into the route.
  8. To add additional locations to the route, repeat steps 3 through 5.
  9. Save the route.

Create a GPS route by using NMEA 0183 sentences

Before you begin: When you use a version of the BlackBerry Smartphone Simulator earlier than 6.0.1, make sure the BlackBerry MDS Simulator is running.
The BlackBerry Smartphone Simulator accepts files that contain data sentences written in one of the Global Positioning System Fixed Data format, known as GGA format, and the Recommended Minimum Specific GPS/Transit Data format, known as RMC format. These sentences are defined in NMEA 0183 V2.3 and later.
  1. On the Simulate menu, click GPS Location.
  2. In the Route section, click Add.
  3. In the Create New Route dialog box, click data from a file and click OK.
  4. Select the file that contains the sentence and click OK.
  5. Click Close.

Create a GPS route by using a random set of your locations

  1. On the Simulate menu, click GPS Location.
  2. In the Route section, click Add.
  3. Select Create route using random route generator.
  4. Click OK.
  5. In the new dialog, specify the route name, the number of legs, the duration of the route (in seconds), as well as a start and end location. If you generated the route successfully, the New Route dialog displays the route information.

Change a GPS route

  1. On the Simulate menu, click GPS Location.
  2. Set a route to change. Click Edit.
  3. Perform one or more of the following procedures:

    Task

    Steps

    Change the route name.

    1. In the Name field, type a new name for the route.

    Add a location to the route.

    1. Click Add.
    2. In the Location drop-down list, click a location.
    3. Type a speed value and set the rate of speed for the path.

    Change a location.

    1. In the text box, under the Name field, set the location you want to change.
    2. In the Location drop-down list, click the location you want to change to.
    3. Type a speed value and set the rate of speed for the path.

    Remove a location.

    1. From the text box, under the Name field, set a location.
    2. Click Remove.
  4. In the Name field, type a new name for the route.
  5. Click Save.

Delete a GPS route

  1. On the Simulate menu, click GPS Location.
  2. In the Route drop-down list, click a route to delete.
  3. Click Delete.

Simulate a GPS route

Route simulation uses the Haversine formula to calculate the changing GPS coordinates and updates the location, the direction, and the coordinates every second.
  1. On the Simulate menu, click GPS Location.
  2. Perform one of the following actions:

    Task

    Steps

    Play a route.

    In the Route section, click the Play (right arrow) icon.

    Stop a route.

    In the Route section, click the Stop (black square) icon.

  3. To restart the route, stop the simulation. Press the Play Route button.