POST AI agent ready /v1/address/validate

API التحقق من صحة العنوان - التحقق من العنوان مجانًا

أرسل سلسلة عنوان حرة واسترجع المكونات المنظمة (رقم المنزل، الطريق، المدينة، الولاية، الرمز البريدي، البلد)، وإحداثيات نظام تحديد المواقع العالمي (GPS)، ودرجة الثقة، والعنوان المنسق. يستخدم الترميز الجغرافي للتحقق من وجود العنوان وقابل للتحليل. إرجاع 404 إذا لم يتم العثور على تطابق.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/address/validate \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

التحقق من صحة عناوين الشحن عند الخروج

التحقق من عناوين الشحن التي أدخلها العميل قبل معالجة الطلبات. اكتشف الأخطاء المطبعية والعناوين غير المكتملة والمواقع غير الموجودة قبل أن تصل إلى فريق التنفيذ الخاص بك. يقلل من عمليات التسليم الفاشلة وتكاليف العودة إلى المرسل.

توحيد تنسيقات العناوين عبر الأنظمة

قم بتطبيع العناوين من عمليات استيراد CRM، وتحميلات CSV، وعمليات إرسال النماذج إلى تنسيق منظم متسق. يضمن أن قاعدة بياناتك تحتوي على سجلات عناوين نظيفة ومرمزة جغرافيًا للتحليلات والخدمات اللوجستية.

قم بملء حقول النموذج مسبقًا من إدخال العنوان الجزئي

استخدم المكونات المنظمة بدءًا من التحقق من الصحة وحتى الملء التلقائي لحقول المدينة والولاية والرمز البريدي بعد قيام المستخدم بإدخال عنوان الشارع. يقلل من أخطاء التخلي عن النموذج وإدخال البيانات.

Frequently asked questions

ما مدى دقة التحقق من صحة العنوان؟

تستخدم نقطة النهاية بيانات الترميز الجغرافي لـ OpenStreetMap. إنه قوي للعناوين المعروفة في أمريكا الشمالية وأوروبا. قد يكون للعناوين الريفية أو المبنية حديثًا درجات ثقة أقل أو لا تُرجع أي نتائج.

ماذا تعني درجة الثقة؟

تعكس درجة الثقة (0 إلى 1) مدى تطابق الإدخال مع نتيجة الترميز الجغرافي. تشير الدرجات الأعلى من 0.7 إلى تطابق قوي. تشير الدرجات الأقل من 0.4 إلى أن العنوان قد يكون غامضًا أو متطابقًا جزئيًا.

هل هذا يؤكد وجود العنوان كعنوان بريدي حقيقي؟

لا، تقوم نقطة النهاية هذه بترميز العنوان جغرافيًا وإرجاع البيانات المنظمة. فهو يؤكد أنه تم التعرف على الموقع من خلال تعيين قواعد البيانات، وليس أنه يمكن تسليم البريد هناك. للتحقق من تسليم USPS، تحتاج إلى واجهة برمجة تطبيقات الخدمة البريدية.

هل يمكنني التحقق من صحة العناوين الدولية؟

نعم. تغطي خدمة الترميز الجغرافي العناوين في جميع أنحاء العالم. يخبرك حقل رمز_البلد الموجود في الرد بالبلد الذي تم تحديد العنوان إليه.

ماذا يحدث إذا كان العنوان غامضًا جدًا؟

قد تؤدي المدخلات الغامضة مثل "Main Street" إلى إرجاع نتيجة ذات ثقة منخفضة أو تطابق الموقع الخاطئ. قم بتضمين المدينة أو الولاية أو البلد للحصول على نتائج أفضل.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.