---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideGeoPoint - 전역

# GlideGeoPoint - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 7분

GlideGeoPoint API를 사용하면 테이블에서 지리 포인트 데이터 유형 값을 가져오고 설정할 수 있습니다.

이 API는 기본적으로 사용할 수 있습니다. geopoint 데이터 유형을 사용하면 테이블 내의 단일 필드에 위도 및 경도 값을 저장할 수 있습니다. GlideGeoPoint API를 사용하면 새 GlideGeoPoint 객체를 인스턴스화하거나, 특정 테이블에 대한 새 지리 포인트를 생성하거나, 단일 위도, 경도 또는 지오타입 값을 검색할 수 있습니다. 지리 포인트를 사용하여 새 기록 삽입, 지리 포인트 위치 간의 거리 계산 또는 주변 지리 포인트 위치 쿼리와 같은 특정 사용 사례를 구현하는 방법에 대한 자세한 내용은 을 참조하십시오 [GlideGeoPoint 개발자 가이드](https://servicenow-prod.fluidtopics.net/5eC~pQU8c~Rn4HqqdHzGDQ#geopoint-dev-guide "GlideGeoPoint 개발자 안내서에는 위도와 경도 값(지오포인트) 사이의 거리를 계산하고, 지정된 지리포인트 및 반경 값 내에서 위치를 반환하고, 지원되는 GlideGeoPoint API 함수에서 제공하는 추가 기능을 사용하는 방법에 대한 정보가 포함되어 있습니다.").  
지오타입 데이터 유형의 주요 측면은 다음과 같습니다.

* 경도와 위도 값을 나타내는 한 쌍의 십진수로 구성됩니다.
* 경도 범위는 (-180, 180)입니다. 이 범위 밖의 값은 이 범위 내의 동등한 값으로 정규화됩니다.
* 위도 범위는 \[-90, 90\]입니다. 이 범위 밖의 값은 이 범위 내의 동등한 값으로 정규화됩니다.
* 지리 포인트 값은 항상 입력으로 허용되며 쉼표로 구분된 쌍으로 표시됩니다("경도,위도"). 표현식을 선택적으로 괄호로 둘러쌀 수 있습니다.
* 경도 및 위도 값은 모두 소수점 이하 6자리까지 고정 정밀도로 저장됩니다.  
주:  
GlideGeoPoint API 값은 항상 경도, 위도 순서로 나열됩니다.

이 페이지의 예시에서는 사용자 지정 테이블이 지리 포인트 필드 유형을 포함하는 필드로 미리 채워져 있다고 가정합니다. 이 데이터 유형에 대한 자세한 내용은 해당 문서를 [Function field](https://www.servicenow.com/docs/access?context=platform-support-functions&version=australia&pubname=australia-platform-administration&ft:locale=en-US)참조하십시오[Geo point field type](https://www.servicenow.com/docs/access?context=geo-point-field-type&version=australia&pubname=australia-platform-administration&ft:locale=en-US).

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

GlideGeoPoint 객체를 인스턴스화합니다. GlideGeoPoint 개체는 문자열로 저장되는 경도 및 위도 값에 의미 체계 인식을 추가합니다.
{#GlideGeoPoint-GlideGeoPoint__table_dhw_y13_mxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#GlideGeoPoint-GlideGeoPoint__table_dhw_y13_mxb}  
다음 예제에서는 새 GlideGeoPoint 개체를 null 값으로 초기화하는 방법을 보여 줍니다.

    var gp = new GlideGeoPoint();

## GlideGeoPoint - GlideGeoPoint(문자열 경도, 문자열 위도) {#ariaid-title3}

제공된 경도 및 위도 값에 따라 GlideGeoPoint 객체를 인스턴스화합니다.
{#GlideGeoPoint-GlideGeoPoint_S_S__table_jf5_zvc_wxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 경도 | 문자열 | 지리 지점의 경도 좌표입니다. |
| 위도 | 문자열 | 지리 지점의 위도 좌표입니다. |
[표 2. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 지오포인트 | 결과 GlideGeoPoint 객체입니다. |
[표 3. 반환]

{#GlideGeoPoint-GlideGeoPoint_S_S__table_kf5_zvc_wxb}  
다음 예제에서는 경도 및 위도 값을 제공하여 그에 따라 객체를 초기화하는 방법을 보여줍니다.

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

출력:

    geopoint: 10.123000,25.987000

## GlideGeoPoint - GlideGeoPoint(객체 geoPoint) {#ariaid-title4}

경도 및 위도 점 값을 복사하여 새 GlideGeoPoint 객체를 인스턴스화합니다.
{#GlideGeoPoint-GlideGeoPoint_O__table_egf_cxc_wxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 지오포인트 | 객체 | 복사하려는 지리 포인트 인스턴스입니다. |
[표 4. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 지오포인트 | 결과 GlideGeoPoint 객체입니다. |
[표 5. 반환]

{#GlideGeoPoint-GlideGeoPoint_O__table_fgf_cxc_wxb}  
다음 예제에서는 경도 및 위도 값을 복사하여 새 GlideGeoPoint 개체를 인스턴스화하는 방법을 보여 줍니다.

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

출력:

    geopoint: 135,-64

## GlideGeoPoint - getDisplayValue() {#ariaid-title5}

사용자 친화적 형식으로 현재 사용자의 지리 위치를 반환합니다.
getDisplayValue() 메서드는 단일 지리적 포인트 값을 반환합니다. 특정 테이블에서 모든 지리 포인트 값을 검색하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 [GlideGeoPoint 개발자 가이드](https://servicenow-prod.fluidtopics.net/5eC~pQU8c~Rn4HqqdHzGDQ#geopoint-dev-guide "GlideGeoPoint 개발자 안내서에는 위도와 경도 값(지오포인트) 사이의 거리를 계산하고, 지정된 지리포인트 및 반경 값 내에서 위치를 반환하고, 지원되는 GlideGeoPoint API 함수에서 제공하는 추가 기능을 사용하는 방법에 대한 정보가 포함되어 있습니다.").
{#GlideGeoPoint-getDisplayValue__table_rr1_24t_qxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 6. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | 객체에 설정된 경도 및 위도 좌표 값입니다. |
[표 7. 반환]

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

출력:

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

## GlideGeoPoint - getGeoPoint(문자열 geo_point_field_name) {#ariaid-title6}

지리적 지점 유형의 지정된 필드 이름에 대한 지리적 지점 좌표 값 목록을 반환합니다.
{#GlideGeoPoint-getGeoPoint_S__table_bz4_jsl_5bc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| geo_point_field_name | 문자열 | 지리적 지점 필드의 이름입니다. 주: 테이블에 정의된 딕셔너리 요소 아래에 있는 필드 이름을 찾아 지리적 지점 유형의 연결된 필드를 볼 수도 있습니다. 테이블: 딕셔너리 항목 \[sys_dictionary\] |
[표 8. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 객체 | 결과 GlideGeoPoint 객체. |
[표 9. 반환]

{#GlideGeoPoint-getGeoPoint_S__table_cz4_jsl_5bc}  
다음 예에서 "test_table"은 지리적 지점 유형의 "geo_point" 필드를 포함하는 테이블입니다. test_table에는 geo_point 열에 (-30.560000,-54.330000) 값으로 채워진 기록이 하나 있습니다. 이 예제 코드에서는 위도 및 경도 좌표를 반환하고 geo_point 열에 기록의 표시 값을 표시합니다.

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

출력:

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

## GlideGeoPoint - getLatitude() {#ariaid-title7}

GlideGeoPoint 객체의 위도 값을 반환합니다.
{#GlideGeoPoint-getLatitude__table_w24_fpt_qxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 10. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | GlideGeoPoint 개체의 위도 값입니다. |
[표 11. 반환]

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

출력:

    geopoint: 76.250000,49.750000 
    getLatitude(): 49.75

## GlideGeoPoint - getLongitude() {#ariaid-title8}

GlideGeoPoint 객체의 경도 값을 반환합니다.
{#GlideGeoPoint-getLongitude__table_fmz_t4t_qxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 12. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | GlideGeoPoint 개체의 경도 값입니다. |
[표 13. 반환]

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

출력:

    geopoint: 76.250000,49.750000 
     getLongitude(): 76.25

## GlideGeoPoint - getValue() {#ariaid-title9}

현재 GlideGeoPoint 개체의 프로그래밍 방식 경도 및 위도 값을 포함하는 문자열을 반환합니다.
{#GlideGeoPoint-getValue__table_cvs_2zg_4xb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 14. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | 현재 GlideGeoPoint 객체의 경도 및 위도 값입니다. |
[표 15. 반환]

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

출력:

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

## GlideGeoPoint - setValue(문자열 경도, 문자열 위도) {#ariaid-title10}

지리 지점의 경도 및 위도 값을 설정합니다.
{#GlideGeoPoint-setValue_S_S__table_gw3_4qg_4xb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 경도 | 문자열 | 지리포인트의 세로 좌표입니다. |
| 위도 | 문자열 | 지리 지점의 위도 좌표입니다. |
[표 16. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | GlideGeoPoint 개체에 설정된 경도 및 위도 값입니다. |
[표 17. 반환]

{#GlideGeoPoint-setValue_S_S__table_hw3_4qg_4xb}  

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

출력:

    geopoint: -28.480000,38.910000

## GlideGeoPoint - setValue(문자열 값) {#ariaid-title11}

쉼표로 구분된 단일 값을 사용하여 지리 지점의 경도 및 위도 값을 설정합니다.
{#GlideGeoPoint-setValue_S__table_mng_gyc_wxb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | 문자열 | 경도 및 위도 지점을 각각 포함하는 쉼표로 구분된 값입니다. |
[표 18. 매개변수]

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

| 유형 | 설명 |
|-|-|
| 문자열 | GlideGeoPoint 개체에 설정된 경도 및 위도 값입니다. |
[표 19. 반환]

{#GlideGeoPoint-setValue_S__table_nng_gyc_wxb}  
다음 예제에서는 단일 문자열을 사용하여 경도 및 위도 값을 설정하는 방법을 보여줍니다.

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

출력:

    geopoint: -23.400000,56.700000