راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
توحيد مُدخلات العناوين غير المرتبة قبل ترميزها جغرافيًا
تجمع حقول العناوين النصية الحرة طيفًا واسعًا من عادات التنسيق: مسافات زائدة، وأحرف كبيرة وصغيرة غير متسقة، واختصارات مكتوبة بشكل غير متسق، وحرف شارد أحيانًا لُصق من مكان آخر. ولا شيء من ذلك يكسر بالضرورة طلب الترميز الجغرافي، لكن تنظيفه أولًا يحسّن عادةً جودة المطابقة.
ما يجب تنظيفه قبل الإرسال
احذف المسافات في البداية والنهاية ودمج المسافات المتكررة في مسافة واحدة. وأزل أحرف التحكم وعلامات الترقيم الشاردة التي من الواضح أنها لا تنتمي إلى العنوان. واترك محتوى العنوان الفعلي كما هو، لأن نقطة نهاية الترميز الأمامي مصممة لتحليل النص الحر ولا تحتاج منك إلى تقسيمه بنفسك إلى حقول منفصلة للشارع والمدينة والرمز البريدي.
GET /v1/forward?q=221b baker st, london&limit=1ستظل نقطة النهاية عمومًا قادرة على حل المدخلات ذات التنسيق الفضفاض كهذه، لأنها مبنية للتعامل مع نصوص العناوين الواقعية لا مع قالب صارم، لكن سلسلة المدخلات الأنظف تقلل احتمالات المطابقة الملتبسة أو منخفضة الثقة في البيانات غير المرتبة فعلًا.
مثال ثانٍ: ترك الاختصارات كما هي
الاستعلام الذي يستخدم اختصارات شائعة، مثل "St" بدلًا من "Street" أو "Ave" بدلًا من "Avenue"، لا يحتاج إلى توسيعها قبل الإرسال.
GET /v1/forward?q=500 5th Ave, New York&limit=1توسيع كل اختصار بنفسك قبل إرسال الطلب عمل إضافي نادرًا ما يغيّر النتيجة، لأن نقطة النهاية تتعامل بالفعل مع الاختصارات القياسية كجزء من تحليل نص العنوان العادي. ركّز جهد التنظيف على المدخلات المعطوبة فعلًا، مثل فواصل الأسطر الملصوقة أو آثار الترميز، بدلًا من إعادة كتابة اختصارات لم تكن مشكلة أصلًا.
استخدام معامل countries لتضييق النتائج
إذا كنت تعرف بالفعل الدولة التي يجب أن يقع فيها العنوان، من عنوان فوترة مسجل أو من التركيز الإقليمي للموقع، فمرّرها عبر معامل countries لتقليل المطابقات الملتبسة مع أماكن تحمل أسماء مشابهة في أنحاء أخرى من العالم.
GET /v1/forward?q=Springfield Main Street&countries=US&limit=3خطأ يستحق التجنب
الإفراط في تنظيف العنوان بإزالة كل ما يبدو غير معتاد قد يحذف معلومات كان المرمّز الجغرافي يحتاجها فعلًا. فرقم الوحدة أو الشقة، أو مؤشر الطابق، أو اسم المبنى المرفق بعنوان الشارع محتوى ذو معنى وليس ضجيجًا، حتى لو بدا مختلفًا عن بقية العنوان. اقصر التنظيف على المسافات والترميز والأحرف الشاردة بوضوح، واترك كل ما يُحتمل أن يكون جزءًا من العنوان.
التحقق من درجة الثقة بعد ذلك
يقلل التوحيد المطابقات السيئة، لكنه لا يلغيها تمامًا. تحقق دائمًا من حقل confidence في النتيجة بدلًا من افتراض أن النتيجة المُرجعة صحيحة تلقائيًا لمجرد أن الطلب نجح.
تكلفة الطلب تبقى كما هي
تنظيف سلسلة المدخلات قبل إرسالها لا يغيّر عدد الطلبات التي يكلفها الاستعلام، فهو يبقى طلبًا واحدًا لكل عنوان. ما يتغير هو احتمال أن يُرجع الطلب الواحد الذي ترسله شيئًا مفيدًا، بدلًا من الحاجة إلى محاولة ثانية مصححة ستكلف طلبًا ثانيًا.
ضبط التوحيد من البداية يعني عمليات استعلام مهدرة أقل وبيانات أنظف في المراحل اللاحقة. راجع توثيق الترميز الجغرافي الأمامي للاطلاع على المجموعة الكاملة من المعاملات المدعومة، بما فيها countries وlimit.