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

The GlideGeoPoint 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.
Note: 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.

Table 1. Parameters
Name Type Description
None

Example

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.

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

Example

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.

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

Example

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() function returns a single geopoint value. For information about how to retrieve all geopoint values from a specific table, see GlideGeoPoint Developer Guide.

Table 6. Parameters
Name Type Description
None
Table 7. Returns
Type Description
String The value of the longitude and latitude coordinates set in the object.

Example

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

Returns the latitude value of the GlideGeoPoint object.

Table 8. Parameters
Name Type Description
None
Table 9. Returns
Type Description
String The latitude value of the GlideGeoPoint object.

Example

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.

Table 10. Parameters
Name Type Description
None
Table 11. Returns
Type Description
String The longitude value of the GlideGeoPoint object.

Example

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.

Table 12. Parameters
Name Type Description
None
Table 13. Returns
Type Description
String The longitude and latitude value of the current GlideGeoPoint object.

Example

 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.

Table 14. Parameters
Name Type Description
longitude String The longitudinal coordinate of the geopoint.
latitude String The latitude coordinate of the geopoint.
Table 15. Returns
Type Description
String The longitude and latitude value set on the GlideGeoPoint object.

Example

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.

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

Example

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