• 디바이스의 GPS 센서에 의해 제공되는 geolocatino 객체에 접근하는 API

• Geolocation API의 플랫폼별 제약사항은 다음과 같다.

• altitudeAccuracy: 단말기에서 지원하지 않는다. 항상 null 이다.

• 안드로이드 2.x 버전의 가상기기에서는 enableHighAccuracy 을 ‘true’ 로 설정해야만 위치정보를 가져올 수 있다.

• timestamp: milliseconds 단위 대신에 seconds 단위를 쓴다

• frequency:  milliseconds 단위로 위치 정보를 감지하는 특정 시간 간격. W3C 스펙을 따르지 않고 있기 때문에 곧 삭제될 예정이다.

• app/res/xml/config.xml

<plugin name="Geolocation" value="org.apache.cordova.GeoBroker" />

• app/AndroidManifest

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />

• App/Supporting Files/Cordova.plist

<key>Plugins</key>
<dict>
    <key>Geolocation</key>
    <string>CDVLocation</string>
</dict>

• 단말기의 현재 위치를 Position 객체에 담아 구한다.

navigator.geolocation.getCurrentPosition(geolocationSuccess, 
                                         [geolocationError], 
                                         [geolocationOptions]);

• 단말기의 위치 변동을 감지한다.

var watchId = navigator.geolocation.watchPosition(geolocationSuccess,
                                                  [geolocationError],
                                                  [geolocationOptions]);

• watchID 파라미터를 통해 단말기의 위치 변동 감지를 중단시킬 수 있다

navigator.geolocation.clearWatch(watchID);

• 위치 정보를 성공적으로 가져왔을 경우, 수행하는 사용자 정의 함수

• Parameters :

• geolocation 관련 함수 수행 시, 에러가 발생했을 경우 수행하는 함수

• Parameters :

• 위치 정보를 구할 경우, 선택적으로 설정할 수 있는 옵션

• Options :

# frequency: milliseconds 단위로 특정 간격간에 위치 정보를 설정한다. W3C 스펙을 따르지 않고 있기 때문에, 앞으로 phoneGap에서 지원하지 않을 예정이다. (Number) (기본: 10000) # enableHighAccuracy: 어플리케이션이 가장 정확한 정보를 감지하도록 설정하는 옵션이다. (Boolean) # timeout: 위치 감지 요청의 제한시간이다.(geolocation.getCurrentPosition, geolocation.watchPosition 요청 후, geolocationSuccess이 호출될 때까지의 시간.) (Number) # maximumAge: milliseconds 단위로 위치 정보를 저장하고 있는 시간. (Number)

• geolocation API들을 통해 구해지는 위치 정보를 갖고 있는 객체

• 에러가 발생하였을 때, 에러 정보를 가지는 객체

• Constants :

PositionError.PERMISSION_DENIED: 권한 부족. PositionError.POSITION_UNAVAILABLE: 위치를 감지할 수 없음. PositionError.TIMEOUT: 감지 시간 초과.

• Position 객체의 coords 속성 객체이며, 위성 좌표의 정보를 가지고 있는 객체

• Phonegap : http://docs.phonegap.com/en/2.9.0/cordova_geolocation_geolocation.md.html#Geolocation