Leer datos de geoubicación
La acción Leer datos de geoubicación introduce los datos de geoubicación actual en la estructura $MT_GEOLOCATION. Para que la acción pueda leer la geoubicación actual, el rastreo por geoubicación del dispositivo móvil debe iniciarse antes de que se ejecute esta acción.
La estructura de datos $MT_GEOLOCATION se añade automáticamente a las fuentes de página cuando se añade la acción Iniciar/Detener rastreo por geoubicación o Leer datos de geoubicación al diseño.
La estructura $MT_GEOLOCATION tiene dos partes: Location y Address (ver fragmento de código más abajo). El elemento Location contiene las coordenadas de la geoubicación. El elemento Address contiene la dirección equivalente más la información de las coordenadas encontradas en el directorio disponible. Si no hay una dirección postal equivalente, entonces esta parte de la estructura estará vacía. Los demás elementos secundarios de Address (como URL) también pueden estar vacíos si no hay datos relevantes.
$MT_GEOLOCATION
<Root>
<Location/>
<Address/>
</Root>
$MT_GEOLOCATION <Root> <Location Provider="" Latitude="" Longitude="" Geolocation="" Altitude="" AccuracyVertical="" AccuracyHorizontal="" Speed="" Time="" MagneticHeading="" /> <Address Locality="" SubLocality="" CountryName="" CountryCode="" PostalCode="" AdminArea="" SubAdminArea="" FeatureName="" Thoroughfare="" SubThoroughfare="" Phone="" Url="" Premises=""> <AddressLine></AddressLine> ... <AddressLine></AddressLine> </Address> </Root>
|
Opciones de recuperación de geoubicaciones
En el cuadro combinado de la acción puede seleccionar todas estas opciones:
•Geoubicación actual: introduce los datos de geoubicación del dispositivo móvil en el elemento Location de la estructura $MT_GEOLOCATION. Por tanto, solamente tendrán datos los atributos del elemento Location. La estructura $MT_GEOLOCATION no tendrá el elemento Address.
•Geoubicación actual + dirección: introduce los datos en los nodos Location y Address.
•Dirección en la geoubicación dada: introduce los datos del elemento Address en la estructura $MT_GEOLOCATION. Estos datos se corresponden con las coordenadas introducidas en el campo Para geoubicación, que deben ser una cadena de texto con uno de los formatos léxicos descritos más abajo. Los datos de la dirección se obtienen buscando las coordenadas en un directorio de geoubicaciones.
•Geoubicación en la dirección dada: se recuperan las coordenadas de geoubicación para la cadena de texto introducida como valor del campo Para la dirección. Esta cadena se busca en un directorio de geoubicaciones y hay coordenadas para esta dirección, se actualiza el elemento Location de la estructura $MT_GEOLOCATION con dichas coordenadas.
La cadena de entrada de la geoubicación debe contener la latitud y la longitud (en ese orden) se paradas por un espacio en blanco. Ambas pueden estar en cualquier formato de los que se indican más abajo y puede combinar formatos distintos. Es decir, la latitud puede estar en un formato y la longitud en otro. Los valores de la latitud deben estar comprendidos entre +90 y -90 (N a S). Los valores de longitud deben estar comprendidos entre +180 y -180 (E a W).
•Grados, minutos y segundos decimales + orientación como sufijo (N/S, E/W) Ejemplo: 33°55'11.11"N 22°44'55.25"W
•Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/E) es opcional Ejemplo: 33°55'11.11" -22°44'55.25"
•Grados y minutos decimales + orientación como sufijo (N/S, E/W) Ejemplo: 33°55.55'N 22°44.44'W
•Grados y minutos decimales + prefijo (+/-). El signo + para (N/E) es opcional Ejemplo: +33°55.55' -22°44.44'
•Grados decimales + orientación como sufijo (N/S, E/W) Ejemplo: 33.33N 22.22W
•Grados decimales + prefijo (+/-). El signo + para (N/S, E/W) es opcional Ejemplo: 33.33 -22.22
Ejemplos de combinación de formatos33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
Instrucciones de uso
Para poder usar los datos de geoubicación antes es necesario introducirlos en la estructura $MT_GEOLOCATION con la acción Leer datos de geoubicación. En la imagen siguiente, por ejemplo, la acción Leer datos de geoubicación introduce datos para los elementos Location y Address. Después accede a los datos de Location/@Latitude de la estructura $MT_GEOLOCATION para actualizar un nodo de otra estructura.
Los datos de geoubicación que se recuperan de los diferentes dispositivos móviles se colocan en la estructura $MT_GEOLOCATION en forma de números. A continuación ofrecemos una tabla con las unidades y los tipos de datos de estos números:
|
Para más información sobre cómo especificar los datos de geoubicación para las simulaciones en MobileTogether Designer y en el servidor consulte el apartado Configurar geoubicación.
En el tutorial Compartir geoubicaciones puede consultar cómo se utiliza la acción Leer datos de geoubicación.
Funciones de extensión de MobileTogether
MobileTogether cuenta con distintas funciones de extensión XPath creadas específicamente para usarlas en los diseños de MobileTogether. Algunas de ellas son especialmente útiles para ciertas acciones en concreto. Por ejemplo, mt-available-languages() devuelve los idiomas en que está disponible la solución y se podría usar, por ejemplo, con la acción Cuadro de mensaje. Si alguna función es especialmente relevante para esta acción, aparece a continuación. Para ver una lista completa de funciones de extensión y sus descripciones consulte Funciones de extensión de MobileTogether.
mt-geo-map-marker()
mt-geolocation-started()