GlideGeoPoint – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Die GlideGeoPoint Mit der API können Sie Geopoint-Datentypwerte in einer Tabelle abrufen und festlegen.

    Diese API ist standardmäßig verfügbar. Mit dem Geopoint-Datentyp können Sie Werte für Breiten- und Längengrad in einem einzelnen Feld innerhalb einer Tabelle speichern. Mit GlideGeoPoint API können Sie neue GlideGeoPoint-Objekte instanziieren, neue Geopunkte für eine bestimmte Tabelle erstellen oder einzelne Breiten-, Längen- oder Geotypwerte abrufen. Weitere Informationen zur Implementierung bestimmter Anwendungsfälle, z. B. das Einfügen neuer Datensätze mithilfe eines Geopunkts, die Berechnung von Entfernungen zwischen Geopunktstandorten oder die Abfrage von Geopunkt-Standorten in der Nähe, finden Sie unter GlideGeoPoint-Entwicklerleitfaden.

    Wichtige Aspekte des Geotypdatentyps sind:
    • Sie besteht aus einem Paar von Dezimalzahlen, die Längen- und Breitengradwerte darstellen.
    • Der Bereich für den Längengrad ist (-180, 180]. Jeder Wert außerhalb dieses Bereichs wird auf den entsprechenden Wert innerhalb dieses Bereichs normalisiert.
    • Der Bereich für den Breitengrad ist [-90, 90]. Jeder Wert außerhalb dieses Bereichs wird auf den entsprechenden Wert innerhalb dieses Bereichs normalisiert.
    • Geopoint-Werte werden immer als Eingabe akzeptiert und als kommagetrenntes Paar angezeigt: „Längengrad,Breitengrad“. Klammern können den Ausdruck optional umgeben.
    • Sowohl Längen- als auch Breitengradwerte werden bis zu 6 Dezimalstellen der Genauigkeit gespeichert.
    Hinweis:
    GlideGeoPoint API-Werte werden immer in Längen- und Breitengradreihenfolge aufgeführt.

    Die Beispiele auf dieser Seite gehen davon aus, dass eine anwenderdefinierte Tabelle vorab mit Feldern gefüllt ist, die den Feldtyp „Geopunkt“ enthalten. Weitere Informationen zu diesem Datentyp finden Sie unter Geo point field type Und Function field.

    GlideGeoPoint: GlideGeoPoint()

    Instanziiert einen GlideGeoPoint Objekt. Die GlideGeoPoint Das Objekt fügt Längen- und Breitengradwerte, die andernfalls als Zeichenfolgen gespeichert werden, ein semantisches Bewusstsein hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein neues GlideGeoPoint-Objekt als Nullwert initialisiert wird.

    var gp = new GlideGeoPoint();

    GlideGeoPoint – GlideGeoPoint(Längengrad der Zeichenfolge, Breitengrad der Zeichenfolge)

    Instanziiert GlideGeoPoint Objekt gemäß den angegebenen Längen- und Breitengradwerten.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    longitude Zeichenfolge Die Längengradkoordinate des Geopunkts.
    latitude Zeichenfolge Die Breitengradkoordinate des Geopunkts.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Geopunkt Der resultierende GlideGeoPoint Objekt.

    Das folgende Beispiel zeigt, wie durch die Bereitstellung von Längen- und Breitengradwerten das Objekt entsprechend initialisiert wird.

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

    Ausgabe:

    geopoint: 10.123000,25.987000

    GlideGeoPoint – GlideGeoPoint (Objekt-Geopoint)

    Kopiert Längen- und Breitengradpunktwerte, um ein neues GlideGeoPoint-Objekt zu instanziieren.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Geopunkt Objekt Die Geopoint-Instanz, die Sie kopieren möchten.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Geopunkt Der resultierende GlideGeoPoint Objekt.

    Das folgende Beispiel zeigt, wie Längen- und Breitengradwerte kopiert werden, um ein neues GlideGeoPoint-Objekt zu instanziieren.

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

    GlideGeoPoint – getDisplayValue()

    Gibt den Geopoint des aktuellen Anwenders in einem anwenderfreundlichen Format zurück.

    Die GetDisplayValue() Methode gibt einen einzelnen Geopoint-Wert zurück. Informationen zum Abrufen aller Geopoint-Werte aus einer bestimmten Tabelle finden Sie unter GlideGeoPoint-Entwicklerleitfaden.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Wert der im Objekt festgelegten Längen- und Breitengradkoordinaten. 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp); 
