Funciones XPath/XQuery: de geoubicación

www.altova.com Expandir/Contraer todos Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Anexos > Funciones XSTL y XPath/XQuery > Funciones de extensión de Altova >

Funciones XPath/XQuery: de geoubicación

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).

 

Funciones XPath

(en expresiones XPath en XSLT):

XP1 XP2 XP3.1

Funciones XSLT

(en expresiones XPath en XSLT):

Xslt1 XSLT2 XSLT3

Funciones XQuery

(en expresiones XQuery en XQuery):

XQ1 XQ3.1

 

 

Click to expand/collapseformat-geolocation [altova:]

format-geolocation(Latitude as xs:decimalLongitude as xs:decimalGeolocationOutputStringFormat as 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 los atributos de los metadatos Exif se pueden usar para suministrar las cadenas de entrada.

 

format-geolocation(33.33, -22.22, 4) devuelve el xs:string "33.33 -22.22"
format-geolocation(33.33, -22.22, 2) devuelve el xs:string "33.33N 22.22W"
format-geolocation(-33.33, 22.22, 2) devuelve el xs:string "33.33S 22.22E"
format-geolocation(33.33, -22.22, 1) devuelve el xs:string "33°19'48.00"S 22°13'12.00"E"

 

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).

 

1

Grados, minutos y segundos decimales + orientación como sufijo (N/S, E/W)
D°M'S.SS"N/S  D°M'S.SS"E/W

Ejemplo: 33°55'11.11"N  22°44'66.66"W

 

2

Grados decimales + orientación como sufijo (N/SE/W)
D.DDN/S  D.DDE/W

Ejemplo: 33.33N  22.22W

 

3

Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/E) es opcional
+/-D°M'S.SS"  +/-D°M'S.SS"

Ejemplo: 33°55'11.11"  -22°44'66.66"

 

4

Grados decimales + prefijo (+/-). El signo + para (N/E) es opcional
+/-D.DD  +/-D.DD

Ejemplo: 33.33 -22.22

 

 

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:

 

GPSLatitude

GPSLatitudeRef

GPSLongitude

GPSLongitudeRef

Geolocation

33 51 21.91

S

151 13 11.73

E

33°51'21.91"S 151°13'11.73"E

 

 

 

 

Clic para expandir/contraerparse-geolocation [altova:]

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).

 

