Les fonctions d'extension de géolocalisation XPath/XQuery suivantes sont prises en charge dans la version actuelle de RaptorXML Server et peuvent être utilisées dans (i) des expressions XPath dans un contexte XSLT, ou (ii) des expressions XQuery dans un document XQuery.
Note concernant le nommage de fonctions et de l'applicabilité de la langue
Les fonctions d'extension Altova peuvent être utilisées dans les expressions XPath/XQuery. Elles fournissent des fonctions supplémentaires aux fonctions d'ores et déjà disponibles dans la librairie standard des fonctions XPath, XQuery et XSLT. Les fonctions d'extension Altova se trouvent dans l'espace de nom des fonctions d'extension Altova, http://www.altova.com/xslt-extensions, et sont indiquées dans cette section par le préfixe altova:, qui est présupposé être lié à cet espace de nom. Veuillez noter que, en ce qui concerne les versions futures de votre produit, la prise en charge d'une fonction peut être interrompue et le comportement de certaines fonctions peut changer. Veuillez consulter la documentation lors des publications à venir pour plus d'informations concernant la prise en charge des fonctions d'extension Altova de cette version. Fonctions XPath (utilisées dans les expressions XPath dans XSLT) : | XP1 XP2 XP3.1 | Fonctions XSLT (utilisées dans les expressions XPath dans XSLT) : | Xslt1 XSLT2 XSLT3 | Fonctions XQuery (utilisées dans les expressions XQuery dans XQuery) : | XQ1 XQ3.1 |
|
altova:format-geolocation(Latitude as xs:decimal, Longitude as xs:decimal, GeolocationOutputStringFormat as xs:integer) asxs:string XP3.1 XQ3.1 Prend la latitude et la longitude en tant que les deux premiers arguments, et sort la géolocalisation en tant que chaîne. Le troisième argument, GeolocationOutputStringFormat, est le format de la chaîne de sortie de géolocalisation ; il utilise des valeurs d'entier allant de 1 à 4 pour identifier le format de chaîne de sortie (voir 'Formats de chaîne de sortie de géolocalisation' ci-dessous). Les valeurs de latitude vont de +90 à -90 (N à S). Les valeurs de longitude vont de +180 à -180 (E à O). Note : La fonction image-exif-data et les attributs de métadonnées Exif peuvent être utilisés pour fournie les chaînes d'entrée. •altova:format-geolocation(33.33, -22.22, 4) retourne xs:string "33.33 -22.22" •altova:format-geolocation(33.33, -22.22, 2) retourne xs:string "33.33N 22.22W" •altova:format-geolocation(-33.33, 22.22, 2) retourne xs:string "33.33S 22.22E" •altova:format-geolocation(33.33, -22.22, 1) retourne xs:string "33°19'48.00"S 22°13'12.00"E" |
La latitude et longitude fournies sont formatées dans un des formats de sortie indiqués ci-dessous. Le format désiré est défini par son ID d'entier (1 à 4). Les valeurs de latitude vont de +90 à -90 (N à S). Les valeurs de longitude vont de +180 à -180 (E à O). 1 | Degrés, minutes, secondes décimales, avec orientation suffixée (N/S, E/O) D°M'S.SS"N/S D°M'S.SS"E/W Exemple : 33°55'11.11"N 22°44'66.66"W |
2 | Degrés décimaux, avec orientation suffixée (N/S, E/O) D.DDN/S D.DDE/W Exemple : 33.33N 22.22W |
3 | Degrés, minutes, secondes décimales, avec signe préfixé (+/-); le signe plus (N/E) est optionnel +/-D°M'S.SS" +/-D°M'S.SS" Exemple : 33°55'11.11" -22°44'66.66" |
4 | Degrés décimaux, avec signe préfixé (+/-); le signe plus (N/E) est optionnel +/-D.DD +/-D.DD Exemple : 33.33 -22.22 |
|
La machine Altova XPath/XQuery génère l'attribut Geolocation personnalisable depuis les onglets standard de métadonnées Exif. Geolocation est une concaténation de quatre onglets Exif : GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef, avec des unités ajoutées (voir table ci-dessous). 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:parse-geolocation(GeolocationInputString as xs:string) as xs:decimal+ XP3.1 XQ3.1 Parses the supplied GeolocationInputString argument and returns the geolocation's latitude and longitude (in that order) as a sequence two xs:decimal items. The formats in which the geolocation input string can be supplied are listed below. Note: The image-exif-data function and the Exif metadata's @Geolocation attribute can be used to supply the geolocation input string (see example below). •altova:parse-geolocation("33.33 -22.22") returns the sequence of two xs:decimals (33.33, 22.22) •altova:parse-geolocation("48°51'29.6""N 24°17'40.2""") returns the sequence of two xs:decimals (48.8582222222222, 24.2945) •altova:parse-geolocation('48°51''29.6"N 24°17''40.2"') returns the sequence of two xs:decimals (48.8582222222222, 24.2945) •altova:parse-geolocation( image-exif-data(//MyImages/Image20141130.01)/@Geolocation ) returns a sequence of two xs:decimals |
Le string d'entrée de géolocalisation doit contenir la latitude et la longitude (dans cet ordre) séparées par un espace. Les strings peuvent tous présenter les formats suivants. Les combinaisons sont permises. La latitude peut donc être dans un format et la longitude dans un autre. Les valeurs de latitude varient de +90 à -90 (N à S). Les valeurs de longitude varient de +180 à -180 (E à W). Note : L'utilisation de guillemets simples ou doubles pour la délimitation des arguments de string entraînera une non-concordance avec l'utilisation de guillemets simples ou doubles pour indiquer, respectivement les valeurs de minutes et de secondes. Dans ces cas, les guillemets utilisés pour indiquer les minutes et les secondes doivent être échappés en les doublant. Dans les exemples présentés dans cette section, les guillemets utilisés pour délimiter les strings d'entrée sont marqués en jaune (") alors que les indicateurs d'unité échappés sont marqués en bleu (""). •Degrés, minutes, secondes décimales, avec orientation suffixée (N/S, E/W) D°M'S.SS"N/S D°M'S.SS"W/E Exemple : 33°55'11.11"N 22°44'55.25"W •Degrés, minutes, secondes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M'S.SS" +/-D°M'S.SS" Exemple : 33°55'11.11" -22°44'55.25" •Degrés, minutes décimales, avec orientation suffixée (N/S, E/W) D°M.MM'N/S D°M.MM'W/E Exemple : 33°55.55'N 22°44.44'W •Degrés, minutes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M.MM' +/-D°M.MM' Exemple : +33°55.55' -22°44.44' •Degrés décimaux, avec orientation suffixée (N/S, E/W) D.DDN/S D.DDW/E Exemple : 33.33N 22.22W •Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/S E/W) est optionnel +/-D.DD +/-D.DD Exemple : 33.33 -22.22 Exemples de combinaisons de format :33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
La machine Altova XPath/XQuery génère l'attribut Geolocation personnalisable depuis les onglets standard de métadonnées Exif. Geolocation est une concaténation de quatre onglets Exif : GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef, avec des unités ajoutées (voir table ci-dessous). 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-distance-km(GeolocationInputString-1 as xs:string, GeolocationInputString-2 as xs:string) asxs:decimal XP3.1 XQ3.1 Calcule la distance entre deux géolocalisations en kilomètres. Les formats dans lesquels une chaîne d'entrée de géolocalisation peut être fournie sont recensés ci-dessous. Les valeurs de latitude vont de +90 à -90 (N à S). Les valeurs de longitude vont de +180 à -180 (E à O). Note : La fonction image-exif-data et l'attribut @Geolocation des métadonnées d'Exif peuvent être utilisés pour fournir les chaînes d'entrée de géolocalisation. •altova:geolocation-distance-km("33.33 -22.22", "48°51'29.6""N 24°17'40.2""") retourne xs:decimal 4183.08132372392 |
Le string d'entrée de géolocalisation doit contenir la latitude et la longitude (dans cet ordre) séparées par un espace. Les strings peuvent tous présenter les formats suivants. Les combinaisons sont permises. La latitude peut donc être dans un format et la longitude dans un autre. Les valeurs de latitude varient de +90 à -90 (N à S). Les valeurs de longitude varient de +180 à -180 (E à W). Note : L'utilisation de guillemets simples ou doubles pour la délimitation des arguments de string entraînera une non-concordance avec l'utilisation de guillemets simples ou doubles pour indiquer, respectivement les valeurs de minutes et de secondes. Dans ces cas, les guillemets utilisés pour indiquer les minutes et les secondes doivent être échappés en les doublant. Dans les exemples présentés dans cette section, les guillemets utilisés pour délimiter les strings d'entrée sont marqués en jaune (") alors que les indicateurs d'unité échappés sont marqués en bleu (""). •Degrés, minutes, secondes décimales, avec orientation suffixée (N/S, E/W) D°M'S.SS"N/S D°M'S.SS"W/E Exemple : 33°55'11.11"N 22°44'55.25"W •Degrés, minutes, secondes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M'S.SS" +/-D°M'S.SS" Exemple : 33°55'11.11" -22°44'55.25" •Degrés, minutes décimales, avec orientation suffixée (N/S, E/W) D°M.MM'N/S D°M.MM'W/E Exemple : 33°55.55'N 22°44.44'W •Degrés, minutes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M.MM' +/-D°M.MM' Exemple : +33°55.55' -22°44.44' •Degrés décimaux, avec orientation suffixée (N/S, E/W) D.DDN/S D.DDW/E Exemple : 33.33N 22.22W •Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/S E/W) est optionnel +/-D.DD +/-D.DD Exemple : 33.33 -22.22 Exemples de combinaisons de format :33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
La machine Altova XPath/XQuery génère l'attribut Geolocation personnalisable depuis les onglets standard de métadonnées Exif. Geolocation est une concaténation de quatre onglets Exif : GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef, avec des unités ajoutées (voir table ci-dessous). 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-distance-mi(GeolocationInputString-1 as xs:string, GeolocationInputString-2 as xs:string) asxs:decimal XP3.1 XQ3.1 Calcule la distance entre deux géolocalisations en miles. Les formats dans lesquels une chaîne d'entrée de géolocalisation peut être fournie sont recensés ci-dessous. Les valeurs de latitude vont de +90 à -90 (N à S). Les valeurs de longitude vont de +180 à -180 (E à O). Note : La fonction image-exif-data et l'attribut @Geolocation des métadonnées d'Exif peuvent être utilisés pour fournir les chaînes d'entrée de géolocalisation. •altova:geolocation-distance-mi("33.33 -22.22", "48°51'29.6""N 24°17'40.2""") retourne xs:decimal 2599.40652340653 |
Le string d'entrée de géolocalisation doit contenir la latitude et la longitude (dans cet ordre) séparées par un espace. Les strings peuvent tous présenter les formats suivants. Les combinaisons sont permises. La latitude peut donc être dans un format et la longitude dans un autre. Les valeurs de latitude varient de +90 à -90 (N à S). Les valeurs de longitude varient de +180 à -180 (E à W). Note : L'utilisation de guillemets simples ou doubles pour la délimitation des arguments de string entraînera une non-concordance avec l'utilisation de guillemets simples ou doubles pour indiquer, respectivement les valeurs de minutes et de secondes. Dans ces cas, les guillemets utilisés pour indiquer les minutes et les secondes doivent être échappés en les doublant. Dans les exemples présentés dans cette section, les guillemets utilisés pour délimiter les strings d'entrée sont marqués en jaune (") alors que les indicateurs d'unité échappés sont marqués en bleu (""). •Degrés, minutes, secondes décimales, avec orientation suffixée (N/S, E/W) D°M'S.SS"N/S D°M'S.SS"W/E Exemple : 33°55'11.11"N 22°44'55.25"W •Degrés, minutes, secondes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M'S.SS" +/-D°M'S.SS" Exemple : 33°55'11.11" -22°44'55.25" •Degrés, minutes décimales, avec orientation suffixée (N/S, E/W) D°M.MM'N/S D°M.MM'W/E Exemple : 33°55.55'N 22°44.44'W •Degrés, minutes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M.MM' +/-D°M.MM' Exemple : +33°55.55' -22°44.44' •Degrés décimaux, avec orientation suffixée (N/S, E/W) D.DDN/S D.DDW/E Exemple : 33.33N 22.22W •Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/S E/W) est optionnel +/-D.DD +/-D.DD Exemple : 33.33 -22.22 Exemples de combinaisons de format :33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
La machine Altova XPath/XQuery génère l'attribut Geolocation personnalisable depuis les onglets standard de métadonnées Exif. Geolocation est une concaténation de quatre onglets Exif : GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef, avec des unités ajoutées (voir table ci-dessous). 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(Geolocation as xs:string, ((PolygonPoint as xs:string)+)) asxs:boolean XP3.1 XQ3.1 Détermine si Geolocation (le premier argument) se trouve dans l'espace polygonal décrit par les arguments PolygonPoint. Si les arguments PolygonPoint ne forment pas une figure fermée (formée lorsque le premier point et le dernier point sont identiques), alors le premier point est implicitement ajouté en tant que le dernier point afin de pouvoir clore la figure. Tous les arguments (Geolocation et PolygonPoint+) sont donnés par chaînes d'entrées de géolocalisation (formats recensés ci-dessous). Si l'argument Geolocation se trouve dans l'espace polygonal, la fonction retourne true(); sinon, elle retourne false(). Les valeurs de latitude vont de +90 à -90 (N à S). Les valeurs de longitude vont de +180 à -180 (E à O). Note : La fonction image-exif-data et l'attribut @Geolocation de métadonnées d'Exif peut être utilisée pour fournir les chaînes d'entrée de géolocalisation. •altova:geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48 24", "58 -32")) retourne true() •altova:geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48 24")) retourne true() •altova:geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48°51'29.6""N 24°17'40.2""")) retourne true() |
Le string d'entrée de géolocalisation doit contenir la latitude et la longitude (dans cet ordre) séparées par un espace. Les strings peuvent tous présenter les formats suivants. Les combinaisons sont permises. La latitude peut donc être dans un format et la longitude dans un autre. Les valeurs de latitude varient de +90 à -90 (N à S). Les valeurs de longitude varient de +180 à -180 (E à W). Note : L'utilisation de guillemets simples ou doubles pour la délimitation des arguments de string entraînera une non-concordance avec l'utilisation de guillemets simples ou doubles pour indiquer, respectivement les valeurs de minutes et de secondes. Dans ces cas, les guillemets utilisés pour indiquer les minutes et les secondes doivent être échappés en les doublant. Dans les exemples présentés dans cette section, les guillemets utilisés pour délimiter les strings d'entrée sont marqués en jaune (") alors que les indicateurs d'unité échappés sont marqués en bleu (""). •Degrés, minutes, secondes décimales, avec orientation suffixée (N/S, E/W) D°M'S.SS"N/S D°M'S.SS"W/E Exemple : 33°55'11.11"N 22°44'55.25"W •Degrés, minutes, secondes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M'S.SS" +/-D°M'S.SS" Exemple : 33°55'11.11" -22°44'55.25" •Degrés, minutes décimales, avec orientation suffixée (N/S, E/W) D°M.MM'N/S D°M.MM'W/E Exemple : 33°55.55'N 22°44.44'W •Degrés, minutes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M.MM' +/-D°M.MM' Exemple : +33°55.55' -22°44.44' •Degrés décimaux, avec orientation suffixée (N/S, E/W) D.DDN/S D.DDW/E Exemple : 33.33N 22.22W •Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/S E/W) est optionnel +/-D.DD +/-D.DD Exemple : 33.33 -22.22 Exemples de combinaisons de format :33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
La machine Altova XPath/XQuery génère l'attribut Geolocation personnalisable depuis les onglets standard de métadonnées Exif. Geolocation est une concaténation de quatre onglets Exif : GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef, avec des unités ajoutées (voir table ci-dessous). 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-rectangle(Geolocation as xs:string, RectCorner-1 as xs:string, RectCorner-2 as xs:string) asxs:boolean XP3.1 XQ3.1 Détermine si Geolocation (le premier argument) se trouve dans le rectangle défini par le second et le troisième argument, RectCorner-1 et RectCorner-2, qui spécifient les coins opposés du rectangle. Tous les arguments (Geolocation, RectCorner-1 et RectCorner-2) sont indiqués par des chaînes d'entrées de géolocalisation (formats recensés ci-dessous). Si l'argument Geolocation se trouve dans le rectangle, la fonction retourne true(); sinon, elle retourne false(). Les valeurs de latitude vont de +90 à -90 (N à S). Les valeurs de longitude vont de +180 à -180 (E à O). Note : La fonction image-exif-data et l'attribut @Geolocation de métadonnées Exif peuvent être utilisés pour fournir les chaînes d'entrée de géolocalisation. •altova:geolocation-within-rectangle("33 -22", "58 -32", "-48 24") retourne true() •altova:geolocation-within-rectangle("33 -22", "58 -32", "48 24") retourne false() •altova:geolocation-within-rectangle("33 -22", "58 -32", "48°51'29.6""S 24°17'40.2""") retourne true() |
Le string d'entrée de géolocalisation doit contenir la latitude et la longitude (dans cet ordre) séparées par un espace. Les strings peuvent tous présenter les formats suivants. Les combinaisons sont permises. La latitude peut donc être dans un format et la longitude dans un autre. Les valeurs de latitude varient de +90 à -90 (N à S). Les valeurs de longitude varient de +180 à -180 (E à W). Note : L'utilisation de guillemets simples ou doubles pour la délimitation des arguments de string entraînera une non-concordance avec l'utilisation de guillemets simples ou doubles pour indiquer, respectivement les valeurs de minutes et de secondes. Dans ces cas, les guillemets utilisés pour indiquer les minutes et les secondes doivent être échappés en les doublant. Dans les exemples présentés dans cette section, les guillemets utilisés pour délimiter les strings d'entrée sont marqués en jaune (") alors que les indicateurs d'unité échappés sont marqués en bleu (""). •Degrés, minutes, secondes décimales, avec orientation suffixée (N/S, E/W) D°M'S.SS"N/S D°M'S.SS"W/E Exemple : 33°55'11.11"N 22°44'55.25"W •Degrés, minutes, secondes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M'S.SS" +/-D°M'S.SS" Exemple : 33°55'11.11" -22°44'55.25" •Degrés, minutes décimales, avec orientation suffixée (N/S, E/W) D°M.MM'N/S D°M.MM'W/E Exemple : 33°55.55'N 22°44.44'W •Degrés, minutes décimales, avec signe préfixé (+/-) ; le signe plus pour (N/E) est optionnel +/-D°M.MM' +/-D°M.MM' Exemple : +33°55.55' -22°44.44' •Degrés décimaux, avec orientation suffixée (N/S, E/W) D.DDN/S D.DDW/E Exemple : 33.33N 22.22W •Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/S E/W) est optionnel +/-D.DD +/-D.DD Exemple : 33.33 -22.22 Exemples de combinaisons de format :33.33N -22°44'55.25" 33.33 22°44'55.25"W 33.33 22.45 |
La machine Altova XPath/XQuery génère l'attribut Geolocation personnalisable depuis les onglets standard de métadonnées Exif. Geolocation est une concaténation de quatre onglets Exif : GPSLatitude, GPSLatitudeRef, GPSLongitude, GPSLongitudeRef, avec des unités ajoutées (voir table ci-dessous). 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 |
|
|
[ Top ]