Altova MapForce 2023 Enterprise Edition

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. Las funciones de extensión de Altova están en el espacio de nombres https://www.altova.com/xslt-extensions y en esta sección se presentan con el prefijo, que se supone estará enlazado al espacio de nombres señalado. Tenga en cuenta que en futuras versiones del producto algunas funciones pueden dejar de ser compatibles o su comportamiento puede cambiar. Por tanto, consulte siempre la documentación del producto para conocer el funcionamiento de estas funciones en cada versión del producto.

Funciones XPath

(en expresiones XPath en XSLT):

XP1 XP2 XP3.1.1

Funciones XSLT

(en expresiones XPath en XSLT):

XSLT1 XSLT2 XSLT3

Funciones XQuery

(en expresiones XQuery en XQuery):

XQ1 XQ3.1

altova: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.

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

altova: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.

altova: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.

•altova: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")

•altova: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)
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/E) 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/S, E/W)
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/E) es opcional
+/-D°M.MM' +/-D°M.MM'

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

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

Ejemplo: 33.33N 22.22W

•Grados decimales + prefijo (+/-). El signo + para (N/S, E/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

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/S, E/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

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.

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.

Funciones XPath/XQuery: de geoubicación