API de services géodépendants

Vous pouvez utiliser les progiciels de l'API de services géodépendants pour :

  • Rechercher une position
  • Afficher des informations sur une carte
  • Estimer la durée et la distance d'un trajet
  • Utiliser le géofencing (marquer une zone de sorte à déclencher certains événements lorsque quelqu'un entre dans cette zone)

Recherche d'une position

Vous pouvez récupérer les informations d'emplacement correspondant à un smartphone BlackBerry® à l'aide de l'un des services suivants :

  • GPS : fournit des informations d'emplacement à l'aide de satellites GPS. Pour récupérer des informations de positionnement, vous pouvez utiliser l'API de positionnement JSR 179 dans le progiciel javax.microedition.location ou les extensions BlackBerry JSR 179 dans le progiciel net.rim.device.api.gps.

  • Géolocalisation : fournit une position à l'aide du positionnement par antennes relais et des points d'accès WLAN. La technologie GPS n'est pas requise sur le smartphone pour utiliser le service de géolocalisation. La géolocalisation s'avère utile pour les applications nécessitant une position approximative et peut être utilisée en intérieur, par exemple, avec les applications recommandant des centres d'intérêt locaux. Vous pouvez récupérer la géolocalisation à l'aide du progiciel net.rim.device.api.gps.

  • Géocodage et géocodage inversé : fournit les coordonnées géospatiales correspondant à une adresse (géocodage) et fournit une adresse correspondant à des coordonnées géospatiales (géocodage inversé).

Affichage d'informations sur une carte

Après que vous avez récupéré la position d'un smartphone BlackBerry, vous pouvez afficher des informations d'emplacement sur des cartes BlackBerry® Maps ou des cartes personnalisées.

BlackBerry Maps est une application de cartographie et de localisation qui peut afficher une carte, le positionnement d'un smartphone BlackBerry, un itinéraire partant d'un emplacement de départ et arrivant à un emplacement d'arrivée spécifique, ainsi que des centres d'intérêt sur une carte.

Pour créer des cartes personnalisées, vous pouvez ajouter un objet MapField ou RichMapField à l'écran, ou bien ajouter d'autres composants de l'interface utilisateur. Une fois la carte personnalisée créée, vous pouvez effectuer les actions de votre choix, comme par exemple ci-dessous :

  • Indiquer des positions sur la carte
  • Contrôler le comportement de la carte
  • Créer des formes et des objets personnalisés et les afficher
  • Afficher des objets mappables pouvant être mis à jour de façon dynamique, comme des modifications d'informations
  • Ajouter des champs et des superpositions à la carte
  • Personnaliser l'aspect et le mode d'utilisation de la carte

Votre application peut interagir avec BlackBerry Maps comme suit :

  • Appelez BlackBerry Maps depuis votre application avec la méthode Invoke.invokeApplication() et les paramètres MapsArguments. Vous pouvez afficher les éléments suivants :
    • La position d'une adresse dans l'application Contacts.
    • La position d'un point de repère.
    • Une position selon des coordonnées spécifiques.
    • Une position ou un itinéraire à l'aide d'un document d'emplacement.
    • Une position à l'aide d'une recherche d'informations locales.
    • Un calque KML.
  • Ouvrez BlackBerry Maps depuis BlackBerry Browser

Vous pouvez créer une boîte de dialogue de sélection de position permettant à l'utilisateur de choisir une position parmi une liste de sélections disponibles que vous définissez. Vous pouvez définir cette boîte de dialogue de sélection de position avec l'API de sélecteur de position, fournie dans le progiciel net.rim.device.api.lbs.picker. La position est transmise à l'aide d'un objet javax.microedition.location.Landmark.

Estimation de la durée et de la distance d'un trajet

Vous pouvez récupérer la durée et la distance estimée pour se rendre d'un point à un autre un jour donné à une heure donnée à l'aide de l'API de temps de trajet. Actuellement, l'API de temps de trajet fonctionne uniquement pour les déplacements aux États-Unis et au Canada.

Pour demander une estimation de durée de trajet, récupérez une instance de la classe TravelTimeEstimator. Utilisez la méthode requestArrivalEstimate() et indiquez les coordonnées des positions de départ et d'arrivée, ainsi que l'heure e départ. La demande est transférée à un serveur de type Temps de trajet, qui identifie un itinéraire entre les positions de départ et de destination et utilise des informations de trafic actuelles et passées pour calculer une estimation de la durée du trajet. L'estimation reflète les conditions connues pour la date et l'heure indiquées. L'estimation de durée du trajet est renvoyée par la classe TravelTimeEstimator à l'aide d'une instance de la classe TravelTime.

Utilisation du géofencing

Vous pouvez utiliser la classe Geofence fournie dans le progiciel net.rim.device.api.location pour définir des zones de géofencing et recevoir des notifications lorsqu'un utilisateur de smartphone BlackBerry entre dans une zone avec géofencing ou en sort. Une zone avec géofencing est une zone géographique virtuelle d'intérêt que vous pouvez définir par un rayon autour d'une position ou par ses coordonnées traçant un polygone.

Votre application doit instancier un objet Geofence et déployer une instance de GeofenceListener pour recevoir des notifications pour des événements de géofencing (entrée ou sortie d'un utilisateur dans une zone avec géofencing). Chaque instance de Geofence peut traiter jusqu'à 20 zones contrôlées simultanément.

Sujet suivant: API de sécurité
Sujet précédent: API multimédia

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