---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideGeoPoint-Entwicklerleitfaden

# GlideGeoPoint-Entwicklerleitfaden {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

Der GlideGeoPoint-Entwicklerleitfaden enthält Informationen darüber, wie Entfernungen zwischen Breiten- und Längengradwerten (Geopunkte) berechnet, Standorte innerhalb bestimmter Geopunkt- und Radiuswerte zurückgegeben und zusätzliche Funktionen verwendet werden, die von unterstützt bereitgestellt werden GlideGeoPoint API-Funktionen.
Die [Geo point field type](https://www.servicenow.com/docs/access?context=geo-point-field-type&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)Ermöglicht das Speichern eines Breiten- und Längengradpaars in einem einzelnen Feld. Geopunkte können jederzeit nützlich sein, wenn Sie einen geografischen Punkt speichern möchten, um zu fragen, wie weit ein Teil zwei Punkte des Interesses voneinander entfernt sind, oder um nach allen Punkten in einer bestimmten Entfernung von einem anderen Punkt zu suchen. Sie können beispielsweise die Geopoint-Funktion verwenden, um schnell alle Lieferorte Ihres Kunden zu bestimmen und dann die Liefergebühren basierend auf der Entfernung zum Store anzupassen.  
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 mit Genauigkeit gespeichert.

Weitere Informationen zum Geopoint-Datentyp finden Sie unter [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

Die Beispiele in diesem Leitfaden gehen davon aus, dass eine anwenderdefinierte Tabelle, `u_Geopoint `, Ist mit Feldern ausgefüllt `u_Name `Und `u_location `, Wo `u_Name `Ist vom Typ „Zeichenfolge" und listet die Namen der wichtigsten Städte und auf `u_location `Ist vom Typ „Geopunkt" und listet die Breiten-/Längengradpunkte jeder Stadt auf.

## Erstellen Sie Geopunkte mit der GlideGeoPoint-API {#ariaid-title2}

Verwenden Sie GlideGeoPoint API zum Einfügen neuer Datensätze und Erstellen neuer Geopunkte.
Die [GlideGeoPoint -- Global](https://servicenow-prod.fluidtopics.net/iiXZOxVwQOf2Bbli4gFprg#GlideGeopointGlobalAPI "Die GlideGeoPoint Mit der API können Sie Geopoint-Datentypwerte in einer Tabelle abrufen und festlegen.")Mit der API können Sie Geopoint-Werte festlegen und abrufen. Sie können jedoch zusätzliche Funktionen zum Einfügen neuer Datensätze ausführen, indem Sie Geopunkte direkt in einem Skript mithilfe von Zeichenfolgennotation oder einem GlideGeoPoint-Objekt festlegen.

Einfügen eines neuen Datensatzes mit Zeichenfolgennotation.
:   Legen Sie den Wert des Geopoint-Felds fest `u_location `Mit einer Zeichenfolge. Die Zeichenfolge besteht aus einem kommagetrennten Paar von Längen- und Breitengradwerten. Das folgende Beispiel zeigt, wie ein neuer Geopunkt in festgelegt wird `u_Geopoint `Tabelle mit Zeichenfolgennotation.  
    Hinweis:  
    GlideGeoPoint API-Werte werden immer in Längen- und Breitengradreihenfolge aufgeführt.

        const longitude = "-87.628018"; 
        const latitude = "41.885778"; 
        const geopoint = longitude + "," + latitude; 
         
        const myGeoPoint = new GlideRecord("u_geopoint"); 
        myGeoPoint.initialize(); 
        myGeoPoint.setValue("u_name", "Chicago"); 
        myGeoPoint.setValue("u_location", geopoint); 
        myGeoPoint.insert();

    {#glidegeopoint_create_geo_points__codeblock_scc_ryq_fyb}

Einfügen eines neuen Datensatzes mithilfe des GlideGeoPoint-Objekts.
:   Legen Sie den Wert des Geopoint-Felds fest `u_location `Mit einem GlideGeoPoint-Objekt.

        const longitude = -87.628018; 
        const latitude = 41.885778; 
        const geopoint = new GlideGeoPoint(longitude, latitude); 
         
        const myGeoPoint = new GlideRecord("u_geopoint"); 
        myGeoPoint.initialize(); 
        myGeoPoint.setValue("u_name", "Chicago"); 
        myGeoPoint.setValue("u_location", geopoint); 
        myGeoPoint.insert();

    {#glidegeopoint_create_geo_points__codeblock_tcc_ryq_fyb}
{#glidegeopoint_create_geo_points__dl_qry_xzq_fyb}

## Lesen Sie Geopoint-Werte mit der GlideGeoPoint-API {#ariaid-title3}

Verwenden Sie GetDisplayValue() GlideGeoPoint-API-Funktion zum Lesen aller Geopoint-Werte aus einer bestimmten Tabelle.
Mit der standardmäßigen GlideGeoPoint-API können Sie einen Geopunkt-Wert über abrufen [GlideGeoPoint -- getDisplayValue()](https://servicenow-prod.fluidtopics.net/iiXZOxVwQOf2Bbli4gFprg#GlideGeoPoint-getDisplayValue "Gibt den Geopunkt des aktuellen Anwenders in einem anwenderfreundlichen Format zurück.")Funktion. Es ist jedoch möglich, alle in einer gesamten Tabelle definierten Geopunkte zu lesen. Das folgende Beispielskript demonstriert, wie Sie verwenden GetDisplayValue() Funktion zum Abrufen aller Datensätze aus `u_Geopoint `Tabelle, die enthält `u_location `Feld vom Typ „Geopoint". Sie können dieses Beispielskript an Ihren eigenen spezifischen Anwendungsfall anpassen.  
Hinweis:  
GlideGeoPoint API-Werte werden immer in Längen- und Breitengradreihenfolge aufgeführt.

    const myGeoPoint = new GlideRecord("u_geopoint"); 
    myGeoPoint.query(); 
     
    while (gr.next()) 
      gs.info("Name: {0}  Location: {1}",  
        myGeoPoint.getDisplayValue('u_name'),  
        myGeoPoint.getDisplayValue('u_location'));

{#glidegeopoint-read_gp_values__codeblock_agf_nzq_fyb}

Die Ausgabe gibt alle Datensätze in zurück `u_Geopoint `Tabelle. Der Anzeigewert eines Geopunkts enthält den Längengrad gefolgt vom Breitengrad, getrennt durch ein Komma und umgeben in Klammern.

    Name: London  Location: (-0.189937, 51.473584) 
    Name: Puerto Rico  Location: (-66.561301, 18.291136) 
    Name: Glasgow  Location: (-4.223964, 55.867846) 
    Name: Chicago  Location: (-87.628018, 41.885778) 
    Name: Tasmania  Location: (146.757677, -42.173578) 
    Name: Bermuda  Location: (-64.761595, 32.315798) 
    Name: Miami  Location: (-80.206458, 25.767242) 
    Name: Sydney  Location: (151.205230, -33.890115) 
    Name: Perth  Location: (115.871253, -31.971583) 
    Name: Dublin  Location: (-6.304994, 53.348317)

{#glidegeopoint-read_gp_values__codeblock_bgf_nzq_fyb}

## Berechnen Sie die Entfernung zwischen zwei Geopunkten {#ariaid-title4}

Verwenden Sie `Distance_Sphere `Glide-Funktion, um die Entfernung zwischen Geopunkten in Metern zurückzugeben.
Die Geopoint-Glide-Funktion, `Distance_Sphere `, Ermöglicht Ihnen die Berechnung der Entfernung zwischen zwei Geopunkten. Die Funktion gibt die Entfernung in Metern zurück. `Distance_Sphere `Kann in der Definition eines Funktionsfeldelements in einer Tabelle oder über ein Skript verwendet werden. Drei Syntaxen werden unterstützt, und alle Parameter sind erforderlich:

* `Glidefunktion:distance_Sphere(geopoint1, geopoint2)`
* `Glidefunktion:distance_Sphere(geopoint1, longitude2, Breiten2)`
* `Glidefunktion:distance_Sphere(longitude1, Breiten1, longitude2, Breiten2)`

{#glidegeopoint-calc_distance_btw_gp__geopoint-dev-guide_ul_yj2_l1y_wxb}

Beachten Sie bei Verwendung dieser Syntaxen Folgendes:

* Geopoint1 und geopoint2 sind Tabellenelemente vom Typ „Geopoint".
* Längen1, Längengrad 2, Breitengrad 1, Breitengrad 2 sind numerische Tabellenelemente oder -Konstanten
* In allen Fällen ist der Rückgabewert dieser Funktion eine Dezimalzahl, die die Entfernung zwischen zwei Geopunkten in Metern darstellt
{#glidegeopoint-calc_distance_btw_gp__ul_inn_33p_fyb}  
Das folgende Beispielskript definiert ein `Distance_Sphere `Funktion zum Berechnen der Entfernung zwischen allen in gespeicherten Geopunkten `u_location `Feld von `u_Geopoint `Tabelle und Punkt `-0,189937 `Längengrad, `51,473584 `Breitengrad (ungefähr der Standort von London). Die Funktion wird der GlideRecord-Abfrage hinzugefügt, um Ergebnisse zu erzeugen.

    const distToLondon =  
    "glidefunction:distance_sphere(u_location, '-0.189937', '51.473584')"; 
     
    const myGeoPoint = new GlideRecord('u_geopoint'); 
    gr.addFunction(distToLondon); 
    gr.query(); 
     
    while(myGeoPoint.next()) 
      gs.info("Name: {0}  Dist to London(m): {1}",  
        myGeoPoint.u_name, gr.getValue(distToLondon));

{#glidegeopoint-calc_distance_btw_gp__codeblock_hqw_pxw_fyb}

Die Ausgabe listet die Entfernung zwischen London und Städten in auf `u_location `Feld in Metern.

    Name: London  Dist to London(m): 0 
    Name: Glasgow  Dist to London(m): 555985.58456358 
    Name: Dublin  Dist to London(m): 464000.328892816 
    Name: Miami  Dist to London(m): 7123803.25406323 
    Name: Bermuda  Dist to London(m): 5547607.95564083 
    Name: Puerto Rico  Dist to London(m): 6799201.00905107 
    Name: Perth  Dist to London(m): 14485217.5596414 
    Name: Sydney  Dist to London(m): 17001034.4875494 
    Name: Tasmania  Dist to London(m): 17324634.4559516 

{#glidegeopoint-calc_distance_btw_gp__codeblock_iqw_pxw_fyb}

## Filtern Sie den Abstand zwischen zwei Geopunkten {#ariaid-title5}

Verwenden Sie `DISTANCE_SPHERE_WITHIN `Abfragebedingung zum Filtern nach Datensätzen mit einem Geopunkt-Wert innerhalb des Radius eines definierten Breitengrads und Längengradpunkts.  
`DISTANCE_SPHERE_WITHIN `Muss der Syntax folgen `GeopointDISTANCE_SPHERE_WITHINlongitude,Breitengrad<Radius `Wobei:

* `Geopunkt `Ist ein Geopoint-Feld
* `Längengrad `Und `Breitengrad `Sind Dezimalkonstanten
* `Radius `Ist eine Dezimalkonstante (in Metern)

{#glidegeopoint-filter_dist_btw_gp__ul_wl2_qy5_2yb}  
Hinweis:  
Das kleiner-als-Symbol (\<) in diesem Ausdruck ist erforderlich und wird nur als Trennzeichen verwendet. Jeder andere Vergleichsoperator ist ungültig.

Die `DISTANCE_SPHERE_WITHIN `Akzeptiert Kilometer- oder Zählerwerte in der Anforderung, gibt den Ausgabewert jedoch immer in Metern zurück.  
Das folgende Beispielskript zeigt, wie eine codierte Abfrage erstellt wird, die nur Datensätze mit zurückgibt `u_location `Weniger als 1.000.000 Kilometer vom Punkt entfernt `-0,189937 `Längengrad, `51,473584 `Breitengrad (ungefähr der Standort von London). Bei der Ausführung werden drei Datensätze zurückgegeben, die Städte innerhalb des angegebenen Radius von London darstellen.

    const myGeoPoint = new GlideRecord("u_geopoint");  
    myGeoPoint.addEncodedQuery("u_locationDISTANCE_SPHERE_WITHIN-0.189937,51.473584<1000000");  
    myGeoPoint.query(); 
     
    while(gr.next()) 
        gs.info("Name:" + myGeoPoint.getDisplayValue("u_name")   
             + " Location:" + myGeoPoint.getDisplayValue("u_location"));

{#glidegeopoint-filter_dist_btw_gp__codeblock_cgn_wxw_fyb}

Ausgabe:

    Name:London Location:(-0.189937, 51.473584) 
    Name:Dublin Location:(-6.304994, 53.348317) 
    Name:Glasgow Location:(-4.223964, 55.867846)

{#glidegeopoint-filter_dist_btw_gp__codeblock_dgn_wxw_fyb}  
Das folgende Beispielskript entspricht dem ersten, verwendet jedoch eine alternative Syntax für GlideRecord.

    const myGeoPoint = new GlideRecord("u_geopoint");  
    myGeoPoint.addQuery("u_location", "DISTANCE_SPHERE_WITHIN", "-0.189937,51.473584<1000000");  
    myGeoPoint.query(); 
     
    while(myGeoPoint.next()) 
        gs.info("Name:" + myGeoPoint.getDisplayValue("u_name")   
             + " Location:" + myGeoPoint.getDisplayValue("u_location"));

{#glidegeopoint-filter_dist_btw_gp__codeblock_egn_wxw_fyb}

Ausgabe:

    Name:London Location:(-0.189937, 51.473584) 
    Name:Dublin Location:(-6.304994, 53.348317) 
    Name:Glasgow Location:(-4.223964, 55.867846)

{#glidegeopoint-filter_dist_btw_gp__codeblock_fgn_wxw_fyb}

