GlideGeoPoint - 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기7분

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

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

    지리 유형 데이터 유형의 주요 측면은 다음과 같습니다.
    • 경도 및 위도 값을 나타내는 한 쌍의 10진수로 구성됩니다.
    • 경도 범위는 (-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(객체 지오포인트)

    경도 및 위도 점 값을 복사하여 새 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에는 값이 (-30.560000,-54.330000)인 geo_point 열에 채워진 하나의 기록이 있습니다. 예제 코드는 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