시간 제한 기간 지정

지리적 위치 API에서 위치를 확인할 수 있는 시간을 제한하기 위해 개발자는 getCurrentPosition 또는 watchPosition에 전달되는 선택적 options 매개 변수를 사용할 수 있습니다.timeout 특성은 getCurrentPosition 또는 watchPosition 호출에서 해당 성공 콜백이 호출될 때까지 경과할 수 있는 최대 시간(밀리초)을 나타냅니다.

다음 코드 행은 1분의 시간 제한을 지정하기 위해 options 매개 변수에서 timeout 특성을 60000이라고 지정하는 getCurrentPosition 호출을 보여줍니다.

    navigator.geolocation.getCurrentPosition(successCallback,
                                             errorCallback,
                                             {timeout:60000});

Windows Internet Explorer에서 지정된 시간 제한 내에 새 Position 개체를 가져올 수 없으며 이 간격 동안 다른 오류가 발생하지 않은 경우에는 code 특성이 TIMEOUT으로 설정된 PositionError 개체를 사용하여 해당 오류 콜백이 호출됩니다. 사용자 승인을 받는 데 걸린 시간은 timeout 특성의 기간에 포함되지 않습니다. timeout 특성은 위치 인식 작업에만 적용됩니다.

getCurrentPosition 또는 watchPosition에 대한 options 매개 변수가 생략된 경우 timeout 특성에 사용되는 기본값은 Infinity입니다. 음수 값을 지정하면 시간 제한 값이 0으로 간주됩니다.

getCurrentPosition 호출이 시간 초과될 경우 오류 콜백이 한 번만 호출됩니다. watchPosition의 경우 오류 콜백이 반복적으로 호출될 수 있습니다. 첫 번째 시간 제한은 필요한 경우 watchPosition이 호출된 순간이나 사용자의 허가를 받은 순간에 상대적입니다. 이후 시간 제한은 구현에서 호스팅 장치의 위치가 변경되었으며 새 Position 개체를 가져와야 한다고 확인된 시간을 기준으로 합니다.

참고  options 매개 변수에 지정된 옵션 지원은 Windows Internet Explorer 9을 실행하는 컴퓨터나 장치에서 사용하는 위치 공급자에 따라 달라집니다. 지정한 옵션이 위치 공급자에서 반환되는 결과에 영향을 줄 것이라는 보장은 없습니다. 예를 들어 위치 공급자에 반환할 데이터가 이미 준비되어 있는 경우 timeout을 0으로 설정해도 실제로 오류가 발생하지 않을 수 있습니다.

관련 항목

현재 위치 가져오기
오류 처리
위치 인식 웹 페이지를 만드는 방법
위치 변경 감시

 

 

표시:
© 2014 Microsoft