GlideGeoPoint : global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Mit der GlideGeoPoint -API können Sie Werte des Geopunkt-Datentyps in einer Tabelle abrufen und festlegen.

    Diese API ist standardmäßig verfügbar. Mit dem Datentyp „Geopunkt“ können Sie Werte für den Breiten- und Längengrad in einem einzigen Feld in einer Tabelle speichern. Mit der GlideGeoPoint- API können Sie neue GlideGeoPoint-Objekte instanziieren, neue Geopunkte für eine bestimmte Tabelle erstellen oder einzelne Breitengrad-, Längengrad- oder Geotypwerte abrufen. Weitere Informationen zur Implementierung bestimmter Anwendungsfälle wie zum Einfügen neuer Datensätze mithilfe eines Geopunkts, zum Berechnen von Entfernungen zwischen Geopunktstandorten oder zum Abfragen von nahegelegenen Geopunktstandorten finden Sie unter GlideGeoPoint Developer Guide.

    Wichtige Aspekte des Geotyp-Datentyps sind:
    • Sie besteht aus einem Paar Dezimalzahlen, die Längen- und Breitengrade 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.
    • Geopunktwerte werden immer als Eingabe akzeptiert und als kommagetrenntes Paar angezeigt: „Längengrad,Breitengrad“. Der Ausdruck kann optional von Klammern umgeben werden.
    • Sowohl Längen- als auch Breitengradwerte werden mit einer Genauigkeit von bis zu 6 Dezimalstellen gespeichert.
    Hinweis:
    GlideGeoPoint- API-Werte werden immer in Längengrad-/Breitengradreihenfolge aufgelistet.

    Die Beispiele auf dieser Seite gehen davon aus, dass eine benutzerdefinierte Tabelle bereits mit Feldern ausgefü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 ein GlideGeoPoint -Objekt. Das GlideGeoPoint -Objekt fügt Längen- und Breitengradwerten, die ansonsten als Zeichenfolgen gespeichert werden, semantische Aufmerksamkeit hinzu.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

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

    var gp = new GlideGeoPoint();

    GlideGeoPoint: GlideGeoPoint(Zeichenfolge-Längengrad, Zeichenfolgen-Breitengrad)

    Instanziiert das GlideGeoPoint- Objekt gemäß den angegebenen Werten für Längengrad und Breitengrad.

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

    Das folgende Beispiel zeigt, wie durch die Angabe von Längengrad- 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(Object geoPoint)

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

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    geoPoint Objekt Die Geopunkt-Instanz, die Sie kopieren möchten.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Geopunkt Das 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 Geopunkt des aktuellen Anwenders in einem anwenderfreundlichen Format zurück.

    Die getDisplayValue() -Methode gibt einen einzelnen Geopunktwert zurück. Informationen zum Abrufen aller Geopunktwerte aus einer bestimmten Tabelle finden Sie unter GlideGeoPoint Developer Guide.

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

    Gibt eine Liste von Geopunkt-Koordinatenwerten 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. Die test_table enthält einen Datensatz in der Spalte „geo_point“ mit einem Wert von (-30,560000,-54,330000). 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 – getLatude()

    Gibt den Breitengradwert des GlideGeoPoint- Objekts zurück.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Breitengradwert des GlideGeoPoint- Objekts. 
    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 – getLongitudit ()

    Gibt den Längengradwert des GlideGeoPoint- Objekts zurück.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Längengradwert des GlideGeoPoint- Objekts. 
    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 GlideGeoPoint- Objekts enthält.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der Längen- und Breitengradwert des aktuellen GlideGeoPoint- Objekts. 
     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(Zeichenfolge Längengrad, Zeichenfolge Breitengrad)

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

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    longitude Zeichenfolge Die Längengradkoordinate des Geopunkts.
    latitude Zeichenfolge Der Breitengradkoordinate des Geopunkts.
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der für das GlideGeoPoint- Objekt festgelegte Längen- und Breitengradwert 
    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 Breitengrade des Geopunkts mit einem einzelnen durch Kommas getrennten Wert fest.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Ein durch Kommas getrennter Wert, der Längengrad- bzw. Breitengradpunkte enthält.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Zeichenfolge Der für das GlideGeoPoint- Objekt festgelegte Längen- und Breitengradwert

    Das folgende Beispiel zeigt, wie Sie die Werte für Längengrad und Breitengrad mithilfe einer einzelnen Zeichenfolge festlegen.

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

    Ausgabe:

    geopoint: -23.400000,56.700000