gs.info("getDisplayValue(): " + gp.getDisplayValue());

    Ausgabe:

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

    GlideGeoPoint – getGeoPoint(Zeichenfolge Geo_Point_field_Name)

    Gibt eine Liste von Geopunktkoordinatenwerten für einen bestimmten Feldnamen vom Typ „Geopunkt“ zurück.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Geo_Point_field_Name Zeichenfolge Name des Geopunktfelds.
    Hinweis:
    Sie können Feldnamen auch unter Wörterbuchelementen suchen, die in einer Tabelle definiert sind, um zugehörige Felder des Geopunkttyps anzuzeigen.

    Tabelle: Wörterbucheintrag [sys_dictionary]
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Objekt Resultierendes GlideGeoPoint-Objekt.

    Im folgenden Beispiel ist „Test_table“ eine Tabelle, die das Feld „Geo_Point“ des Geopunkttyps enthält. Für „Test_table“ ist ein Datensatz in der Spalte „Geo_point“ mit einem Wert von (-30.560000,-54.330000) ausgefüllt. Der Beispielcode gibt die Breiten- und Längengradkoordinaten und den Anzeigewert des Datensatzes in der Spalte „Geo_Point“ zurück.

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

    Ausgabe:

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

    GlideGeoPoint – getLatitude()

    Gibt den Breitengradwert von zurück GlideGeoPoint Objekt.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Breitengradwert des GlideGeoPoint Objekt. 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      

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

    Ausgabe:

    geopoint: 76.250000,49.750000 
getLatitude(): 49.75

    GlideGeoPoint – getLongitude()

    Gibt den Längengradwert von zurück GlideGeoPoint Objekt.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Längengradwert des GlideGeoPoint Objekt. 
    var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);  
gs.info("getLongitude(): " + gp.getLongitude());

    Ausgabe:

    geopoint: 76.250000,49.750000 
 getLongitude(): 76.25

    GlideGeoPoint – getValue()

    Gibt eine Zeichenfolge zurück, die den programmgesteuerten Längen- und Breitengradwert des aktuellen Elements enthält GlideGeoPoint Objekt.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Längen- und Breitengradwert des aktuellen Elements GlideGeoPoint Objekt. 
     var gp = new GlideGeoPoint(); 
gp.setValue(76.25, 49.75);      
gs.info("geopoint: " + gp);
gs.info("getValue(): " + gp.getValue());

    Ausgabe:

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

    GlideGeoPoint – setValue(Längengrad der Zeichenfolge, Breitengrad der Zeichenfolge)

    Legt die Längen- und Breitengradwerte des Geopunkts fest.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    longitude Zeichenfolge Die Längskoordinate des Geopunkts.
    latitude Zeichenfolge Die Breitengradkoordinate des Geopunkts.
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Wert für Längen- und Breitengrad, der auf festgelegt ist GlideGeoPoint Objekt. 
    var gp = new GlideGeoPoint(); 
gp.setValue("-28.48,38.91");      
gs.info("geopoint: " + gp);

    Ausgabe:

    geopoint: -28.480000,38.910000

    GlideGeoPoint – setValue(Zeichenfolgenwert)

    Legt die Längen- und Breitengradwerte des Geopunkts mithilfe eines einzelnen kommagetrennten Werts fest.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Ein kommagetrennter Wert, der Längen- und Breitengradpunkte enthält.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der Wert für Längen- und Breitengrad, der auf festgelegt ist GlideGeoPoint Objekt.

    Das folgende Beispiel zeigt, wie die Längen- und Breitengradwerte mit einer einzelnen Zeichenfolge festgelegt werden.

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

    Ausgabe:

    geopoint: -23.400000,56.700000