GlideGeoPoint : global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 4 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.

    L’API GlideGeoPoint est disponible par défaut. Le type de données de géopoint vous permet de stocker des valeurs de latitude et de longitude dans un seul champ au sein 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 la façon d’implémenter des 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éopoints ou l’interrogation d’emplacements de géopoints proches, reportez-vous à la section Guide du développeur GlideGeoPoint.

    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 de (-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 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 de géopoint. Pour plus d’informations sur ce type de données, reportez-vous aux rubriques 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(String longitude, String latitude)

    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 l’indication 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)

    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 fonction getDisplayValue() renvoie une seule valeur de géopoint. Pour plus d’informations sur la récupération de toutes les valeurs de géopoints à partir 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 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 : getLatitude()

    Renvoie la valeur de latitude de l’objet GlideGeoPoint .

    Tableau 8. Paramètres
    Nom Type Description
    Aucun
    Tableau 9. Renvoie
    Type Description
    Chaîne 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 10. Paramètres
    Nom Type Description
    Aucun
    Tableau 11. Renvoie
    Type Description
    Chaîne 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 valeur programmatique de longitude et de latitude de l’objet GlideGeoPoint actuel.

    Tableau 12. Paramètres
    Nom Type Description
    Aucun
    Tableau 13. Renvoie
    Type Description
    Chaîne Valeur 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(String longitude, String latitude)

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

    Tableau 14. Paramètres
    Nom Type Description
    longitude Chaîne Coordonnée longitudinale du géopoint.
    latitude Chaîne Coordonnées de latitude du géopoint.
    Tableau 15. 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 séparée par des virgules.

    Tableau 16. Paramètres
    Nom Type Description
    valide Chaîne Valeur séparée par des virgules contenant respectivement les points de longitude et de latitude.
    Tableau 17. 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