تحقق من وقوع العنوان ضمن نطاق التوصيل
قرروا في خطوة واحدة إن كان العنوان ضمن منطقة التوصيل: عنوان يبعد 6.283267 كم في خط مستقيم عن المركز يقع داخل نصف قطر قدره 10 كم. أدخلوا زوجي الإحداثيات ونصف القطر. مجانا في متصفحكم.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- خط عرض المركز
- 40.7128
- خط طول المركز
- -74.006
- خط عرض العنوان
- 40.73061
- خط طول العنوان
- -73.935242
- أقصى نصف قطر (km)
- 10
- المسافة (km)
- 6.283267
يبدأ وعد التوصيل غالبا بسؤال عملي: هل يقع هذا العنوان على مسافة قريبة بما يكفي من المركز المخصص؟ أدخل خط عرض المركز وخط طوله، وخط عرض عنوان التوصيل وخط طوله، وأقصى نصف قطر بالكيلومترات. تتحقق الأداة من زوجي الإحداثيات، وتحسب مسافة الدائرة العظمى المباشرة، ثم تعيد قرارا واضحا بشأن النطاق مع المسافة المقيسة. حسابها حتمي ولا يحتاج إلى مزود خرائط، ويلائم التحقق عند الدفع والفرز الأولي للإرسال وقواعد التشغيل القابلة للتكرار.
كيفية حساب قرار نطاق التوصيل
تتعامل الأداة مع المركز بوصفه مركز منطقة خدمة دائرية، ومع أقصى نصف قطر مدخل بوصفه حدها. وتحسب أقصر مسافة سطحية بين المركز والعنوان بصيغة هافرسين وبنصف قطر أرضي متوسط ثابت قدره 6371.0088 كيلومترا. والنتيجة هي مسافة دائرة عظمى، وتسمى أحيانا المسافة المباشرة.
تستخدم مقارنة الحد القيمة الداخلية الكاملة لا القيمة المعروضة. لا يفحص هذا النموذج الشوارع أو الجسور أو الأنهار أو الازدحام أو قيود القيادة أو مضلعات التوصيل المرسومة. استخدمه عندما تكون القاعدة التجارية شعاعية فعلا، أو مرشحا أوليا قليل التكلفة قبل نظام أغلى للمسارات أو المناطق.
إعداد الإحداثيات وفهم أخطاء التحقق
تمتد خطوط العرض بالدرجات العشرية من -90 إلى 90، وخطوط الطول من -180 إلى 180، مع قبول الحدود. يجب أن يكون نصف قطر الخدمة صفرا أو أكبر؛ ولا يسمح الصفر إلا بعنوان في إحداثيات المركز نفسها. من الأخطاء الشائعة عكس خط العرض وخط الطول.
ولأن خطوط طول كثيرة تقع أيضا ضمن نطاق العرض، قد يجتاز الزوج المعكوس التحقق وهو يصف مكانا آخر. التزم بترتيب موحد عند الترميز الجغرافي والتخزين والطلب. يجب أن تمثل الإحداثيات مواقع جغرافية بالدرجات العشرية، لا أمتارا مسقطة أو رموزا بريدية أو نص عنوان خاما.
رمز العنوان جغرافيا أولا واحتفظ بدقة تناسب التشغيل. تتحقق الأداة من الصيغة والنطاق، لكنها لا تؤكد أن النقطة تشير إلى المبنى أو المدخل المطلوب.
الاستخدام الآمن عند الدفع والإرسال
عند وجود عدة مراكز، قيم العنوان مقابل كل مركز نشط، واستبعد نتائج false، ورتب الباقي حسب المسافة أو المخزون أو عبء العمل أو الموعد. لا تضمن مطابقة نصف القطر وجود طريق صالح أو نجاح التوصيل. فقد تجعل السواحل والطرق المقيدة ورسوم المرور والعبارات والمرافق المغلقة والمناطق المحلية نقطة قريبة غير عملية.
في هذه الحالات، أتبع المرشح الشعاعي بفحص مسار أو مضلع. اختر نصف القطر وفق سياسة تجارية صريحة. لا يعتمد الحساب على الشبكة أو العشوائية أو الوقت الحالي، لذلك تنتج الطلبات المتطابقة استجابات متطابقة.
صحح أخطاء التحقق في مصدر البيانات، ولا سيما الحقول المعكوسة أو الترميز الجغرافي الناقص، بدلا من اعتبارها خارج النطاق تلقائيا.
حالات الاستخدام
أهلية التوصيل عند الدفع
حدد ما إذا كان العنوان المرمز جغرافيا قريبا بما يكفي من المركز قبل عرض التوصيل المحلي أو في اليوم نفسه.
اختيار أقرب مركز مؤهل
قارن عنوانا بعدة مراكز، واستبعد ما يتجاوز نصف قطره، ثم رتب الباقي حسب المخزون وعبء العمل.
ضبط جودة بيانات الإرسال
تحقق من إحداثيات المراكز والمحطات المخزنة وسجل مسافة ونتيجة قابلتين للتكرار للمراجعة والاستثناءات.
الأسئلة الشائعة
هل تتبع المسافة الطرق؟
لا. إنها مسافة الدائرة العظمى على سطح الأرض. تتطلب الطرق والازدحام والعوائق والقيود خدمة توجيه.
هل يمكنني إرسال عنوان شارع بدلا من الإحداثيات؟
لا. رمز العنوان جغرافيا أولا، ثم أرسل خط عرضه وطوله بالدرجات العشرية مع إحداثيات المركز.
كم تبلغ تكلفة عملية تحقق واحدة؟
الحساب حتمي ولا يستدعي أي مزود خرائط خارجي.
هل يعد العنوان الواقع على حد نصف القطر تماما داخل المنطقة؟
نعم. يكون العنوان داخل المنطقة عندما تكون مسافته أقل من نصف القطر أو مساوية له، وتستخدم المقارنة المسافة الكاملة قبل التقريب، فلا يغير التقريب المعروض القرار أبدا.
ماذا يحدث إذا عكست خط العرض وخط الطول؟
تبدو أزواج معكوسة كثيرة صالحة، لأن معظم خطوط الطول تقع أيضا ضمن مدى خطوط العرض، لكنها تشير إلى مكان آخر. حافظوا على الترتيب نفسه دائما، من تحويل العنوان إلى إحداثيات حتى هذا التحقق.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/ecom/last-mile-delivery-zone-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"hub_lat":40.7128,"hub_lon":-74.006,"address_lat":40.73061,"address_lon":-73.935242,"max_radius_km":10}'const res = await fetch("https://api.kit.forhosting.com/ecom/last-mile-delivery-zone-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"hub_lat": 40.7128,
"hub_lon": -74.006,
"address_lat": 40.73061,
"address_lon": -73.935242,
"max_radius_km": 10
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/last-mile-delivery-zone-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"hub_lat": 40.7128,
"hub_lon": -74.006,
"address_lat": 40.73061,
"address_lon": -73.935242,
"max_radius_km": 10
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/last-mile-delivery-zone-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"hub_lat":40.7128,"hub_lon":-74.006,"address_lat":40.73061,"address_lon":-73.935242,"max_radius_km":10}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"hub_lat":40.7128,"hub_lon":-74.006,"address_lat":40.73061,"address_lon":-73.935242,"max_radius_km":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/last-mile-delivery-zone-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"hub_lat": 40.7128,
"hub_lon": -74.006,
"address_lat": 40.73061,
"address_lon": -73.935242,
"max_radius_km": 10
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.last_mile_delivery_zone_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
كيفية حساب قرار نطاق التوصيل
إذا كانت المسافة المحسوبة قبل التقريب أقل من أقصى نصف قطر أو مساوية له، تكون within_zone بالقيمة true؛ وإلا تكون false. تتضمن الاستجابة أيضا distance_km مقربة إلى ست منازل عشرية، وتكرر max_radius_km لتظل السجلات والقرارات واضحة.
إعداد الإحداثيات وفهم أخطاء التحقق
قدم خمسة أعداد منتهية: hub_lat وhub_lon وaddress_lat وaddress_lon وmax_radius_km. تعيد القيم المفقودة والنصوص غير الرقمية واللانهايات والإحداثيات خارج النطاق الخطأ invalid_input بدلا من قرار مضلل.
الاستخدام الآمن عند الدفع والإرسال
عند الدفع، شغل الأداة بعد تحويل العنوان إلى إحداثيات، ثم استخدم within_zone كأحد مدخلات عرض التوصيل. احتفظ بقيمة distance_km في سجل تدقيق الطلب حتى يمكن تفسير سبب عرض الخيار. تبلغ تكلفة كل عنصر API ناجح $0.002.
أسئلة تقنية
هل يشمل النطاق عنوانا يقع على الحد تماما؟
نعم. تكون within_zone بالقيمة true عندما تكون المسافة الكاملة أقل من max_radius_km أو مساوية له.
ماذا يحدث إذا كان زوج الإحداثيات غير صالح؟
يعيد خط العرض أو الطول المفقود أو غير المنتهي أو الخارج عن النطاق الخطأ invalid_input دون قرار للمنطقة.