---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideGeoPoint - Global

# GlideGeoPoint - Global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture

L'API GlideGeoPoint vous permet d'obtenir et de définir des valeurs de type de données de géopoint dans une table.

Cette API est disponible par défaut. Le type de données géopoint vous permet de stocker des valeurs de latitude et de longitude dans un seul champ d'une table. À l'aide de l'API GlideGeoPoint , vous pouvez instancier de nouveaux objets GlideGeoPoint, créer de nouveaux géopoints pour une table spécifique ou récupérer des valeurs uniques de latitude, de longitude ou de géotype. Pour plus d'informations sur l'implémentation de cas d'utilisation spécifiques tels que l'insertion de nouveaux enregistrements à l'aide d'un géopoint, le calcul des distances entre des emplacements de géopoint ou l'interrogation d'emplacements de géopoints proches, reportez-vous à la section [Guide du développeur GlideGeoPoint](https://servicenow-prod.fluidtopics.net/_ttEK1a_JLuxUjNmSEFAVQ#geopoint-dev-guide "Le guide du développeur GlideGeoPoint contient des informations sur la façon de calculer les distances entre les valeurs de latitude et de longitude (géopoints), de renvoyer des emplacements dans des valeurs de géopoint et de rayon données et d’utiliser des fonctionnalités supplémentaires fournies par les fonctions de l’API GlideGeoPoint prises en charge.").  
Les principaux aspects du type de données de géotype sont les suivants :

* Il se compose d'une paire de nombres décimaux représentant les valeurs de longitude et de latitude.
* La plage de longitude est (-180, 180). Toute valeur en dehors de cette plage est normalisée à la valeur équivalente à l'intérieur de cette plage.
* La plage de latitude est \[-90, 90\]. Toute valeur en dehors de cette plage est normalisée à la valeur équivalente à l'intérieur de cette plage.
* Les valeurs de géopoints sont toujours acceptées en entrée et s'affichent sous la forme d'une paire séparée par des virgules : \<\< longitude,latitude \>\>. Des parenthèses peuvent éventuellement entourer l'expression.
* Les valeurs de longitude et de latitude sont stockées jusqu'à 6 décimales de précision.  
Remarque :  
GlideGeoPoint (en anglais seulement) Les valeurs d'API sont toujours répertoriées par ordre de longitude et de latitude.

