القائمة الرئيسية

الصفحات

 HTML5 - Geolocation


HTML5 Geolocation API lets you share your location with your favorite web sites. A JavaScript can capture your latitude and longitude and can be sent to backend web server and do fancy location-aware things like finding local businesses or showing your location on a map.

Today most of the browsers and mobile devices support Geolocation API. The geolocation APIs work with a new property of the global navigator object ie. Geolocation object which can be created as follows −

تتيح لك HTML5 Geolocation API مشاركة موقعك مع مواقع الويب المفضلة لديك. يمكن لـ JavaScript التقاط خطوط الطول والعرض الخاصة بك ويمكن إرسالها إلى خادم الويب الخلفي والقيام بأشياء رائعة تتعلق بالموقع مثل البحث عن الشركات المحلية أو إظهار موقعك على الخريطة. تدعم اليوم معظم المتصفحات والأجهزة المحمولة واجهة برمجة تطبيقات تحديد الموقع الجغرافي. تعمل واجهات برمجة التطبيقات لتحديد الموقع الجغرافي مع خاصية جديدة لكائن الملاح العالمي ، أي. كائن تحديد الموقع الجغرافي الذي يمكن إنشاؤه على النحو التالي -

var geolocation = navigator.geolocation;

The geolocation object is a service object that allows widgets to retrieve information about the geographic location of the device.

Geolocation Methods

The geolocation object provides the following methods −

Sr.No.Method & Description
1getCurrentPosition()

This method retrieves the current geographic location of the user.

2watchPosition()

This method retrieves periodic updates about the current geographic location of the device.

3clearWatch()

This method cancels an ongoing watchPosition call.

Example

Following is a sample code to use any of the above method −

function getLocation() {
   var geolocation = navigator.geolocation;
   geolocation.getCurrentPosition(showLocation, errorHandler);
}

Here showLocation and errorHandler are callback methods which would be used to get actual position as explained in next section and to handle errors if there is any.

Location Properties

Geolocation methods getCurrentPosition() and getPositionUsingMethodName() specify the callback method that retrieves the location information. These methods are called asynchronously with an object Position which stores the complete location information.

The Position object specifies the current geographic location of the device. The location is expressed as a set of geographic coordinates together with information about heading and speed.

The following table describes the properties of the Position object. For the optional properties if the system cannot provide a value, the value of the property is set to null.

تحدد طريقتا تحديد الموقع الجغرافي getCurrentPosition () و getPositionUsingMethodName () طريقة رد الاتصال التي تسترد معلومات الموقع. تسمى هذه الطرق بشكل غير متزامن مع موضع الكائن الذي يخزن معلومات الموقع الكاملة. يحدد كائن الموضع الموقع الجغرافي الحالي للجهاز. يتم التعبير عن الموقع كمجموعة من الإحداثيات الجغرافية مع معلومات حول العنوان والسرعة. يصف الجدول التالي خصائص كائن الموضع. بالنسبة للخصائص الاختيارية إذا لم يتمكن النظام من توفير قيمة ، يتم تعيين قيمة الخاصية إلى خالية.

PropertyTypeDescription
coordsobjectsSpecifies the geographic location of the device. The location is expressed as a set of geographic coordinates together with information about heading and speed.
coords.latitudeNumberSpecifies the latitude estimate in decimal degrees. The value range is [-90.00, +90.00].
coords.longitudeNumberSpecifies the longitude estimate in decimal degrees. The value range is [-180.00, +180.00].
coords.altitudeNumber[Optional] Specifies the altitude estimate in meters above the WGS 84 ellipsoid.
coords.accuracyNumber[Optional] Specifies the accuracy of the latitude and longitude estimates in meters.
coords.altitudeAccuracyNumber[Optional] Specifies the accuracy of the altitude estimate in meters.
coords.headingNumber[Optional] Specifies the device's current direction of movement in degrees counting clockwise relative to true north.
coords.speedNumber[Optional] Specifies the device's current ground speed in meters per second.
timestampdateSpecifies the time when the location information was retrieved and the Position object created.

Example

Following is a sample code which makes use of Position object. Here showLocation method is a callback method −

function showLocation( position ) {
   var latitude = position.coords.latitude;
   var longitude = position.coords.longitude;
   ...
}

Handling Errors

Geolocation is complicated, and it is very much required to catch any error and handle it gracefully.

The geolocations methods getCurrentPosition() and watchPosition() make use of an error handler callback method which gives PositionError object. This object has following two properties −

يعد تحديد الموقع الجغرافي معقدًا ، وهو مطلوب جدًا للقبض على أي خطأ والتعامل معه بأمان. تستخدم أساليب تحديد الموقع الجغرافي getCurrentPosition () و watchPosition () طريقة رد نداء معالج الأخطاء التي تعطي كائن PositionError. هذا الكائن يتبع خاصيتين -

PropertyTypeDescription
codeNumberContains a numeric code for the error.
messageStringContains a human-readable description of the error.

The following table describes the possible error codes returned in the PositionError object.

CodeConstantDescription
0UNKNOWN_ERRORThe method failed to retrieve the location of the device due to an unknown error.
1PERMISSION_DENIEDThe method failed to retrieve the location of the device because the application does not have permission to use the Location Service.
2POSITION_UNAVAILABLEThe location of the device could not be determined.
3TIMEOUTThe method was unable to retrieve the location information within the specified maximum timeout interval.

Example

Following is a sample code which makes use of PositionError object. Here errorHandler method is a callback method −

function errorHandler( err ) {
   
   if (err.code == 1) {
      
      // access is denied
   }
   ...
}

Position Options

Following is the actual syntax of getCurrentPosition() method −

getCurrentPosition(callback, ErrorCallback, options)

Here third argument is the PositionOptions object which specifies a set of options for retrieving the geographic location of the device.

Following are the options which can be specified as third argument −

هنا الوسيطة الثالثة هي PositionOptions الكائن الذي يحدد مجموعة من الخيارات لاسترداد الموقع الجغرافي للجهاز. فيما يلي الخيارات التي يمكن تحديدها كوسيطة ثالثة -

PropertyTypeDescription
enableHighAccuracyBooleanSpecifies whether the widget wants to receive the most accurate location estimate possible. By default this is false.
timeoutNumberThe timeout property is the number of milliseconds your web application is willing to wait for a position.
maximumAgeNumberSpecifies the expiry time in milliseconds for cached location information.

Example

Following is a sample code which shows how to use above mentioned methods −

function getLocation() {
   var geolocation = navigator.geolocation;
   geolocation.getCurrentPosition(showLocation, errorHandler, {maximumAge: 75000});
}
هل اعجبك الموضوع :

تعليقات