يتم استخدام API HTML تحديد الموقع الجغرافي لتحديد موقف المستخدم.
ما هو W3C تحديد الموقع الجغرافي API؟
وAPI W3C تحديد الموقع الجغرافي هو محاولة من قبل على نطاق واسع اتحاد شبكة ويب العالمية (W3C) لتوحيد واجهة لاسترداد معلومات الموقع الجغرافي لجهاز العميل.
وتحدد مجموعة من الكائنات، متوافقة ECMAScript القياسية، أن تنفيذ في تطبيق العميل إعطاء موقع الجهاز العميل من خلال الاستشارات من خوادم معلومات الموقع، والتي تتسم بالشفافية للواجهة برمجة التطبيقات (API).
المصادر الأكثر شيوعا معلومات الموقع هي عنوان IP، واي فاي وبلوتوث عنوان MAC، وتحديد الترددات الراديوية (RFID)، واي فاي موقع اتصال، أو نظام تحديد المواقع العالمي (GPS) جهاز ومعرفات خلية GSM / CDMA.
يتم إرجاع الموقع مع دقة معينة تبعا لأفضل مصدر معلومات الموقع متاح.
نشر في متصفحات الويب
يمكن صفحات الويب استخدام API تحديد الموقع الجغرافي مباشرة إذا كان متصفح الويب بتنفيذ ذلك. تاريخيا، يمكن أن بعض المتصفحات كسب التأييد عبر البرنامج المساعد جوجل التروس، ولكن هذا كان أوقف في عام 2010 وAPI من جانب الخادم أنها تعتمد توقف عن الاستجابة في عام 2012.
هي مناسبة للAPI تحديد الموقع الجغرافي بشكل مثالي لتطبيقات الويب للهواتف النقالة مثل المساعدين الرقمية الشخصية (PDA) والهواتف الذكية. على أجهزة الكمبيوتر المكتبية، وAPI W3C تحديد الموقع الجغرافي يعمل في فايرفوكس منذ الإصدار 3.5، جوجل كروم، أوبرا 10.6، وإنترنت إكسبلورر 9.0، وسفاري 5. على الأجهزة النقالة، وأنها تعمل على الروبوت (الثابتة 2.0+)، دائرة الرقابة الداخلية، هاتف ويندوز ومايمو.
يتم اعتماد API W3C تحديد الموقع الجغرافي أيضا أوبرا موبايل 10.1 - متاح لالروبوت وسيمبيان الأجهزة (أجيال S60 3 و 5) منذ 24 نوفمبر 2010.
قدمت جوجل التروس دعم الموقع الجغرافي لمتصفحات قديمة وغير متوافقة، بما في انترنت اكسبلورر 7.0+ بمثابة المساعد تيبترونيك، وجوجل كروم الذي ينفذ التروس أصلا. وأيد أيضا تحديد الموقع الجغرافي لأجهزة الجوال البرنامج المساعد للمتصفح الروبوت (قبل الإصدار 2.0) وأوبرا موبايل ويندوز موبايل.
ومع ذلك، فإن API جوجل التروس تحديد الموقع الجغرافي غير متوافق مع API W3C تحديد الموقع الجغرافي ولم يعد معتمدا.
الميزات
ونتيجة لW3C تحديد الموقع الجغرافي API عادة ما تعطي 4 خصائص الموقع، بما في ذلك خطوط الطول والعرض (إحداثيات) والارتفاع (ارتفاع)، و [دقة الموقف تجمعوا]، التي تعتمد كلها على مصادر الموقع.
في بعض الاستفسارات والارتفاع قد تسفر عن أو العودة لا قيمة له.
تحديد الوظيفة المستخدم
يتم استخدام API HTML تحديد الموقع الجغرافي للحصول على الموقع الجغرافي للمستخدم.
لأن هذا يمكن أن تمس خصوصية، والموقف غير متوفر إلا يوافق المستخدم ذلك.
دعم المتصفح
الأرقام في الجدول تحدد أول نسخة متصفح يدعم بالكامل تحديد الموقع الجغرافي.
| API | |||||
|---|---|---|---|---|---|
| Geolocation | 5.0 | تسعة | 3.5 | 5.0 | 16.0 |
Note: الموقع الجغرافي هو أكثر دقة للأجهزة مع نظام تحديد المواقع، مثل iPhone .
عن طريق تحديد الموقع الجغرافي HTML
و getCurrentPosition() يستخدم طريقة للحصول على موقف المستخدم.
على سبيل المثال بإرجاع تحت خطوط الطول والعرض من موقف للمستخدم:
مثال
<script>
var x = document.getElementById("demo");
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition);
} else {
x.innerHTML = "Geolocation is not supported by this browser.";
}
}
function showPosition(position) {
x.innerHTML = "Latitude: " + position.coords.latitude +
"<br>Longitude: " + position.coords.longitude;
}
</script> انها محاولة لنفسك » وأوضح سبيل المثال:
- تحقق إذا كانت مدعومة تحديد الموقع الجغرافي
- إذا كان معتمدا، تشغيل getCurrentPosition() الأسلوب. إذا لم يكن كذلك، عرض رسالة إلى المستخدم
- إذا كان getCurrentPosition() الطريقة ناجحة، فإنها ترجع كائن إحداثيات لوظيفة المعين في المعلمة (showPosition)
- و showPosition() وظيفة إخراج خط العرض وخط الطول
المثال أعلاه هو السيناريو تحديد الموقع الجغرافي أساسي جدا، مع عدم وجود معالجة الأخطاء.
التعامل مع الأخطاء والرفض
المعلمة الثانية من getCurrentPosition() يستخدم طريقة لمعالجة الأخطاء. وهي تحدد وظيفة لتشغيل إذا فشلت في الحصول على موقع المستخدم:
مثال
function showError(error) {
switch(error.code) {
case error.PERMISSION_DENIED:
x.innerHTML = "User denied the request for Geolocation."
break;
case error.POSITION_UNAVAILABLE:
x.innerHTML = "Location information is unavailable."
break;
case error.TIMEOUT:
x.innerHTML = "The request to get user location timed out."
break;
case error.UNKNOWN_ERROR:
x.innerHTML = "An unknown error occurred."
break;
}
} انها محاولة لنفسك » عرض النتيجة في خريطة
لعرض النتيجة في خريطة، تحتاج إلى الوصول إلى خدمة الخريطة، مثل خرائط جوجل.
في المثال التالي، يتم استخدام خطوط الطول والعرض عاد لإظهار الموقع في خريطة جوجل (using a static image) :
مثال
function showPosition(position) {
var latlon = position.coords.latitude + "," + position.coords.longitude;
var img_url = "http://maps.googleapis.com/maps/api/staticmap?center=
"+latlon+"&zoom=14&size=400x300&sensor=false";
document.getElementById("mapholder").innerHTML = "<img src='"+img_url+"'>";
} انها محاولة لنفسك » خريطة سيناريو جوجل
كيفية إظهار خريطة جوجل التفاعلية مع علامة، والتكبير وخيارات السحب.
في موقع محدد المعلومات
وأظهرت هذه الصفحة كيفية إظهار موقف المستخدم على الخريطة.
تحديد الموقع الجغرافي هو أيضا مفيد جدا للمعلومات محددة عن الموقع، مثل:
- ما يصل إلى أحدث المعلومات المحلية
- عرض نقاط من الفائدة بالقرب من المستخدم
- بدوره عن طريق بدوره الملاحة (GPS)
و getCurrentPosition() الطريقة - إرجاع البيانات
و getCurrentPosition() الأسلوب بإرجاع كائن إذا كان ناجحا. يتم إرجاع خصائص الطول والعرض ودقة دائما. يتم إرجاع الخصائص الأخرى إن وجدت:
| خاصية | عائدات |
|---|---|
| coords.latitude | خط العرض كرقم عشري |
| coords.longitude | خط الطول كرقم عشري |
| coords.accuracy | دقة الموقف |
| coords.altitude | الارتفاع في متر فوق مستوى سطح البحر المتوسط |
| coords.altitudeAccuracy | دقة ارتفاع موقف |
| coords.heading | العنوان كما درجة باتجاه عقارب الساعة من شمال |
| coords.speed | السرعة في متر في الثانية |
| timestamp | التاريخ / الوقت للاستجابة |
الكائن تحديد الموقع الجغرافي - طرق أخرى مثيرة للاهتمام
watchPosition() - إرجاع الوضع الحالي للمستخدم ويستمر في العودة موقف المحدث كما ينتقل المستخدم (like the GPS in a car) .
clearWatch() - توقف في watchPosition() الأسلوب.
يظهر المثال التالي watchPosition() الأسلوب. تحتاج إلى جهاز GPS دقيقة لاختبار هذه (like iPhone ) :
مثال
<script>
var x = document.getElementById("demo");
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.watchPosition(showPosition);
} else {
x.innerHTML = "Geolocation is not supported by this browser.";
}
}
function showPosition(position) {
x.innerHTML = "Latitude: " + position.coords.latitude +
"<br>Longitude: " + position.coords.longitude;
}
</script> انها محاولة لنفسك »