현재 지리적 위치 정보를 구한다.
| Parameters | Type | Description |
|---|---|---|
| strCallbackFunc | STRING | 콜백 함수 명 |
| bWatch | BOOL | [옵션]감지여부(기본값:false) |
| bEnableHighAccuracy | BOOL | [옵션]높은 정확도 사용여부(기본값:false) |
| nTimeout | long | [옵션]타임아웃시간(밀리초(ms))(기본값:Infinity - 무제한) |
| nMaximumAge | long | [옵션]n밀리초(ms)전 캐시에 저장된 위치정보 반환(기본값:0 - 캐시사용안함) |
| Type | Description |
|---|---|
| BOOL | 정상 적용 여부(true, false) |
위치 정보를 지원하지 않을 경우, false값이 리턴된다.
위치 정보가 지원되는 경우, true값이 리턴되고, 실제 위치 정보는 strCallback 파라미터에 해당하는 함수를 통해서 전달된다.
strCallback 파라미터는 지리적 정보를 얻은 경우에 호출되는 콜백 함수 이름을 지정한다.
strCallbackFunc 파라미터에 해당하는 함수 파라미터로 에러코드, 에러메시지, 위도(소숫점 포함), 경도(소숫점 포함), 정확도(단위:미터)값이 순차적으로 전달된다.
strCallbackFunc 파라미터에 해당하는 함수 파라미터로 에러코드가 0이 아닌 경우에는 에러가 발생한 경우이며, 위도/경도 값은 -1로 전달된다.
bWatch 파라미터가 true인 경우, 장치의 위치정보를 감지하여 위치가 변경되면 콜백 함수가 호출된다. 감지를 중단하려면 stopwatchgeolocation API를 호출해야 한다.
function geolocation_callback(errcode, errmsg, latitude, longitude, accuracy) {
factory.consoleprint('errcode : ' + errcode);
factory.consoleprint('errmsg : ' + errmsg);
factory.consoleprint('Latitude : ' + latitude);
factory.consoleprint('Longitude: ' + longitude);
factory.consoleprint('More or less ' + accuracy + ' meters.');
}
function btn_getgeolocation_on_mouseup(objInst)
{
// 위치정보 취득
screen.getgeolocation("geolocation_callback");
}
function btn_watchgeolocation_on_mouseup(objInst)
{
// 위치정보 감지 시작
screen.getgeolocation("geolocation_callback", true, true, 5000, 0);
}
function btn_stopwatchgeolocation_on_mouseup(objInst)
{
// 위치정보 감지 중단
screen.stopwatchgeolocation();
}