API de servicios basados en ubicación

Puede utilizar los paquetes en la API de LBS para:

  • Buscar una ubicación
  • Mostrar información en un mapa
  • Estimar el tiempo y la distancia de un viaje
  • Llevar a cabo tareas de límites geográficos (delimitar un área de supervisión de forma que pueda activar eventos cuando una persona acceda a ese área)

Encontrar una ubicación

Puede recuperar información de ubicación para un smartphone BlackBerry® utilizando uno de los siguientes servicios:

  • GPS: proporciona información de ubicación mediante satélites GPS. Puede recuperar información de ubicación GPS mediante la API de ubicación JSR 179 ubicada en el paquete javax. microedition.location o las extensiones BlackBerry para JSR 179 incluidas en el paquete net.rim.device.api.gps.

  • Geoubicación: proporciona una ubicación utilizando la posición de la antena celular y los puntos de acceso de WLAN. No es necesario disponer de la tecnología GPS en el smartphone para utilizar el servicio de geoubicación. La geoubicación es útil para aplicaciones que requieran una ubicación aproximada y que puedan utilizarse en interiores (por ejemplo, aplicaciones que realizan recomendaciones sobre lugares de interés locales). Puede recuperar la geoubicación mediante el paquete net.rim.device.api.gps.

  • Codificación geográfica y codificación geográfica inversa: proporciona las coordenadas geoespaciales de una calle (codificación geográfica), así como la calle de las coordenadas geoespaciales (codificación geográfica inversa).

Mostrar información en un mapa

Tras recuperar la ubicación de un smartphone BlackBerry, puede mostrar la información de ubicación en BlackBerry® Maps o en un mapa personalizado.

BlackBerry Maps es una aplicación de mapas y ubicaciones que puede mostrar un mapa, la ubicación del smartphone BlackBerry, una ruta desde una ubicación de partida a una ubicación de destino específica, así como puntos de interés en un mapa.

Para crear mapas personalizados, puede añadir un objeto MapField o RichMapField a una pantalla, así como otros componentes de interfaz de usuario. Una vez que tenga un mapa personalizado, podrá utilizarlo de las siguientes maneras:

  • Especificar ubicaciones en el mapa
  • Controlar el comportamiento del mapa
  • Crear formas y objetos personalizados y mostrarlos en el mapa
  • Mostrar objetos asignables al mapa que puedan actualizarse de manera dinámica a medida que cambia la información
  • Añadir campos y superposiciones al mapa
  • Personalizar el aspecto y la apariencia del mapa

Su aplicación puede interactuar con BlackBerry Maps de las siguientes formas:

  • Invoque BlackBerry Maps desde su aplicación mediante el método Invoke.invokeApplication() con parámetros MapsArguments. Puede mostrar lo siguiente:
    • una ubicación para una dirección de la aplicación Contactos
    • una ubicación para un hito
    • una ubicación en coordenadas específicas
    • una ubicación o una ruta mediante un documento de ubicación
    • un ubicación mediante información local de búsqueda
    • una superposición KML
  • Abra BlackBerry Maps desde BlackBerry Browser

Puede crear un cuadro de diálogo de colector de ubicación que permita al usuario elegir una ubicación de una lista con posibles opciones definidas por usted. Puede definir el cuadro de diálogo de colector de ubicación con la API Colector de ubicación incluida en el paquete net.rim.device.api.lbs.picker. La ubicación se pasará mediante un objeto javax.microedition.location.Landmark.

Estimar el tiempo y la distancia de un viaje

Puede recuperar el tiempo y la distancia estimados para viajar entre dos puntos en una fecha y una hora específicas mediante la API de duración del viaje. Actualmente, la API de duración del viaje ofrece estimaciones únicamente para recorridos en automóvil por Estados Unidos y Canadá.

Para solicitar una estimación de duración del viaje, recupere una instancia de la clase TravelTimeEstimator. Utilice el método requestArrivalEstimate() y especifique las coordenadas para las ubicaciones de partida y destino y la hora de partida. La solicitud se reenviará a un servidor de duración del viaje que identificará una ruta entre las ubicaciones de partida y destino y utilizará información en tiempo real e histórica sobre el tráfico para calcular una estimación de la duración del viaje. La estimación refleja las condiciones conocidas en la fecha especificada y a la hora determinada. La estimación de la duración del viaje es devuelta por TravelTimeEstimator mediante una instancia de la clase TravelTime.

Establecer límites geográficos

Puede utilizar la clase Geofence incluida en el paquete net.rim.device.api.location para definir áreas de límites geográficos y recibir notificaciones cuando un usuario de smartphone BlackBerry acceda o abandone la zona especificada. Un límite geográfico es un área geográfica virtual de interés se puede definir mediante un radio alrededor de una ubicación o mediante las coordenadas que definen un polígono de la ubicación.

Su aplicación debe crear una instancia para un objeto Geofence e implementar GeofenceListener para recibir las notificaciones para eventos de límites geográficos (cuando un usuario acceda o abandone una zona de límites geográficos). Cada instancia de límites geográficos puede procesar hasta 20 áreas supervisadas al mismo tiempo.

Tema siguiente: API de seguridad
Tema anterior: API multimedia

¿Le ha resultado útil esta información? Envíenos sus comentarios.