Les exemples de cette page supposent qu'une table personnalisée est préremplie avec des champs contenant le type de champ géopoint. Pour plus d'informations sur ce type de données, reportez-vous aux rubriques [Geo point field type](https://www.servicenow.com/docs/access?context=geo-point-field-type&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) et [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).

## GlideGeoPoint - GlideGeoPoint() {#ariaid-title2}

Instancie un objet GlideGeoPoint . L'objet GlideGeoPoint ajoute une conscience sémantique aux valeurs de longitude et de latitude qui sont autrement stockées sous forme de chaînes.
{#GlideGeoPoint-GlideGeoPoint__table_dhw_y13_mxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#GlideGeoPoint-GlideGeoPoint__table_dhw_y13_mxb}  
L'exemple suivant montre comment initialiser un nouvel objet GlideGeoPoint en tant que valeur nulle.

    var gp = new GlideGeoPoint();

## GlideGeoPoint - GlideGeoPoint(String longitude, String latitude) {#ariaid-title3}

Instancie l'objet GlideGeoPoint en fonction des valeurs de longitude et de latitude fournies.
{#GlideGeoPoint-GlideGeoPoint_S_S__table_jf5_zvc_wxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| longitude | Chaîne | Coordonnées de longitude du géopoint. |
| latitude | Chaîne | Coordonnées de latitude du géopoint. |
[Tableau 2. Paramètres]

{#GlideGeoPoint-GlideGeoPoint_S_S__table_jf5_zvc_wxb} {#GlideGeoPoint-GlideGeoPoint_S_S__table_kf5_zvc_wxb__entry__2}

| Type | Description |
|-|-|
| Géopoint | L'objet GlideGeoPoint résultant. |
[Tableau 3. Renvoie]

{#GlideGeoPoint-GlideGeoPoint_S_S__table_kf5_zvc_wxb}  
L'exemple suivant montre comment la fourniture de valeurs de longitude et de latitude initialise l'objet en conséquence.

    // Providing longitude and latitude values initializes the object accordingly 
    var gp = new GlideGeoPoint(10.123, 25.987);  
    gs.info("geopoint: " + gp);

Sortie :

    geopoint: 10.123000,25.987000

## GlideGeoPoint - GlideGeoPoint(Objet geoPoint) {#ariaid-title4}

Copie les valeurs des points de longitude et de latitude pour instancier un nouvel objet GlideGeoPoint.
{#GlideGeoPoint-GlideGeoPoint_O__table_egf_cxc_wxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| GéoPoint | Objet | L'instance de géopoint que vous souhaitez copier. |
[Tableau 4. Paramètres]

{#GlideGeoPoint-GlideGeoPoint_O__table_egf_cxc_wxb} {#GlideGeoPoint-GlideGeoPoint_O__table_fgf_cxc_wxb__entry__2}

| Type | Description |
|-|-|
| Géopoint | L'objet GlideGeoPoint résultant. |
[Tableau 5. Renvoie]

{#GlideGeoPoint-GlideGeoPoint_O__table_fgf_cxc_wxb}  
L'exemple suivant montre comment copier des valeurs de longitude et de latitude pour instancier un nouvel objet GlideGeoPoint.

    var gp = new GlideGeoPoint(135, -64);
    var gpCopy = new GlideGeoPoint(gp); 
    gs.info("geopoint: " + gpCopy);

Sortie :

    geopoint: 135,-64

## GlideGeoPoint : getDisplayValue() {#ariaid-title5}

Renvoie le géopoint de l'utilisateur actuel dans un format convivial.
La méthode getDisplayValue() renvoie une seule valeur de géopoint. Pour plus d'informations sur la récupération de toutes les valeurs de géopoint à partir d'une table spécifique, reportez-vous à la section [Guide du développeur GlideGeoPoint](https://servicenow-prod.fluidtopics.net/_ttEK1a_JLuxUjNmSEFAVQ#geopoint-dev-guide "Le guide du développeur GlideGeoPoint contient des informations sur la façon de calculer les distances entre les valeurs de latitude et de longitude (géopoints), de renvoyer des emplacements dans des valeurs de géopoint et de rayon données et d’utiliser des fonctionnalités supplémentaires fournies par les fonctions de l’API GlideGeoPoint prises en charge.").
{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 6. Paramètres]

{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb} {#GlideGeoPoint-getDisplayValue__table_sr1_24t_qxb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur des coordonnées de longitude et de latitude définies dans l'objet. |
[Tableau 7. Renvoie]

{#GlideGeoPoint-getDisplayValue__table_sr1_24t_qxb}  

    var gp = new GlideGeoPoint(); 
    gp.setValue(76.25, 49.75);      
    gs.info("geopoint: " + gp); 
    gs.info("getDisplayValue(): " + gp.getDisplayValue());

Sortie :

    geopoint: 76.250000,49.750000 
    getDisplayValue(): (76.250000, 49.750000)

## GlideGeoPoint : getGeoPoint(String geo_point_field_name) {#ariaid-title6}

Renvoie une liste de valeurs de coordonnées de point géographique pour un nom de champ donné de type point géographique.
{#GlideGeoPoint-getGeoPoint_S__table_bz4_jsl_5bc__entry__3}

| Nom | Type | Description |
|-|-|-|
| geo_point_field_name | Chaîne | Nom du champ de point géographique. Situé dans la table Entrée de dictionnaire `[sys_dictionary].` Remarque : Vous pouvez également localiser les noms de champs sous les éléments de dictionnaire définis sur une table pour afficher les champs associés de type de point géographique. |
[Tableau 8. Paramètres]

{#GlideGeoPoint-getGeoPoint_S__table_bz4_jsl_5bc} {#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc__entry__2}

| Type | Description |
|-|-|
| Objet | L'objet GlideGeoPoint résultant. |
[Tableau 9. Renvoie]

{#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc}  
Dans l'exemple suivant, \<\< test_table \>\> est une table qui contient le champ \<\< geo_point \>\> de type de point géographique. Le test_table a un enregistrement renseigné dans la colonne geo_point avec une valeur de (-30,560000,-54,330000). L'exemple de code renvoie les coordonnées de latitude et de longitude et la valeur d'affichage de l'enregistrement dans geo_point colonne.

    var gr_Test = new GlideRecord('test_table');
    gr_Test.query();
    gr_Test.next();
    var gp = gr_Test.getGeoPoint('geo_point');
    gs.info("getLatitude(): " + gp.getLatitude());
    gs.info("getLongitude(): " + gp.getLongitude());
    gs.info("getDisplayValue(): " + gp.getDisplayValue());

Sortie :

    getLatitude(): -54.33
    getLongitude(): -30.560000000000002 
    getDisplayValue(): (-30.560000, -54.330000)

## GlideGeoPoint : getLatitude() {#ariaid-title7}

Renvoie la valeur de latitude de l'objet GlideGeoPoint .
{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 10. Paramètres]

{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb} {#GlideGeoPoint-getLatitude__table_x24_fpt_qxb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de latitude de l'objet GlideGeoPoint . |
[Tableau 11. Renvoie]

{#GlideGeoPoint-getLatitude__table_x24_fpt_qxb}  

    var gp = new GlideGeoPoint(); 
    gp.setValue(76.25, 49.75);      

    gs.info("geopoint: " + gp); 
    gs.info("getLatitude(): " + gp.getLatitude());

Sortie :

    geopoint: 76.250000,49.750000 
    getLatitude(): 49.75

## GlideGeoPoint : getLongitude() {#ariaid-title8}

Renvoie la valeur de longitude de l'objet GlideGeoPoint .
{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 12. Paramètres]

{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb} {#GlideGeoPoint-getLongitude__table_gmz_t4t_qxb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de longitude de l'objet GlideGeoPoint . |
[Tableau 13. Renvoie]

{#GlideGeoPoint-getLongitude__table_gmz_t4t_qxb}  

    var gp = new GlideGeoPoint(); 
    gp.setValue(76.25, 49.75);      
    gs.info("geopoint: " + gp);  
    gs.info("getLongitude(): " + gp.getLongitude());

Sortie :

    geopoint: 76.250000,49.750000 
     getLongitude(): 76.25

## GlideGeoPoint : getValue() {#ariaid-title9}

Renvoie une chaîne contenant la valeur programmatique de longitude et de latitude de l'objet GlideGeoPoint actuel.
{#GlideGeoPoint-getValue__table_cvs_2zg_4xb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 14. Paramètres]

{#GlideGeoPoint-getValue__table_cvs_2zg_4xb} {#GlideGeoPoint-getValue__table_dvs_2zg_4xb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur de longitude et de latitude de l'objet GlideGeoPoint actuel. |
[Tableau 15. Renvoie]

{#GlideGeoPoint-getValue__table_dvs_2zg_4xb}  

     var gp = new GlideGeoPoint(); 
    gp.setValue(76.25, 49.75);      
    gs.info("geopoint: " + gp);
    gs.info("getValue(): " + gp.getValue());

Sortie :

    geopoint: 76.250000,49.750000
    getValue(): 76.250000,49.750000

## GlideGeoPoint - setValue(String longitude, String latitude) {#ariaid-title10}

Définit les valeurs de longitude et de latitude du géopoint.
{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb__entry__3}

| Nom | Type | Description |
|-|-|-|
| longitude | Chaîne | Coordonnée longitudinale du géopoint. |
| latitude | Chaîne | Coordonnées de latitude du géopoint. |
[Tableau 16. Paramètres]

{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb} {#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Les valeurs de longitude et de latitude définies sur l'objet GlideGeoPoint . |
[Tableau 17. Renvoie]

{#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb}  

    var gp = new GlideGeoPoint(); 
    gp.setValue("-28.48,38.91");      
    gs.info("geopoint: " + gp);

Sortie :

    geopoint: -28.480000,38.910000

## GlideGeoPoint : setValue(valeur de chaîne) {#ariaid-title11}

Définit les valeurs de longitude et de latitude du géopoint à l'aide d'une seule valeur délimitée par des virgules.
{#GlideGeoPoint-setValue_S__table_mng_gyc_wxb__entry__3}

| Nom | Type | Description |
|-|-|-|
| valide | Chaîne | Valeur séparée par des virgules contenant respectivement les points de longitude et de latitude. |
[Tableau 18. Paramètres]

{#GlideGeoPoint-setValue_S__table_mng_gyc_wxb} {#GlideGeoPoint-setValue_S__table_nng_gyc_wxb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Les valeurs de longitude et de latitude définies sur l'objet GlideGeoPoint . |
[Tableau 19. Renvoie]

{#GlideGeoPoint-setValue_S__table_nng_gyc_wxb}  
L'exemple suivant montre comment définir les valeurs de longitude et de latitude à l'aide d'une seule chaîne.

    var gp = new GlideGeoPoint();
    gp.setValue(23.4, 56.7);

Sortie :

    geopoint: -23.400000,56.700000