GlideGeoPoint - 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 7분

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

    이 API는 기본적으로 사용할 수 있습니다. geopoint 데이터 유형을 사용하면 테이블 내의 단일 필드에 위도 및 경도 값을 저장할 수 있습니다. GlideGeoPoint API를 사용하면 새 GlideGeoPoint 객체를 인스턴스화하거나, 특정 테이블에 대한 새 지리 포인트를 생성하거나, 단일 위도, 경도 또는 지오타입 값을 검색할 수 있습니다. 지리 포인트를 사용하여 새 기록 삽입, 지리 포인트 위치 간의 거리 계산 또는 주변 지리 포인트 위치 쿼리와 같은 특정 사용 사례를 구현하는 방법에 대한 자세한 내용은 을 참조하십시오 GlideGeoPoint 개발자 가이드.

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

    이 페이지의 예시에서는 사용자 지정 테이블이 지리 포인트 필드 유형을 포함하는 필드로 미리 채워져 있다고 가정합니다. 이 데이터 유형에 대한 자세한 내용은 해당 문서를 Function field참조하십시오Geo point field type.

    GlideGeoPoint - GlideGeoPoint()

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

    표 1. 매개변수
    이름 유형 설명
    없음

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

    var gp = new GlideGeoPoint();

    GlideGeoPoint - GlideGeoPoint(문자열 경도, 문자열 위도)

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

    표 2. 매개변수
    이름 유형 설명
    경도 문자열 지리 지점의 경도 좌표입니다.
    위도 문자열 지리 지점의 위도 좌표입니다.
    표 3. 반환
    유형 설명
    지오포인트 결과 GlideGeoPoint 객체입니다.

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

    // 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)

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

    표 4. 매개변수
    이름 유형 설명
    지오포인트 객체 복사하려는 지리 포인트 인스턴스입니다.
    표 5. 반환
    유형 설명
    지오포인트 결과 GlideGeoPoint 객체입니다.

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

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

    GlideGeoPoint - getDisplayValue()

    사용자 친화적 형식으로 현재 사용자의 지리 위치를 반환합니다.

    getDisplayValue() 메서드는 단일 지리적 포인트 값을 반환합니다. 특정 테이블에서 모든 지리 포인트 값을 검색하는 방법에 대한 자세한 내용은 다음 문서를 참조하십시오 GlideGeoPoint 개발자 가이드.

    표 6. 매개변수
    이름 유형 설명
    안 함
    표 7. 반환
    유형 설명
    문자열 객체에 설정된 경도 및 위도 좌표 값입니다. 
    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)

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

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

    테이블: 딕셔너리 항목 [sys_dictionary]
    표 9. 반환
    유형 설명
    객체 결과 GlideGeoPoint 객체.

    다음 예에서 "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()

    GlideGeoPoint 객체의 위도 값을 반환합니다.

    표 10. 매개변수
    이름 유형 설명
    안 함
    표 11. 반환
    유형 설명
    문자열 GlideGeoPoint 개체의 위도 값입니다. 
    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()

    GlideGeoPoint 객체의 경도 값을 반환합니다.

    표 12. 매개변수
    이름 유형 설명
    안 함
    표 13. 반환
    유형 설명
    문자열 GlideGeoPoint 개체의 경도 값입니다. 
    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()

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

    표 14. 매개변수
    이름 유형 설명
    안 함
    표 15. 반환
    유형 설명
    문자열 현재 GlideGeoPoint 객체의 경도 및 위도 값입니다. 
     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(문자열 경도, 문자열 위도)

    지리 지점의 경도 및 위도 값을 설정합니다.

    표 16. 매개변수
    이름 유형 설명
    경도 문자열 지리포인트의 세로 좌표입니다.
    위도 문자열 지리 지점의 위도 좌표입니다.
    표 17. 반환
    유형 설명
    문자열 GlideGeoPoint 개체에 설정된 경도 및 위도 값입니다. 
    var gp = new GlideGeoPoint(); 
gp.setValue("-28.48,38.91");      
gs.info("geopoint: " + gp);

    출력:

    geopoint: -28.480000,38.910000

    GlideGeoPoint - setValue(문자열 값)

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

    표 18. 매개변수
    이름 유형 설명
    값 문자열 경도 및 위도 지점을 각각 포함하는 쉼표로 구분된 값입니다.
    표 19. 반환
    유형 설명
    문자열 GlideGeoPoint 개체에 설정된 경도 및 위도 값입니다.

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

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

    출력:

    geopoint: -23.400000,56.700000