JavaScript - Geolocation API

JavaScript Geolocation API – الموقع الجغرافي للمستخدم

🔸 Geolocation API تتيح لتطبيقات الويب تحديد الموقع الجغرافي للمستخدم (مثل الإحداثيات الجغرافية للطول والعرض). ⚠️ تتطلب هذه الميزة موافقة المستخدم وتعمل فقط على المواقع الآمنة (HTTPS).

---

🔹 الحصول على الموقع الحالي

navigator.geolocation.getCurrentPosition(
  function(position) {
    console.log("Latitude:", position.coords.latitude);
    console.log("Longitude:", position.coords.longitude);
  },
  function(error) {
    console.error("حدث خطأ:", error.message);
  }
);

📌 الدالة getCurrentPosition() تأخذ دالتين: الأولى عند النجاح، والثانية عند الفشل أو الرفض.

---

🔹 مراقبة تغيّر الموقع

const watchId = navigator.geolocation.watchPosition(
  position => {
    console.log("متابعة - الموقع:", position.coords.latitude, position.coords.longitude);
  }
);

// لإيقاف التتبع لاحقًا:
navigator.geolocation.clearWatch(watchId);

📌 تُستخدم watchPosition() لتتبع الموقع باستمرار، وclearWatch() لإيقافه.

---

📌 ملاحظات حول الأمان

• لا تعمل Geolocation إلا من خلال HTTPS أو من localhost.
• المتصفح يطلب إذن المستخدم قبل مشاركة الموقع.
• قد تختلف دقة الموقع حسب الجهاز ونوع الاتصال.

---

⚠️ رسائل الخطأ المحتملة

• PERMISSION_DENIED: المستخدم رفض الوصول للموقع.
• POSITION_UNAVAILABLE: تعذر تحديد الموقع.
• TIMEOUT: انتهت المهلة قبل الحصول على الموقع.