GlideGeoPoint : global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 5 minutes de lecture

    • L’API GlideGeoPoint vous permet d’obtenir et de définir des valeurs de type de données Geopoint 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 de latitude, de longitude ou de géotype uniques. Pour plus d’informations sur la mise en œuvre de cas d’utilisation spécifiques, tels que l’insertion de nouveaux enregistrements à l’aide d’un géopoint, le calcul des distances entre les emplacements géoponctuels ou l’interrogation des emplacements géoponctuels à proximité, reportez-vous à la section Guide du développeur GlideGeoPoint.

    Les principaux aspects du type de données GeoType 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 comme 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 Les valeurs API sont toujours répertoriées par longitude et par ordre de latitude.

    Les exemples de cette page supposent qu’une table personnalisée est préremplie avec des champs contenant le type de champ geopoint. Pour plus d’informations sur ce type de données, consultez Geo point field type et Function field.

    GlideGeoPoint : GlideGeoPoint()

    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.

    Tableau 1. Paramètres
    Nom Type Description
    Néant

    L’exemple suivant montre comment initialiser un nouvel objet GlideGeoPoint en tant que valeur nulle.

    var gp = new GlideGeoPoint();

    GlideGeoPoint : GlideGeoPoint(longitude de la chaîne, latitude de la chaîne)

    Instancie l’objet GlideGeoPoint en fonction des valeurs de longitude et de latitude fournies.

    Tableau 2. Paramètres
    Nom Type Description
    longitude Chaîne Coordonnées de longitude du géopoint.
    latitude Chaîne Coordonnées de latitude du géopoint.
    Tableau 3. Renvoie
    Type Description
    géopoint Objet GlideGeoPoint résultant.

    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(Object geoPoint)

    Copie les valeurs des points de longitude et de latitude pour instancier un nouvel objet GlideGeoPoint.

    Tableau 4. Paramètres
    Nom Type Description
    geoPoint Objet L’instance de géopoint que vous souhaitez copier.
    Tableau 5. Renvoie
    Type Description
    géopoint Objet GlideGeoPoint résultant.

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

    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 d’une table spécifique, reportez-vous à la section Guide du développeur GlideGeoPoint.

    Tableau 6. Paramètres
    Nom Type Description
    Aucun
    Tableau 7. Renvoie
    Type Description
    Chaîne La valeur des coordonnées de longitude et de latitude définies dans l’objet. 
    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)

    Renvoie une liste de valeurs de coordonnées géographiques pour un nom de champ donné de type point géographique.

    Tableau 8. Paramètres
    Nom Type Description
    geo_point_field_name Chaîne Nom du champ de point géographique.
    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.

    Table : Entrée du dictionnaire [sys_dictionary]
    Tableau 9. Renvoie
    Type Description
    Objet Objet GlideGeoPoint résultant.

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

    Renvoie la valeur de latitude de l’objet GlideGeoPoint .

    Tableau 10. Paramètres
    Nom Type Description
    Aucun
    Tableau 11. Renvoie
    Type Description
    Chaîne La valeur de latitude de l’objet GlideGeoPoint . 
    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()

    Renvoie la valeur de longitude de l’objet GlideGeoPoint .

    Tableau 12. Paramètres
    Nom Type Description
    Aucun
    Tableau 13. Renvoie
    Type Description
    Chaîne La valeur de longitude de l’objet GlideGeoPoint . 
    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()

    Renvoie une chaîne contenant la longitude et la latitude de l’objet GlideGeoPoint actuel.

    Tableau 14. Paramètres
    Nom Type Description
    Aucun
    Tableau 15. Renvoie
    Type Description
    Chaîne Les valeurs de longitude et de latitude de l’objet GlideGeoPoint actuel. 
     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(longitude de la chaîne, latitude de la chaîne)

    Définit les valeurs de longitude et de latitude du géopoint.

    Tableau 16. Paramètres
    Nom Type Description
    longitude Chaîne Coordonnées longitudinales du géopoint.
    latitude Chaîne Coordonnées de latitude du géopoint.
    Tableau 17. Renvoie
    Type Description
    Chaîne Les valeurs de longitude et de latitude définies sur l’objet GlideGeoPoint . 
    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)

    Définit les valeurs de longitude et de latitude du géopoint à l’aide d’une seule valeur délimitée par des virgules.

    Tableau 18. Paramètres
    Nom Type Description
    valide Chaîne Valeur délimitée par des virgules contenant respectivement des points de longitude et de latitude.
    Tableau 19. Renvoie
    Type Description
    Chaîne Les valeurs de longitude et de latitude définies sur l’objet GlideGeoPoint .

    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