Fonctions XPath/XQuery : Géolocalisation

www.altova.com Agrandir/Réduire tout Imprimer cette rubrique Page précédente Un niveau supérieur Page suivante

Accueil >  Annexe > Fonctions XSLT et XPath/XQuery > Fonctions d'extension Altova >

Fonctions XPath/XQuery : Géolocalisation

Les fonctions d'extension de géolocalisation XPath/XQuery suivantes sont prises en charge dans la version actuelle de MobileTogether Designer.

 

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.

Afin de distinguer les fonctions d'extension Altova des fonctions dans la librairie standard, les fonctions d'extension Altova sont nommées dans cette documentation avec un suffixe [altova:]. Par exemple : add-years-to-date [altova:].
Néanmoins, lorsque vous utilisez des fonctions d'extension Altova dans vos expressions XPath/XQuery, vous devez utiliser la fonction sans préfixe ou suffixe, comme si vous utilisiez une fonction standard XPath/XQuery. Voici un exemple d'extension Altova : add-years-to-date(xs:date("2014-01-15"), 10).

 

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

 

Click to expand/collapseformat-geolocation [altova:]

format-geolocation(Latitude as xs:decimalLongitude as xs:decimalGeolocationOutputStringFormat as xs:integer) as xs: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.

 

format-geolocation(33.33, -22.22, 4) retourne xs:string "33.33 -22.22"
format-geolocation(33.33, -22.22, 2) retourne xs:string "33.33N 22.22W"
format-geolocation(-33.33, 22.22, 2) retourne xs:string "33.33S 22.22E"
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/SE/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

 

 

 

 

Click to expand/collapseparse-geolocation [altova:]

parse-geolocation(GeolocationInputString as xs:string) as xs:decimal+     XP3.1 XQ3.1

Parse l'argument GeolocationInputString fourni et retourne la latitude et longitude de géolocalisation (dans cet ordre) en séquence deux items décimaux xs:decimal. Les formats dans lesquels la chaîne d'entrée de géolocalisation peut être fournie sont recensés ci-dessous.

 

Note : La fonction image-exif-data et l'attribut @Geolocation de métadonnées Exif peuvent être utilisés pour fournir la chaîne d'entrée de géolocalisation (voir exemple ci-dessous).

 

parse-geolocation("33.33  -22.22") retourne la séquence de deux xs:decimals (33.33, 22.22)
parse-geolocation("48°51'29.6""N  24°17'40.2""") retourne la séquence de deux xs:decimals (48.8582222222222, 24.2945)
parse-geolocation('48°51''29.6"N  24°17''40.2"') retourne la séquence de deux xs:decimals (48.8582222222222, 24.2945)
parse-geolocation( image-exif-data(//MyImages/Image20141130.01)/@Geolocation )retourne une séquence de deux 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/SW/E)
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/W) 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/SW/E)
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/W) est optionnel 
+/-D°M.MM'  +/-D°M.MM'

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

 

Degrés décimaux, avec orientation suffixée (N/SW/E)
D.DDN/S  D.DDW/E

Exemple : 33.33N  22.22W

 

Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/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

 

 


Click to expand/collapsegeolocation-distance-km [altova:]

geolocation-distance-km(GeolocationInputString-1 as xs:stringGeolocationInputString-2 as xs:string) as xs: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.

 

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/SW/E)
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/W) 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/SW/E)
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/W) est optionnel 
+/-D°M.MM'  +/-D°M.MM'

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

 

Degrés décimaux, avec orientation suffixée (N/SW/E)
D.DDN/S  D.DDW/E

Exemple : 33.33N  22.22W

 

Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/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

 

 

 

 

Click to expand/collapsegeolocation-distance-mi [altova:]

geolocation-distance-mi(GeolocationInputString-1 as xs:stringGeolocationInputString-2 as xs:string) as xs: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.

 

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/SW/E)
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/W) 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/SW/E)
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/W) est optionnel 
+/-D°M.MM'  +/-D°M.MM'

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

 

Degrés décimaux, avec orientation suffixée (N/SW/E)
D.DDN/S  D.DDW/E

Exemple : 33.33N  22.22W

 

Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/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

 

 

 

 

Click to expand/collapsegeolocation-within-polygon [altova:]

geolocation-within-polygon(Geolocation as xs:string, ((PolygonPoint as xs:string)+)) as xs: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.

 

geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48 24", "58 -32")) retourne true()
geolocation-within-polygon("33 -22", ("58 -32", "-78 -55", "48 24")) retourne true()
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/SW/E)
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/W) 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/SW/E)
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/W) est optionnel 
+/-D°M.MM'  +/-D°M.MM'

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

 

Degrés décimaux, avec orientation suffixée (N/SW/E)
D.DDN/S  D.DDW/E

Exemple : 33.33N  22.22W

 

Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/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

 

 

 

 

Click to expand/collapsegeolocation-within-rectangle [altova:]

geolocation-within-rectangle(Geolocation as xs:stringRectCorner-1 as xs:stringRectCorner-2 as xs:string) as xs: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.

 

geolocation-within-rectangle("33 -22", "58 -32", "-48 24") retourne true()
geolocation-within-rectangle("33 -22", "58 -32", "48 24") retourne false()
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/SW/E)
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/W) 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/SW/E)
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/W) est optionnel 
+/-D°M.MM'  +/-D°M.MM'

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

 

Degrés décimaux, avec orientation suffixée (N/SW/E)
D.DDN/S  D.DDW/E

Exemple : 33.33N  22.22W

 

Degrés décimaux, avec signe préfixé (+/-) ; le signe plus pour (N/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 ]

 


© 2019 Altova GmbH