---
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 -- Global

# GlideGeoPoint -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/AHqUgkjNlPotKTkP7JD25A#geopoint-dev-guide "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.").  
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.  
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 Geopoint-Feldtyp enthalten. Weitere Informationen zu diesem Datentyp finden Sie unter [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)Und [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).

## GlideGeoPoint: GlideGeoPoint() {#ariaid-title2}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#GlideGeoPoint-GlideGeoPoint__table_dhw_y13_mxb}  
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) {#ariaid-title3}

Instanziiert GlideGeoPoint Objekt gemäß den angegebenen Längen- und Breitengradwerten.
{#GlideGeoPoint-GlideGeoPoint_S_S__table_jf5_zvc_wxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| longitude | Zeichenfolge | Die Längengradkoordinate des Geopunkts. |
| latitude | Zeichenfolge | Die Breitengradkoordinate des Geopunkts. |
[Tabelle : 2. Parameter]

{#GlideGeoPoint-GlideGeoPoint_S_S__table_jf5_zvc_wxb} {#GlideGeoPoint-GlideGeoPoint_S_S__table_kf5_zvc_wxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Geopunkt | Der resultierende GlideGeoPoint Objekt. |
[Tabelle : 3. Rückgaben]

{#GlideGeoPoint-GlideGeoPoint_S_S__table_kf5_zvc_wxb}  
Das folgende Beispiel zeigt, wie durch die Angabe 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-Geopunkt) {#ariaid-title4}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Geopunkt | Objekt | Die Geopoint-Instanz, die Sie kopieren möchten. |
[Tabelle : 4. Parameter]

{#GlideGeoPoint-GlideGeoPoint_O__table_egf_cxc_wxb} {#GlideGeoPoint-GlideGeoPoint_O__table_fgf_cxc_wxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Geopunkt | Der resultierende GlideGeoPoint Objekt. |
[Tabelle : 5. Rückgaben]

{#GlideGeoPoint-GlideGeoPoint_O__table_fgf_cxc_wxb}  
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() {#ariaid-title5}

Gibt den Geopunkt 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](https://servicenow-prod.fluidtopics.net/AHqUgkjNlPotKTkP7JD25A#geopoint-dev-guide "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.").
{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb} {#GlideGeoPoint-getDisplayValue__table_sr1_24t_qxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert der im Objekt festgelegten Längen- und Breitengradkoordinaten. |
[Tabelle : 7. Rückgaben]

{#GlideGeoPoint-getDisplayValue__table_sr1_24t_qxb}  

    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) {#ariaid-title6}

Gibt eine Liste von Geo-Punkt-Koordinatenwerten für einen bestimmten Feldnamen vom Typ „Geo-Punkt" zurück.
{#GlideGeoPoint-getGeoPoint_S__table_bz4_jsl_5bc__entry__3}

| 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 vom Geopunkttyp anzuzeigen. Tabelle: Wörterbucheintrag \[sys_dictionary\] |
[Tabelle : 8. Parameter]

{#GlideGeoPoint-getGeoPoint_S__table_bz4_jsl_5bc} {#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Resultierendes GlideGeoPoint-Objekt. |
[Tabelle : 9. Rückgaben]

{#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc}  
Im folgenden Beispiel ist „Test_table" eine Tabelle, die das Feld „Geo_Point" des Geo-Punkt-Typs 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() {#ariaid-title7}

Gibt den Breitengradwert von zurück GlideGeoPoint Objekt.
{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 10. Parameter]

{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb} {#GlideGeoPoint-getLatitude__table_x24_fpt_qxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Breitengradwert von GlideGeoPoint Objekt. |
[Tabelle : 11. Rückgaben]

{#GlideGeoPoint-getLatitude__table_x24_fpt_qxb}  

    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() {#ariaid-title8}

Gibt den Längengradwert von zurück GlideGeoPoint Objekt.
{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 12. Parameter]

{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb} {#GlideGeoPoint-getLongitude__table_gmz_t4t_qxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Längengradwert von GlideGeoPoint Objekt. |
[Tabelle : 13. Rückgaben]

{#GlideGeoPoint-getLongitude__table_gmz_t4t_qxb}  

    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() {#ariaid-title9}

Gibt eine Zeichenfolge zurück, die den programmatischen Längen- und Breitengradwert des aktuellen Elements enthält GlideGeoPoint Objekt.
{#GlideGeoPoint-getValue__table_cvs_2zg_4xb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 14. Parameter]

{#GlideGeoPoint-getValue__table_cvs_2zg_4xb} {#GlideGeoPoint-getValue__table_dvs_2zg_4xb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Längen- und Breitengradwert der aktuellen Position GlideGeoPoint Objekt. |
[Tabelle : 15. Rückgaben]

{#GlideGeoPoint-getValue__table_dvs_2zg_4xb}  

     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(Zeichenfolgenlängengrad, Zeichenfolgenbreitengrad) {#ariaid-title10}

Legt die Längen- und Breitengradwerte des Geopunkts fest.
{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| longitude | Zeichenfolge | Die Längskoordinate des Geopunkts. |
| latitude | Zeichenfolge | Die Breitengradkoordinate des Geopunkts. |
[Tabelle : 16. Parameter]

{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb} {#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert für Längen- und Breitengrad, der auf festgelegt ist GlideGeoPoint Objekt. |
[Tabelle : 17. Rückgaben]

{#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb}  

    var gp = new GlideGeoPoint(); 
    gp.setValue("-28.48,38.91");      
    gs.info("geopoint: " + gp);

Ausgabe:

    geopoint: -28.480000,38.910000

## GlideGeoPoint -- setValue(Zeichenfolgenwert) {#ariaid-title11}

Legt die Längen- und Breitengradwerte des Geopunkts mithilfe eines einzelnen kommagetrennten Werts fest.
{#GlideGeoPoint-setValue_S__table_mng_gyc_wxb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Wert | Zeichenfolge | Ein kommagetrennter Wert, der Längen- und Breitengradpunkte enthält. |
[Tabelle : 18. Parameter]

{#GlideGeoPoint-setValue_S__table_mng_gyc_wxb} {#GlideGeoPoint-setValue_S__table_nng_gyc_wxb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert für Längen- und Breitengrad, der auf festgelegt ist GlideGeoPoint Objekt. |
[Tabelle : 19. Rückgaben]

{#GlideGeoPoint-setValue_S__table_nng_gyc_wxb}  
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