parse-geolocation("33.33  -22.22") devuelve la secuencia de dos xs:decimals (33.33, 22.22)
parse-geolocation("48°51'29.6""N  24°17'40.2""") devuelve la secuencia de dos xs:decimals (48.8582222222222, 24.2945)
parse-geolocation('48°51''29.6"N  24°17''40.2"') devuelve la secuencia de dos xs:decimals (48.8582222222222, 24.2945)
parse-geolocation( image-exif-data(//MisImágenes/Imagen20141130.01)/@Geolocation ) devuelve una secuencia de dos xs:decimals

 

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/SW/E)
D°M'S.SS"N/S  D°M'S.SS"W/E

Ejemplo: 33°55'11.11"N  22°44'55.25"W

 

Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M'S.SS"  +/-D°M'S.SS"

Ejemplo: 33°55'11.11"  -22°44'55.25"

 

Grados y minutos decimales + orientación como sufijo (N/SW/E)
D°M.MM'N/S  D°M.MM'W/E

Ejemplo: 33°55.55'N  22°44.44'W

 

Grados y minutos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M.MM'  +/-D°M.MM'

Ejemplo: +33°55.55'  -22°44.44'

 

Grados decimales + orientación como sufijo (N/SW/E)
D.DDN/S  D.DDW/E

Ejemplo: 33.33N  22.22W

 

Grados decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D.DD  +/-D.DD

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

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:

 

GPSLatitude

GPSLatitudeRef

GPSLongitude

GPSLongitudeRef

Geolocation

33 51 21.91

S

151 13 11.73

E

33°51'21.91"S 151°13'11.73"E

 

 


Clic para expandir/contraergeolocation-distance-km [altova:]

geolocation-distance-km(CadenaEntradaGeoubicación-1 como xs:stringCadenaEntradaGeoubicació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-km("33.33  -22.22", "48°51'29.6""N  24°17'40.2""") devuelve el xs:decimal 4183.08132372392

 

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/SW/E)
D°M'S.SS"N/S  D°M'S.SS"W/E

Ejemplo: 33°55'11.11"N  22°44'55.25"W

 

Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M'S.SS"  +/-D°M'S.SS"

Ejemplo: 33°55'11.11"  -22°44'55.25"

 

Grados y minutos decimales + orientación como sufijo (N/SW/E)
D°M.MM'N/S  D°M.MM'W/E

Ejemplo: 33°55.55'N  22°44.44'W

 

Grados y minutos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M.MM'  +/-D°M.MM'

Ejemplo: +33°55.55'  -22°44.44'

 

Grados decimales + orientación como sufijo (N/SW/E)
D.DDN/S  D.DDW/E

Ejemplo: 33.33N  22.22W

 

Grados decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D.DD  +/-D.DD

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

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:

 

GPSLatitude

GPSLatitudeRef

GPSLongitude

GPSLongitudeRef

Geolocation

33 51 21.91

S

151 13 11.73

E

33°51'21.91"S 151°13'11.73"E

 

 

 

 

Clic para expandir/contraergeolocation-distance-mi [altova:]

geolocation-distance-mi(CadenaEntradaGeoubicación-1 como xs:stringCadenaEntradaGeoubicació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.

 

geolocation-distance-mi("33.33  -22.22", "48°51'29.6""N  24°17'40.2""") devuelve el xs:decimal 2599.40652340653

 

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/SW/E)
D°M'S.SS"N/S  D°M'S.SS"W/E

Ejemplo: 33°55'11.11"N  22°44'55.25"W

 

Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M'S.SS"  +/-D°M'S.SS"

Ejemplo: 33°55'11.11"  -22°44'55.25"

 

Grados y minutos decimales + orientación como sufijo (N/SW/E)
D°M.MM'N/S  D°M.MM'W/E

Ejemplo: 33°55.55'N  22°44.44'W

 

Grados y minutos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M.MM'  +/-D°M.MM'

Ejemplo: +33°55.55'  -22°44.44'

 

Grados decimales + orientación como sufijo (N/SW/E)
D.DDN/S  D.DDW/E

Ejemplo: 33.33N  22.22W

 

Grados decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D.DD  +/-D.DD

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

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:

 

GPSLatitude

GPSLatitudeRef

GPSLongitude

GPSLongitudeRef

Geolocation

33 51 21.91

S

151 13 11.73

E

33°51'21.91"S 151°13'11.73"E

 

 

 

 

Clic para expandir/contraergeolocation-within-polygon [altova:]

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-polygon("33 -22", ("58 -32", "-78 -55", "48 24", "58 -32")) devuelve true()
geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48 24")) devuelve true()
geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48°51'29.6""N  24°17'40.2""")) devuelve true()

 

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/SW/E)
D°M'S.SS"N/S  D°M'S.SS"W/E

Ejemplo: 33°55'11.11"N  22°44'55.25"W

 

Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M'S.SS"  +/-D°M'S.SS"

Ejemplo: 33°55'11.11"  -22°44'55.25"

 

Grados y minutos decimales + orientación como sufijo (N/SW/E)
D°M.MM'N/S  D°M.MM'W/E

Ejemplo: 33°55.55'N  22°44.44'W

 

Grados y minutos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M.MM'  +/-D°M.MM'

Ejemplo: +33°55.55'  -22°44.44'

 

Grados decimales + orientación como sufijo (N/SW/E)
D.DDN/S  D.DDW/E

Ejemplo: 33.33N  22.22W

 

Grados decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D.DD  +/-D.DD

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

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:

 

GPSLatitude

GPSLatitudeRef

GPSLongitude

GPSLongitudeRef

Geolocation

33 51 21.91

S

151 13 11.73

E

33°51'21.91"S 151°13'11.73"E

 

 

 

 

Clic para expandir/contraergeolocation-within-rectangle [altova:]

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.

 

geolocation-within-rectangle("33 -22", "58 -32", "-48 24") devuelve true()
geolocation-within-rectangle("33 -22", "58 -32", "48 24") devuelve false()
geolocation-within-rectangle("33 -22", "58 -32", "48°51'29.6""S  24°17'40.2""") devuelve true()

 

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/SW/E)
D°M'S.SS"N/S  D°M'S.SS"W/E

Ejemplo: 33°55'11.11"N  22°44'55.25"W

 

Grados, minutos y segundos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M'S.SS"  +/-D°M'S.SS"

Ejemplo: 33°55'11.11"  -22°44'55.25"

 

Grados y minutos decimales + orientación como sufijo (N/SW/E)
D°M.MM'N/S  D°M.MM'W/E

Ejemplo: 33°55.55'N  22°44.44'W

 

Grados y minutos decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D°M.MM'  +/-D°M.MM'

Ejemplo: +33°55.55'  -22°44.44'

 

Grados decimales + orientación como sufijo (N/SW/E)
D.DDN/S  D.DDW/E

Ejemplo: 33.33N  22.22W

 

Grados decimales + prefijo (+/-). El signo + para (N/W) es opcional
+/-D.DD  +/-D.DD

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

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:

 

GPSLatitude

GPSLatitudeRef

GPSLongitude

GPSLongitudeRef

Geolocation

33 51 21.91

S

151 13 11.73

E

33°51'21.91"S 151°13'11.73"E

 

 

 

 

[ Subir ]

 


© 2019 Altova GmbH