Anexos > Funciones XSTL y XPath/XQuery > Funciones de extensión de Altova Funciones XPath/XQuery: de geoubicación |
Desplazarse Inicio Anterior Inicio Siguiente Más |
Las funciones de extensión XPath/XQuery de geoubicación son compatibles con la versión actual de MobileTogether Designer.
Nota sobre el nombre de las funciones y lenguajes
Puede utilizar todas las funciones de extensión de Altova en sus expresiones XPath/XQuery. Con ellas conseguirá funciones adicionales no disponibles en la biblioteca de funciones estándar de XPath, XQuery y XSLT. •En esta documentación el nombre de las funciones de extensión de Altova siempre termina con el sufijo [altova:] para evitar confundirlas con funciones de la biblioteca estándar. Por ejemplo: add-years-to-date [altova:]. •Sin embargo, cuando las utilice en sus expresiones XPath/XQuery, no incluya ningún prefijo o sufijo en el nombre de la función. Por ejemplo: add-years-to-date(xs:date("2014-01-15"), 10).
|
format-geolocation(Latitude como xs:decimal, Longitude como xs:decimal, GeolocationOutputStringFormat como xs:integer) como xs:string XP3.1 XQ3.1 Toma la latitud y la longitud como los dos primeros argumentos y da como resultado la geoubicación como cadena. El tercer argumento, GeolocationOutputStringFormat, es el formato de la cadena de resultado de la geoubicación: usa valores enteros del 1 al 4 para identificar el formato de la cadena de resultado (consulte más abajo "Formatos de la cadena de resultado geoubicación"). Los valores de latitud oscilan entre +90 y -90 (N a S). Los valores de longitud oscilan entre +180 y -180 (E a O).
Nota: la función image-exif-data y el atributo de metadatos Exif se pueden usar para suministrar las cadenas de entrada.
|
parse-geolocation(CadenaEntradaGeoubicación como xs:string) como xs:decimal+ XP3.1 XQ3.1 Analiza el argumento CadenaEntradaGeoubicación y devuelve la latitud y la longitud (en ese orden) de la geoubicación en forma de secuencia de dos elementos xs:decimal. Más abajo puede ver en qué formatos se puede suministrar la cadena de entrada de la geoubicación.
Nota: la función image-exif-data y el atributo @Geolocation de los metadatos Exif se pueden utilizar para suministrar la cadena de entrada de la geoubicación (ver ejemplos).
|
|||||||||||||
geolocation-distance-km(CadenaEntradaGeoubicación-1 como xs:string, CadenaEntradaGeoubicación-2 como xs:string) como xs:decimal XP3.1 XQ3.1 Calcula la distancia en km que existe entre dos geoubicaciones. El formato que puede utilizarse para dar las cadenas de entrada aparece más abajo. Los valores de latitud están comprendidos entre +90 y -90 (N a S). Los valores de longitud están comprendidos entre +180 y -180 (E a W).
Nota: la función image-exif-data y el atributo de metadatos Exif @Geolocation pueden utilizarse para suministrar las cadenas de entrada de geoubicaciones.
|
geolocation-distance-mi(CadenaEntradaGeoubicación-1 como xs:string, CadenaEntradaGeoubicación-2 como xs:string) como xs:decimal XP3.1 XQ3.1 Calcula la distancia en millas que existe entre dos geoubicaciones. El formato que puede utilizarse para dar las cadenas de entrada aparece más abajo. Los valores de latitud están comprendidos entre +90 y -90 (N a S). Los valores de longitud están comprendidos entre +180 y -180 (E a W).
Nota: la función image-exif-data y el atributo de metadatos Exif @Geolocation pueden utilizarse para suministrar las cadenas de entrada de geoubicaciones.
|
geolocations-bounding-rectangle(Geolocations como xs:sequence, GeolocationOutputStringFormat como xs:integer) como xs:string XP3.1 XQ3.1
Toma una secuencia de cadenas de texto como primer argumento; cada cadena de esa secuencia es una geoubicación. La función devuelve una secuencia de dos cadenas que son, respectivamente, las coordinadas de geoubicación de la parte superior izquierda e inferior derecha de un rectángulo delimitado que tiene el tamaño exacto para contener las geoubicaciones suministradas en el primer argumento. Más abajo se enumeran los formatos en que se puede dar una cadena de entrada de geoubicación (véase "Formato de las cadenas de entrada de geoubicaciones"). Los valores de latitud están comprendidos entre +90 y -90 (N a S). Los valores de longitud están comprendidos entre +180 y -180 (E a W).
El segundo argumento de la función indica el formato de las dos cadenas de geoubicación de la secuencia de salida. El argumento toma un valor entero entre 1 y 4, donde cada valor representa un formato distinto de las cadenas de entrada de geoubicaciones (véase "Formato de las cadenas de salida de geoubicaciones").
Nota: la función image-exif-data y los atributos de metadatos Exif se pueden usar para suministrar las cadenas de entrada.
•geolocations-bounding-rectangle(("48.2143531 16.3707266", "51.50939 -0.11832"), 1) devuelve la secuencia ("51°30'33.804"N 0°7'5.952"W", "48°12'51.67116"N 16°22'14.61576"E") •geolocations-bounding-rectangle(("48.2143531 16.3707266", "51.50939 -0.11832", "42.5584577 -70.8893334"), 4) devuelve la secuencia ("51.50939 -70.8893334", "42.5584577 16.3707266") |
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).
Nota: si utiliza comillas simples o dobles para delimitar el argumento de la cadena de entrada, esto dará lugar a un conflicto con las comillas simples o dobles que se utilizan, respectivamente, para indicar los valores de los minutos y los segundos. Si esto ocurre, debe añadir caracteres de escape a las comillas utilizadas para los minutos y segundos (esto se hace duplicando las comillas.
•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 formatos: 33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
A la latitud y longitud suministradas se les aplica un formato de salida de los que se indican más abajo. El formato deseado se identifica con un identificador comprendido entre 1 y 4. Los valores de latitud pueden estar comprendidos entre +90 y -90 (N a S). Los valores de longitud pueden estar comprendidos entre +180 y -180 (E a W).
|
El motor XPath/XQuery de Altova genera el atributo personalizado Geolocation a partir de las etiquetas de metadatos Exif estándar. Este atributo es una concatenación de cuatro etiquetas Exif (GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef) seguidas de unidades:
|
geolocation-within-polygon(Geoubicación como xs:string, ((PuntoDePolígono como xs:string)+)) como xs:boolean XP3.1 XQ3.1 Determina si Geoubicación (primer argumento) está dentro del área poligonal descrita por los argumentos PuntoDePolígono. Si los argumentos PuntoDePolígono no forman una figura cerrada (la figura se cierra cuando el primer y el último punto son el mismo), entonces el primer punto se añade implícitamente como último punto a fin de cerrar la figura. Todos los argumentos (Geoubicación y PuntoDePolígono+) se dan como cadenas de entrada de geoubicación (formatos permitidos más abajo). Si el argumento Geoubicación está dentro del área poligonal, entonces la función devuelve true(). De lo contrario, devuelve false(). Los valores de latitud están comprendidos entre +90 y -90 (N a S). Los valores de longitud están comprendidos entre +180 y -180 (E a W).
Nota: la función image-exif-data y el atributo de metadatos Exif @Geolocation pueden utilizarse para suministrar las cadenas de entrada de geoubicaciones.
|
geolocation-within-rectangle(Geoubicación como xs:string, ÁnguloRectángulo-1 como xs:string, ÁnguloRectángulo-2 como xs:string) como xs:boolean XP3.1 XQ3.1 Determina si Geoubicación (primer argumento) está dentro del rectángulo definido por el segundo y el tercer argumento (ÁnguloRectángulo-1 y ÁnguloRectángulo-2), que indican ángulos opuestos del rectángulo. Todos los argumentos de la función se dan como cadenas de entrada de geoubicación (formatos permitidos más abajo). Si el argumento Geoubicación está dentro del rectángulo, entonces la función devuelve true(). De lo contrario, devuelve false(). Los valores de latitud están comprendidos entre +90 y -90 (N a S). Los valores de longitud están comprendidos entre +180 y -180 (E a W).
Nota: la función image-exif-data y el atributo de metadatos Exif @Geolocation pueden utilizarse para suministrar las cadenas de entrada de geoubicaciones.
|
[ Subir ]
© 2017-2023 Altova GmbH