COORDINATES
PhoneGap Geolocation API sử dụng 3 đối tượng chỉ đọc chứa các thông tin geolocation : Position
PositionError Coordinates
Mỗi đối tượng trong các đối tượng trên được tạo ra và tính tốn khi ta sử dụng các phương thức khác nhau, và dữ liệu được trả về giống như 1 phần của các hàm gọi lại callback
4.4.1.Đối tượng Position Object
Đối tượng Position Object chứa các tọa độ được tạo ra bởi geolocation API và nó gồm 2 thuộc tinh sau :
Coords – đây là 1 tập các tọa độ địa lý (như kinh độ, vĩ độ, độ cao,..) Timestamp – thời điểm được tạo tính bằng mili giây
Ví dụ gọi hàm geolocation.getCurrentPosition() như ở ví dụ dưới thì kết quả trả về gồm có kinh độ, vĩ độ, độ cao, độ chính xác, độ chính xác độ cao, tiêu đề, tấc độ, và timestamp, được truyền vào hàm onSuccess :
var onSuccess = function(position) {
alert(„Latitude: „ + position.coords.latitude + „\n‟ + „Longitude: „ + position.coords.longitude + „\n‟ + „Altitude: „ + position.coords.altitude + „\n‟ + „Accuracy: „ + position.coords.accuracy + „\n‟ +
„Altitude Accuracy: „ + position.coords.altitudeAccuracy + „\n‟ + „Heading: „ + position.coords.heading + „\n‟ +
„Speed: „ + position.coords.speed + „\n‟ +
„Timestamp: „ + new Date(position.timestamp) + „\n‟);
}
function onError(error) {
alert(„code: „ + error.code + „\n‟ + „message: „ + error.message + „\n‟); }
Ngô Quang Trung – email: ngotrung.poli.t@gmail.com / www.phonegap.vn/forum 46
navigator.geolocation.getCurrentPosition(onSuccess, onError);
4.4.2.Đối tượng PositionError
như ta nhìn thấy trong ví dụ trước thì ta cũng có khả năng truy cập vào 1 hàm onError callback.hàm này trả về 2 thuộc tính của vấn đề là error code và error message
error code sẽ là 1 trong những lỗi đã được định nghĩa trước như sau :
PositionError.PERMISSION_DENIED PositionError.POSITION_UNAVAILABLE PositionError.TIMEOUT
Và error message sẽ được miêu tả chi tiết lỗi gặp phải
4.4.3.Đối tượng Coordinates Object
Đối tượng Coordinates Object bao gồm 1 tập các thuộc tính chỉ đọc.ta đã gặp chúng trong ví dụ trước như là 1 phần của đối tượng Position object.trong thực tế, thì dữ liệu
Coordinates được đính thêm vào đối tượng Position object và sau đó được trả về thơng qua hàm onSuccess
Các thuộc tính của đối tượng Coordinates object: Vĩ độ latitude – là kiểm số thực
Kinh độ longitude - là kiểm số thực
Dộ cao altitude – độ cao tính bằng m so với mực nước biển
Dộ chính xác accuracy – là độ chính xác của việc đọc vĩ độ/kinh độ Dộ chính xác altitudeAccuracy – là độ chính xác của độ cao
Tiêu đề heading – là hướng di chuyển Tấc độ speed – là tấc độ so với mặt đất (m/s)