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.

Integrating with BlackBerry Maps

You can create an app that interacts with BlackBerry Maps. BlackBerry Maps is a map and location application that can display a map, the location of the BlackBerry device, a route from a starting location to a specific ending location, and points of interest.

Your app can interact with BlackBerry Maps in the following ways:

  • Open BlackBerry Maps from your app.
  • Display KML overlays on BlackBerry Maps.
  • Open BlackBerry Maps from the BlackBerry Browser.
  • Embed a map in your app.

BlackBerry Maps can be installed on BlackBerry devices that are running BlackBerry Device Software 4.2 or later.

You can use the MapsArguments class in the net.rim.blackberry.api.invoke package to create an app that interacts with BlackBerry Maps.

Opening BlackBerry Maps from your app

You can open BlackBerry Maps by using the Invoke.invokeApplication() method. When you use this method, you must pass in a net.rim.blackberry.api.invoke.MapsArguments parameter to customize the map view that appears.

You can use the following methods to specify how you want to open BlackBerry Maps:

  • Use the default settings by invoking MapsArgument().
  • Use address information for a contact by invoking MapsArguments(Contact, int).
  • Display the location of a landmark by invoking MapsArguments(Landmark[]).
  • Display a location at specific coordinates by invoking MapsArguments(MapView).
  • Use a location document by invoking MapsArguments(String, String).
  • Use local search information by invoking MapsArguments(ARG_LOCAL_SEARCH, String, String).