Lorsque vous envoyez une requête de géocodage inversé asynchrone, vous devez transmettre une référence à une classe qui met en œuvre l'interface ServerExchangeCallback, représentée par la variable callback dans l'échantillon de code suivant. Vous devez également indiquer les coordonnées de la position, la limite administrative, l'orientation du terminal et le délai avant arrivée à expiration de la requête. Lorsque vous appelez ReverseGeocoder.reverseGeocode(), l'application envoie la requête au serveur de géocodage et appelle la méthode ServerExchangeCallback appropriée en la présence d'un résultat.

int bearing = 1;
int timeout = 0;
MyServerExchangeCallback callback = new MyServerExchangeCallback();
try
{
    ReverseGeocoder.getInstance().reverseGeocode(callback, location, 
            ReverseGeocodeExchange.ADDRESS, bearing, timeout);
} 
catch (ReverseGeocodeException e)
{
    // Do something with the exception
}

Lorsqu'une requête de géocodage inversé aboutit, elle renvoie un objet ReverseGeocodeExchange contenant un objet Vector de résultats de recherche, auquel vous pouvez accéder en appelant ReverseGeocodeExchange.getResults(). L'objet Vector contient un objet net.rim.device.api.lbs.maps.model.MapLocation intégrant des informations concernant une position, telles que le nom de la position, une description et les coordonnées. Pour obtenir la liste complète de propriétés, consultez la classe MapLocation.

public class MyServerExchangeCallback implements ServerExchangeCallback
{
    public void requestSuccess(ServerExchange exchange)
    {
        if(exchange instanceof ReverseGeocodeExchange)
        {
            // Casts the Exchange object to a ReverseGeocodeExchange 
            // object and retrieves the Vector of results.
            ReverseGeocodeExchange reverseGeocodeExchange = 
                    (ReverseGeocodeExchange)exchange;
            Vector results = reverseGeocodeExchange.getResults();
            // Do something with the results
        }
    }
    public void requestFailure(ServerExchange exchange)
    {
        // Inform the user of the failure
    }
    public void requestHalted()
    {
        // Invoked when the request is stopped
    }
}

Pour les requêtes de géocodage inversé synchrone, votre application n'est pas contrainte de déployer l'interface ServerExchangeCallback. Pour établir une requête de géocodage synchrone, vous devez indiquer null en tant qu'argument au lieu de transmettre une référence à une classe déployant ServerExchangeCallback. Lorsque vous exécutez une requête de géocodage synchrone, vous devez en vérifier le résultat manuellement. Généralement, vous devez exécuter les requêtes de géocodage synchrone sur un thread autre que le thread d'interface utilisateur. Sinon, les utilisateurs ne pourront pas interagir avec l'interface utilisateur pendant la requête.

try
{ 
    ReverseGeocodeExchange exchange = ReverseGeocoder.getInstance().reverseGeocode(
            callback, location, ReverseGeocodeExchange.ADDRESS, bearing, timeout);
    // Check if the request was successful
    if(exchange.getExceptionList().size() == 0)
    {
        if(exchange instanceof ReverseGeocodeExchange)
        {
            // Casts the Exchange object to a ReverseGeocodeExchange 
            // object and retrieves the Vector of results.
	           ReverseGeocodeExchange reverseGeocodeExchange = 
                    (ReverseGeocodeExchange)exchange;
            Vector results = reverseGeocodeExchange.getResults();
            // Do something with the results
        }
    }
    else
    {
        // Inform the user of the failure
    }
}
catch(GeocodeException e)
{
    // Do something with the exception
}