개발 가이드

Local Navigation

웹 페이지를 사용하여 GPS 위치 검색

JavaScript를 사용하여 GPS 모드를 구성할 수 있으며, BlackBerry Browser를 사용하여 BlackBerry 단말기의 현재 위치를 확인할 수 있습니다.

다음 JavaScript 속성 및 메소드를 사용하여 BlackBerry Browser에서 위치 API에 액세스할 수 있습니다.

JavaScript 속성

설명

blackberry.location.GPSSupported

BlackBerry 단말기에 의해 GPS가 지원될 때 이 속성은 true를 반환합니다.

blackberry.location.latitude

이 속성은 BlackBerry 단말기의 현재 위도를 각도로 반환합니다. 양수 값은 북위, 음수 값은 남위를 나타냅니다.

blackberry.location.longitude

이 속성은 BlackBerry 단말기의 현재 경도를 각도로 반환합니다. 양수 값은 동경, 음수 값은 서경을 나타냅니다.

blackberry.location.timestamp

이 속성은 blackberry.location 객체가 업데이트된 시간(Epoch 이후 경과된 밀리초)을 반환합니다.

JavaScript 메소드

설명

blackberry.location.setAidMode(mode)

이 메소드는 BlackBerry 단말기가 GPS 위치를 확인하는 데 사용될 GPS 모드를 지정합니다. 모드는 다음 값 중 하나일 수 있습니다.

  • 0: 셀 사이트 모드
  • 1: 보조 모드
  • 2: 자치 모드

blackberry.location.refreshLocation()

이 메소드는 BlackBerry 단말기의 위치 업데이트를 요청합니다. 이 메소드는 비동기적이며 스크립트는 업데이트된 위치 정보의 수신 여부에 관계없이 계속됩니다. 위치 정보를 읽기 전에 업데이트되도록 하려면 먼저 blackberry.location.latitudeblackberry.location.longitude를 읽는 blackberry.location.onLocationUpdate()를 사용하는 수신기를 등록한 후에 refreshLocation()을 호출해야 합니다.

blackberry.location.onLocationUpdate("callback")

이 메소드는 업데이트된 위치 정보가 BlackBerry 단말기에 수신될 때마다 문자열을 평가하는 수신기를 등록하거나 함수를 호출합니다.

BlackBerry Device Software 버전 4.6 이하를 실행하는 BlackBerry 단말기에서 이 함수는 문자열로 전달되어야 하며, 이는 위치가 새로 고쳐질 때마다 평가됩니다. BlackBerry Device Software 버전 4.6 이상을 실행하는 BlackBerry 단말기에서는 문자열을 전달하거나 메소드를 사용하여 콜백 기능을 등록합니다.

onlocationUpdate()가 호출되고 나면 위치 정보가 업데이트될 때마다 콜백이 발생합니다.

빈도는 몇 초 간격이 될 수 있습니다. 메소드에 함수를 전달한 경우 blackberry.location.removeLocationUpdate()를 사용하여 콜백을 취소할 수 있습니다. 문자열을 전달한 경우 콜백은 제거할 수 없습니다.

blackberry.location.removeLocationUpdate()

이 메소드는 이전에 등록된 콜백 기능을 제거합니다. 이 메소드는 BlackBerry Device Software 버전 4.6 이상을 실행하는 BlackBerry 단말기에서만 지원됩니다.


이 정보가 도움이 되었습니까? 의견을 보내 주십시오.