Afficher et effacer un itinéraire sur une carte à l'aide d'un document d'emplacement

Vous pouvez utiliser un document d'emplacement pour afficher un itinéraire sur une carte dans BlackBerry Maps. Vous pouvez également effacer un itinéraire d'une carte après l'avoir affiché.
  1. Importez les classes requises.
    import net.rim.blackberry.api.invoke.*;
  2. Créez une classe et un constructeur à utiliser pour appeler BlackBerry Maps.
    public class invokeMaps
    {
       public invokeMaps ()
       {
       }
    }
  3. Dans le constructeur, créez une variable String à utiliser pour le document d'emplacement. Ajoutez un élément <lbs> et un élément <getRoute>. Ajoutez des éléments <location> pour indiquer l'emplacement de départ et d'arrivée de l'itinéraire à afficher.
    String document = "<lbs id='WatRoute'><getRoute>
        <location x='-8052237' y='4346518'
           label='Waterloo, ON' description='Waterloo, Ontario, Canada' />
        <location x='-7569792' y='4542349'
           label='Ottawa, ON' description='Ottawa, Ontario, Canada' />
        </getRoute></lbs>";
  4. Dans le constructeur, appelez Invoke.invokeApplication() à l'aide de la constante APP_TYPE_MAPS et d'un nouvel objet MapsArguments comme paramètres pour ouvrir BlackBerry Maps. Transmettez la propriété ARG_LOCATION_DOCUMENT et la variable String représentant le document d'emplacement en tant que paramètres de la classe MapsArguments pour afficher l'itinéraire fourni dans le document d'emplacement.
    invoke.invokeApplication(Invoke.APP_TYPE_MAPS, new MapsArguments
        (MapsArguments.ARG_LOCATION_DOCUMENT, document));
  5. Exécutez l'une des tâches suivantes pour effacer les informations d'itinéraire d'une carte après leur affichage :

    Tâche

    Étapes

    Effacer un itinéraire d'une carte.

    Créez un objet String définissant l'attribut clear en tant qu'id du document d'emplacement contenant les informations d'itinéraire.

    String document = "<lbs clear='WatRoute'></lbs>";

    Effacer tous les itinéraires d'une carte.

    Créez un objet String définissant l'attribut clear sur ROUTES.

    String document = "<lbs clear='ROUTES'></lbs>";

    Effacer toutes les informations d'itinéraires et d'emplacement d'un document d'emplacement spécifique avec un attribut id.

    Créez un objet String définissant l'attribut clear sur DOCS.

    String document = "<lbs clear='DOCS'></lbs>";

    Effacer toutes les informations d'itinéraires et d'emplacement d'une carte.

    Créez un objet String définissant l'attribut clear sur ALL.

    String document = "<lbs clear='ALL'></lbs>";
    L'effacement du contenu de la carte se produit avant l'affichage d'un nouveau contenu de carte sur la carte. Vous pouvez combiner les actions d'affichage et d'effacement de contenu de carte dans un document d'emplacement unique.
    String document = "<lbs clear='WatRoute' id='NewRoute'><getRoute>
        <location x='-8051111' y='4341111'
           label='NewRoute #1' description='New Route #1' />
        <location x='-7562222' y='4542222'
           label='NewRoute #2' description='New Route #2' />
        </getRoute></lbs>";
    

Échantillon de code : affichage d'un itinéraire à l'aide d'un document d'emplacement

import net.rim.blackberry.api.invoke.*;
public class invokeMaps
{
    public invokeMaps ()
    {
        String document = "<lbs id='WatRoute'><getRoute>
            <location x='-8052237' y='4346518'
              label='Waterloo, ON' description='Waterloo, Ontario, Canada' />
            <location x='-7569792' y='4542349'
              label='Ottawa, ON' description='Ottawa, Ontario, Canada' />
            </getRoute></lbs>";
        Invoke.invokeApplication(Invoke.APP_TYPE_MAPS, new MapsArguments
            (MapsArguments.ARG_LOCATION_DOCUMENT, document));
    }
}

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.