Visualizzazione e cancellazione di un itinerario su una mappa utilizzando un documento sulla posizione

In BlackBerry Maps è possibile utilizzare un documento sulla posizione per visualizzare un itinerario su una mappa. È inoltre possibile cancellare un itinerario da una mappa dopo averlo visualizzato.
  1. Importare le classi richieste.
    import net.rim.blackberry.api.invoke.*;
  2. Creare una classe e un costruttore da utilizzare per richiamare BlackBerry Maps.
    public class invokeMaps
    {
       public invokeMaps ()
       {
       }
    }
  3. Nel costruttore, creare una variabile String da utilizzare per il documento sulla posizione. Aggiungere un elemento <lbs> e un elemento <getRoute>. Aggiungere elementi <location> per specificare il punto di partenza e il punto di arrivo dell'itinerario che si desidera visualizzare.
    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. Nel costruttore, richiamare Invoke.invokeApplication() utilizzando la costante APP_TYPE_MAPS e un nuovo oggetto MapsArguments come parametri per aprire BlackBerry Maps. Passare la proprietà ARG_LOCATION_DOCUMENT e la variabile String, che rappresenta il documento sulla posizione, come parametri per la classe MapsArguments al fine di visualizzare l'itinerario fornito nel documento sulla posizione.
    invoke.invokeApplication(Invoke.APP_TYPE_MAPS, new MapsArguments
        (MapsArguments.ARG_LOCATION_DOCUMENT, document));
  5. Effettuare una delle seguenti operazioni per cancellare le informazioni sulla posizione dell'itinerario dalla mappa dopo averle visualizzate:

    Attività

    Procedura

    Cancellazione di un itinerario da una mappa.

    Creare un elemento String che configura l'attributo clear in modo che sia l'elemento id del documento sulla posizione che contiene le informazioni sull'itinerario.

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

    Cancellazione di tutti gli itinerari da una mappa.

    Creare un elemento String che configuri l'attributo clear in modo che sia ROUTES.

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

    Cancellazione di tutti gli itinerari e di tutte le informazioni sulla posizione da un determinato documento sulla posizione con un attributo id.

    Creare un elemento String che configuri l'attributo clear in modo che sia DOCS.

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

    Cancellazione di tutti gli itinerari e di tutte le informazioni sulla posizione da una mappa.

    Creare un elemento String che configuri l'attributo clear in modo che sia ALL.

    String document = "<lbs clear='ALL'></lbs>";
    La cancellazione del contenuto di una mappa si verifica prima che su questa vengano visualizzati nuovi contenuti. È possibile combinare le operazioni di visualizzazione e di cancellazione del contenuto di una mappa in un unico documento sulla posizione.
    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>";
    

Esempio di codice: visualizzazione di un itinerario utilizzando un documento sulla posizione

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));
    }
}

Le informazioni sono state utili? Inviateci i vostri commenti.