GlideGeoPoint – Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

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

    Die GlideGeoPoint- API ist standardmäßig verfügbar. Mit dem Datentyp „Geopunkt“ können Sie Breiten- und Längengrade in einem einzigen Feld innerhalb 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 zum Implementieren bestimmter Anwendungsfälle wie das Einfügen neuer Datensätze mithilfe eines Geopunkts, das Berechnen von Entfernungen zwischen Geopunktstandorten oder das Abfragen nahegelegener Geopunktstandorte finden Sie unter GlideGeoPoint-Entwicklerleitfaden.

    Wichtige Aspekte des Geotyp-Datentyps:
    • Er 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 beträgt [-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 durch Kommas getrenntes Paar angezeigt: „Längengrad, Breitengrad“. Klammern können den Ausdruck optional umgeben.
    • Sowohl Längen- als auch Breitengrade werden mit einer Genauigkeit von bis zu 6 Dezimalstellen gespeichert.
    Hinweis:
    GlideGeoPoint- API-Werte werden immer in der Reihenfolge Längengrad und Breitengrad aufgelistet.

    In den Beispielen auf dieser Seite wird davon ausgegangen, dass eine benutzerdefinierte Tabelle vorab 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 andernfalls als Zeichenfolgen gespeichert werden, semantische Aufmerksamkeit 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(String longitude, String width)

    Instantiiert das 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. Ergebnisse
    Typ Beschreibung
    Geopunkt Das resultierende GlideGeoPoint- Objekt.

    Das folgende Beispiel zeigt, wie das Objekt durch die Angabe von Längen- und Breitengradwerten 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ängen- 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. Ergebnisse
    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 Benutzers in einem benutzerfreundlichen Format zurück.

    Die Funktion getDisplayValue() gibt einen einzelnen Geopunktwert zurück. Informationen zum Abrufen aller Geopunktwerte 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 – getLatitude()

    Gibt den Breitengradwert des GlideGeoPoint- Objekts zurück.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 9. 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 – getLongitude()

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

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. 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 programmatischen Längen- und Breitengradwert des aktuellen GlideGeoPoint- Objekts enthält.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. 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(String longitude, String width)

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

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    longitude Zeichenfolge Die Längskoordinate des Geopunkts.
    latitude Zeichenfolge Die Breitengradkoordinate des Geopunkts.
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der im 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(String value)

    Legt die Längen- und Breitengrade des Geopunkts mit einem einzigen durch Kommas getrennten Wert fest.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Kommagetrennter Wert, der Längen- und Breitengrade enthält.
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Der im GlideGeoPoint- Objekt festgelegte Längen- und Breitengradwert.

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

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

    Ausgabe:

    geopoint: -23.400000,56.700000