geolocation
getCurrentPosition
현재 위치정보를 읽어온다.
위치정보는 successCallback에 Position객체로 넘어온다.
successCallback
| 필드 | 필드 | 필드 | 설명 |
| result | 위치 상세 정보 | ||
| coords | latitude | 위도 | |
| longitude | 경도 | ||
| altitude | 높이 | ||
| accuracy | 위경도의 정확도(meter법) | ||
| altitudeAccuracy | 높이의 정확도(meter법) | ||
| timestamp | 정보를 수집한 시간 | ||
errorCallback
| 필드 | 설명 |
|---|---|
| code | 에러코드 |
| message | 에러메세지 |
Example
hone.channel.execute('geolocation', 'getCurrentPosition', [],
function (result) {
alert("위도:" + result.coords.latitude + ", 경도: " + result.coords.longitude);
}, function (e) {
alert(JSON.stringify(e));
}
);
function (result) {
alert("위도:" + result.coords.latitude + ", 경도: " + result.coords.longitude);
}, function (e) {
alert(JSON.stringify(e));
}
);
Result
{
"coords": {
"accuracy": 18.698999404907227,
"altitude": 0.0,
"altitudeAccuracy": 18.698999404907227,
"latitude": 37.5240917,
"longitude": 126.9229084
},
"timestamps": 1485932041423
}
"coords": {
"accuracy": 18.698999404907227,
"altitude": 0.0,
"altitudeAccuracy": 18.698999404907227,
"latitude": 37.5240917,
"longitude": 126.9229084
},
"timestamps": 1485932041423
}
watchPosition
현재 위치정보를 주기적으로 읽어온다.
options
| 필드 | 설명 | 비고 | M/O |
|---|---|---|---|
| interval | 정보 갱신 시간(ms) | M | |
| watchId | watch Id | 임의의 문자열 | M |
successCallback {JSON Object}
| 필드 | 필드 | 필드 | 설명 |
|---|---|---|---|
| result | 위치 상세 정보 | ||
| coords | latitude | 위도 | |
| longitude | 경도 | ||
| altitude | 높이 | ||
| accuracy | 위경도의 정확도(meter법) | ||
| altitudeAccuracy | 높이의 정확도(meter법) | ||
| timestamp | 정보를 수집한 시간 | ||
errorCallback
| 필드 | 설명 |
|---|---|
| code | 에러코드 |
| message | 에러메세지 |
Example
var interval = 3000;
var watchId = "1000";
hone.channel.execute('geolocation', 'watchPosition', [interval, watchId],
function (result) {
alert("위도:" + result.coords.latitude + ", 경도: " + result.coords.longitude);
}, function (e) {
alert(JSON.stringify(e));
}
);
var watchId = "1000";
hone.channel.execute('geolocation', 'watchPosition', [interval, watchId],
function (result) {
alert("위도:" + result.coords.latitude + ", 경도: " + result.coords.longitude);
}, function (e) {
alert(JSON.stringify(e));
}
);
Result
{
"coords": {
"accuracy": 19.264999389648438,
"altitude": 0.0,
"altitudeAccuracy": 19.264999389648438,
"latitude": 37.5240403,
"longitude": 126.9229504
},
"timestamps": 1485932593408
}
"coords": {
"accuracy": 19.264999389648438,
"altitude": 0.0,
"altitudeAccuracy": 19.264999389648438,
"latitude": 37.5240403,
"longitude": 126.9229504
},
"timestamps": 1485932593408
}
clearWatch
동작중인 watch를 종료한다.
options
| 필드 | 설명 | M/O |
|---|---|---|
| watchId | 동작중인 watchId watchPosition 에서 생성한 watchId 사용 | M |
successCallback
| 필드 | 설명 |
|---|---|
| 없음 | 없음 |
errorCallback
| 필드 | 설명 |
|---|---|
| code | 에러코드 |
| message | 에러메세지 |
Example
hone.channel.execute('geolocation', 'clearWatch', [watchId],
function() {
alert('success');
}, function(e) {
alert(JSON.stringify(e));
}
);
function() {
alert('success');
}, function(e) {
alert(JSON.stringify(e));
}
);
Error Code
| Code | Cause | Comment |
|---|---|---|
| E10500 | 파라메터 값이 잘못되어 있을 경우 | |
| E10501 | 전달된 액션 값이 알 수 없는 액션일 경우 | |
| E10502 | 정보 갱신 시간 정보가 잘못되어 있을 경우 | |
| E10503 | watch 아이디 값이 null 이거나 빈 값인 경우 | |
| E10550 | 실행 중 오류가 발생 되었을 경우 | |
| E10551 | watchPosition 요청 시 watch 아이디 값이 존재하는 경우 | |
| E10552 | clearWatch 요청 시 watch 아이디 값을 찾을 수 없는 경우 | |
| E10553 | 위치 정보을 얻기위한 서비스가 지원하지 않는 경우 | |
| E10599 | 알 수없는 오류가 발생 되었을 경우 | |