getCurrentPosition() - 현재 위치 얻기, getCurrentPosition() 형식, getCurrentPosition()의 옵션 형식, position.coords의 속성 정보, 에러코드

  

getCurrentPosition() - 현재 위치 얻기

·       사용자의 현재 기기의 위치를 position오브젝트 형으로 변환해 주는 함수입니다.

·       현재 위치 정보를 비동기로 확인한 다음 처리 결과를 인수로 하여 successCallback을 한 번만 호출합니다.

·       에러가 발생했을 때는 상세한 에러 정보를 인수로 하여 errorCallback을 호출합니다.

·       위치 정보를 얻었을 때 실행되는 함수의 첫번째 매개변수에는 이벤트 객체가 자동으로 할당되고 이벤트 객체로 부터 위치 정보를 나타내는 다양한 값을 얻을 수 있다.

 

 

getCurrentPosition() 형식

window.navigator.geolocation.getCurrentPosition( successCallback,  //위치 정보를 얻었을 때 실행되는 함수 errorCallback, //위치 정보를 얻지 못 했을 때 실행되는 함수 options //위치 정보에 대한 각종 매개 변수를 포함하는 자바스크립트 객체 지정 );

 

 

 

getCurrentPosition()의 옵션 형식

getCurrentPosition(successCallback, errorCallback, options)

 

옵션(options) 값	설명
frequency	위치정보를 가져올 시간 간격으로 단위는 밀리세컨드(ms), 기본값 10000
enableHighAccuracy	위치정보의 정확성을 최상으로 할지 여부 지정
timeout	기기로부터 위치 정보를 가져올 때까지의 최대 대기 시간 단위는 밀리세컨드(ms)
maximumAge	위치 정보를 캐싱하는 기간을 지정, 단위는 밀리세컨드(ms)

 

 

position.coords의 속성 정보

position.coords를 통해 아래의 속성 정보를 확인 할수 있습니다.

속성	설명
latitude	위도
longitude	경도
altitude	고도
accuracy	위도와 경도의 정확도
altitudeAccuracy	고도의 정확도
heading	방향(북쪽으로부터 시계방향으로 현재 방향까지의 각도)
speed	현재 기기의 속도를 meter per second

 

 

 

에러코드

에러코드	설명
0	알 수 없는 오류
1	권한 거부
2	위치 추적 실패
3	시간 초과