GlideGeoPoint - Global

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 12분

    • The GlideGeoPoint API enables you to get and set geopoint data type values in a table.

    This API is available by default. The geopoint data type allows you to store a latitude and longitude values in a single field within a table. Using the GlideGeoPoint API, you can instantiate new GlideGeoPoint objects, create new geopoints for a specific table, or retrieve single latitude, longitude or geotype values. For additional information on how to implement specific use cases like inserting new records using a geopoint, computing distances between geopoint locations, or querying for nearby geopoint locations, see GlideGeoPoint Developer Guide.

    Key aspects of the geotype data type are:
    • It consists of a pair of decimal numbers representing longitude and latitude values.
    • The range for longitude is (-180, 180]. Any value outside this range is normalized to the equivalent value inside this range.
    • The range for latitude is [-90, 90]. Any value outside this range is normalized to the equivalent value inside this range.
    • Geopoint values are always accepted as input and display as a comma-separated pair: “longitude,latitude”. Parentheses may optionally surround the expression.
    • Both longitude and latitude values are stored up to 6 decimal places of precision.
    주:
    GlideGeoPoint API values are always listed in longitude, latitude order.

    The examples on this page assume that a custom table is pre-populated with fields containing the geopoint field type. For more information about this data type, see Geo point field type and Function field.

    GlideGeoPoint - GlideGeoPoint()

    Instantiates a GlideGeoPoint object. The GlideGeoPoint object adds semantic awareness to longitude and latitude values that are otherwise stored as strings.

    표 1. Parameters
    Name Type Description
    None

    The following example shows how to initialize a new GlideGeoPoint object as a null value.

    var gp = new GlideGeoPoint();

    GlideGeoPoint - GlideGeoPoint(String longitude, String latitude)

    Instantiates the GlideGeoPoint object according to provided longitude and latitude values.

    표 2. Parameters
    Name Type Description
    longitude String The longitude coordinate of the geopoint.
    latitude String The latitude coordinate of the geopoint.
    표 3. Returns
    Type Description
    geopoint The resultant GlideGeoPoint object.

    The following example shows how providing longitude and latitude values initializes the object accordingly.

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

    Output:

    geopoint: 10.123000,25.987000

    GlideGeoPoint - GlideGeoPoint(Object geoPoint)

    Copies longitude and latitude points values to instantiate a new GlideGeoPoint object.

    표 4. Parameters
    Name Type Description
    geoPoint Object The geopoint instance that you want copy.
    표 5. Returns
    Type Description
    geopoint The resultant GlideGeoPoint object.

    The following example shows how to copy longitude and latitude values to instantiate a new GlideGeoPoint object.

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

    GlideGeoPoint - getDisplayValue()

    Returns the geopoint of the current user in a user-friendly format.

    The getDisplayValue() method returns a single geopoint value. For information about how to retrieve all geopoint values from a specific table, see GlideGeoPoint Developer Guide.

    표 6. Parameters
    Name Type Description
    None
    표 7. Returns
    Type Description
    String The value of the longitude and latitude coordinates set in the object. 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp); 
gs.info("getDisplayValue(): " + gp.getDisplayValue());

    Output:

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

    GlideGeoPoint - getGeoPoint(String geo_point_field_name)

    Returns a list of geo point coordinate values for a given field name of type geo point.

    표 8. Parameters
    Name Type Description
    geo_point_field_name String Name of the geo point field.
    주:
    You can also locate field names under dictionary elements defined on a table to see associated fields of geo point type.

    Table: Dictionary Entry [sys_dictionary]
    표 9. Returns
    Type Description
    Object Resultant GlideGeoPoint object.

    In the following example, 'test_table' is a table which contains the 'geo_point' field of geo point type. The test_table has one record populated in the geo_point column with a value of (-30.560000,-54.330000). The example code returns the latitude and longitude coordinates and display value of the record in geo_point column.

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

    Output:

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

    GlideGeoPoint - getLatitude()

    Returns the latitude value of the GlideGeoPoint object.

    표 10. Parameters
    Name Type Description
    None
    표 11. Returns
    Type Description
    String The latitude value of the GlideGeoPoint object. 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      

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

    Output:

    geopoint: 76.250000,49.750000 
getLatitude(): 49.75

    GlideGeoPoint - getLongitude()

    Returns the longitude value of the GlideGeoPoint object.

    표 12. Parameters
    Name Type Description
    None
    표 13. Returns
    Type Description
    String The longitude value of the GlideGeoPoint object. 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);  
gs.info("getLongitude(): " + gp.getLongitude());

    Output:

    geopoint: 76.250000,49.750000 
 getLongitude(): 76.25

    GlideGeoPoint - getValue()

    Returns a string containing the programmatic longitude and latitude value of the current GlideGeoPoint object.

    표 14. Parameters
    Name Type Description
    None
    표 15. Returns
    Type Description
    String The longitude and latitude value of the current GlideGeoPoint object. 
     var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);
gs.info("getValue(): " + gp.getValue());

    Output:

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

    GlideGeoPoint - setValue(String longitude, String latitude)

    Sets the longitude and latitude values of the geopoint.

    표 16. Parameters
    Name Type Description
    longitude String The longitudinal coordinate of the geopoint.
    latitude String The latitude coordinate of the geopoint.
    표 17. Returns
    Type Description
    String The longitude and latitude value set on the GlideGeoPoint object. 
    var gp = new GlideGeoPoint(); 
gp.setValue("-28.48,38.91");      
gs.info("geopoint: " + gp);

    Output:

    geopoint: -28.480000,38.910000

    GlideGeoPoint - setValue(String value)

    Sets the longitude and latitude values of the geopoint using a single comma-delimited value.

    표 18. Parameters
    Name Type Description
    value String A comma-delimited value containing longitude and latitude points respectively.
    표 19. Returns
    Type Description
    String The longitude and latitude value set on the GlideGeoPoint object.

    The following example shows how to set the longitude and latitude values using a single string.

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

    Output:

    geopoint: -23.400000,56.700000