فحص سياج جغرافي دائري

تحسب الأداة مسافة الدائرة العظمى بصيغة Haversine، وتقارنها بنصف القطر بالأمتار، ثم تعيد هامشًا موقّعًا يوضح المسافة المتبقية. يعني الهامش الموجب أن النقطة في الداخل، ويحدد الصفر الحد، بينما يبين الهامش السالب مقدار وجود النقطة في الخارج. الحساب حتمي ولا يحتاج إلى خدمة خرائط أو بحث عن جهاز أو طلب شبكة.

حددوا النقطة والمركز ونصف القطر بوضوح

يتكون السياج الجغرافي الدائري من ثلاثة عناصر أساسية: خط عرض المركز، وخط طوله، ونصف قطر غير سالب مقاس بالأمتار. ويحدد خط عرض النقطة وخط طولها المنفصلان الموقع الذي تريدون اختباره. أدخلوا جميع الإحداثيات بالدرجات العشرية ضمن نطاقات WGS84 الجغرافية المعتادة: خط العرض من سالب تسعين إلى تسعين، وخط الطول من سالب مئة وثمانين إلى مئة وثمانين. لا ترسلوا إحداثيات خرائط مسقطة، أو نصوص الدرجات والدقائق والثواني، أو نصف قطر بالكيلومترات من دون تحويله أولًا. فعلى سبيل المثال، تتطلب منطقة توصيل مداها خمسة كيلومترات قيمة radius_m تساوي 5000. تقبل الأداة الصفر نصفَ قطر صالحًا؛ وفي هذه الحالة لا تقع في الداخل إلا نقطة تطابق إحداثيات المركز تمامًا. وترفض القيم المفقودة والأعداد غير المنتهية والإحداثيات الخارجة عن نطاقها القانوني وأنصاف الأقطار السالبة بدل تصحيح خطأ تكامل محتمل بصمت. تعمل خطوط الطول على جانبي خط التاريخ الدولي من دون منطق خاص لدى العميل، لأن الصيغة المثلثية تستخدم تلقائيًا أقصر فصل على سطح الكرة.

فسروا العضوية والمسافة والهامش الموقّع

تتضمن الاستجابة أربعة حقول موجزة. تكون القيمة المنطقية inside صحيحة عندما تكون المسافة المحسوبة أقل من نصف القطر أو مساوية له، ولذلك تنتمي النقطة الواقعة على الحد تمامًا إلى السياج. يمثل الحقل distance_m مسافة الدائرة العظمى بين المركز والنقطة على كرة أرضية متوسطة نصف قطرها 6,371,000 متر. ويكرر radius_m نصف القطر الذي جرى التحقق منه، بينما يطرح margin_m المسافة من نصف القطر. وغالبًا ما يفيد هذا الهامش الموقّع أكثر من القيمة المنطقية وحدها: فالقيمة 240 تعني أن النقطة في الداخل مع نحو 240 مترًا متبقيًا، والصفر يعني أنها على الحافة، وسالب 85 يعني أنها خارج السياج بنحو 85 مترًا. تُقرّب مسافات الخرج إلى ست منازل عشرية لضمان تسلسل ثابت، لكن قرار inside يستخدم الحساب الكامل غير المقرب. وبذلك لا تغير قيمة العرض المقربة المقارنة الحقيقية. في سياسات التوجيه أو الفوترة، اختاروا احتياطيًا تشغيليًا قبل الاستدعاء أو قارنوا الهامش المعاد بعتبة السلامة الخاصة بكم.

استخدموا النتيجة بأمان في العمليات الفعلية

تلائم الاختبارات الدائرية اكتشاف الوصول، وتحديد أهلية التوصيل، وتنبيهات المعدات القريبة، ومناطق الدخول التقريبية. لكنها ليست حدود ملكية قانونية، ولا تراعي الطرق أو الجدران أو الارتفاع أو طوابق المباني أو عدم دقة GPS. قد يتذبذب موقع الهاتف عدة أمتار أو أكثر، ولذلك تتطلب تطبيقات الإنتاج عادة قراءات متكررة أو حدًا للدقة أو تباطؤًا تفاضليًا قبل إطلاق إجراء لا يمكن التراجع عنه. فمثلًا، يمكن لسير عمل الوصول أن يسجل الدخول فقط عندما يتجاوز margin_m عشرين مترًا، ويسجل الخروج عندما ينخفض عن سالب عشرين، مما يمنع تغير الحالة سريعًا قرب الحافة. يتسم نموذج Haversine الكروي بالاتساق والسرعة في أنحاء العالم، بما في ذلك قرب القطبين وخط التاريخ الدولي، لكنه تقريب وليس حساب مسح إهليلجيًا. تعطي المدخلات نفسها النتيجة ذاتها دائمًا لأن المحلل لا يستخدم الشبكة أو الوقت الحالي أو العشوائية أو قاعدة خرائط خارجية. يتوفر التنفيذ التفاعلي في المتصفح، وتبلغ كلفة كل طلب API آلي $0.002. احتفظوا بالإحداثيات الأصلية مع النتيجة إذا كان تدقيق لاحق سيحتاج إلى تفسير القرار.