GlideGeoPoint - 전역

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

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

geotype 데이터 유형의 주요 측면은 다음과 같습니다.

• 경도 및 위도 값을 나타내는 한 쌍의 십진수로 구성됩니다.
• 경도 범위는 (-180, 180)입니다. 이 범위를 벗어나는 모든 값은 이 범위 내의 해당 값으로 정규화됩니다.
• 위도 범위는 [-90, 90]입니다. 이 범위를 벗어나는 모든 값은 이 범위 내의 해당 값으로 정규화됩니다.
• 지오포인트 값은 항상 입력으로 허용되며 쉼표로 구분된 쌍인 "경도,위도"로 표시됩니다. 괄호는 선택적으로 표현식을 둘러쌀 수 있습니다.
• 경도 및 위도 값은 모두 소수점 이하 6자리까지 정밀도로 저장됩니다.

주:

글라이드지오포인트 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 - getLatitude()

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

표 8. 매개변수

이름	유형	설명
없음

표 9. 반환

유형	설명
문자열	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 개체의 경도 값을 반환합니다.

표 10. 매개변수

이름	유형	설명
없음

표 11. 반환

유형	설명
문자열	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 개체의 프로그래밍 방식의 경도 및 위도 값이 들어 있는 문자열을 반환합니다.

표 12. 매개변수

이름	유형	설명
없음

표 13. 반환

유형	설명
문자열	현재 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(문자열 경도, 문자열 위도)

지오포인트의 경도 및 위도 값을 설정합니다.

표 14. 매개변수

이름	유형	설명
경도	문자열	지오포인트의 세로 좌표입니다.
위도	문자열	지오포인트의 위도 좌표입니다.

표 15. 반환

유형	설명
문자열	GlideGeoPoint 개체에 설정된 경도 및 위도 값입니다.

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

출력:

geopoint: -28.480000,38.910000

GlideGeoPoint - setValue(문자열 값)

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

표 16. 매개변수

이름	유형	설명
값	문자열	각각 경도 및 위도 지점을 포함하는 쉼표로 구분된 값입니다.

표 17. 반환

유형	설명
문자열	GlideGeoPoint 개체에 설정된 경도 및 위도 값입니다.

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

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

출력:

geopoint: -23.400000,56.700000