راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
الاستعلام عن الرمز البريدي لعنوان جزئي
العميل الذي يترك حقل الرمز البريدي فارغًا لم يعطك بالضرورة بيانات سيئة. فالترميز الجغرافي الأمامي يستطيع عادةً سد هذه الفجوة من بقية العنوان.
إرسال العنوان الجزئي
أرسل أي نص لديك، الشارع والمدينة على الأقل، إلى /v1/forward. يتضمن كائن components في النتيجة الرمز البريدي لأفضل مطابقة، حتى لو لم يذكر المُدخل أي رمز بريدي.
GET /v1/forward?q=1600 Pennsylvania Avenue, Washington&limit=1{
"status": "ok",
"query": "1600 Pennsylvania Avenue, Washington",
"results": [
{
"formatted": "1600 Pennsylvania Avenue NW, Washington, DC 20500",
"lat": 38.8977,
"lon": -77.0365,
"type": "address",
"precision": "house",
"confidence": 0.97,
"place_id": "def456",
"components": {"postcode": "20500", "city": "Washington", "region": "DC", "country": "US"}
}
]
}مثال أقل اكتمالًا، ولماذا يهم
ليس كل عنوان بهذا الاكتمال. فالاستعلام الذي لا يتضمن سوى مدينة ومنطقة، مثل "Springfield, Illinois"، قد يعيد نتيجة مع ذلك، لكن الرمز البريدي في components سيغطي المدينة بأكملها لا مبنى واحدًا، وسيحمل حقل precision قيمة أقل دقة من "house". وهذا الفرق مهم إذا كنت تخطط لطباعة الرمز البريدي المُعاد على ملصق شحن بدلًا من استخدامه لتقدير إقليمي فقط، لأن الرمز البريدي على مستوى المدينة لا يقدم الضمان نفسه الذي يقدمه الرمز على مستوى المنزل.
الوثوق بالنتيجة
تحقق من حقلي precision وconfidence قبل اعتبار الرمز البريدي المُعاد موثوقًا. فدقة "house" مع درجة ثقة عالية تعني أن المطابقة كانت محددة بما يكفي للوثوق بقيمة الرمز البريدي مباشرة. أما الدقة الأقل، مثل المطابقة على مستوى الشارع أو المدينة، فتعني أن الرمز البريدي يغطي مساحة أوسع وقد لا يطابق العنوان الدقيق الذي قصده العميل.
تكلفة هذا البحث
هذا بحث واحد، أي طلب واحد من حصتك اليومية لعنوان واحد. والقيام بذلك لكل نموذج دفع أو تسجيل يصل دون رمز بريدي استخدام عادي، ونادرًا ما يقترب من 2,500 طلب مجاني مضمنة يوميًا مع المفتاح، أو من عنوان IP واحد دون مفتاح.
عندما لا توجد مطابقة جيدة
مصفوفة النتائج الفارغة، أو النتيجة ذات درجة الثقة المنخفضة، تعني أن العنوان كان مبهمًا جدًا بحيث تعذر حله. وفي هذه الحالة، اطلب الرمز البريدي من العميل مباشرة بدلًا من التخمين، لأن الرمز البريدي الخاطئ على ملصق الشحن يسبب مشكلات أكثر من الرمز الفارغ.
حالة استثنائية تستحق التخطيط لها
بعض الدول لا تستخدم الرموز البريدية على الإطلاق، أو تستخدمها بشكل غير متسق إلى حد أن كائن components يحذف الحقل ببساطة في نتيجة معينة. لا تعامل غياب حقل postcode كخطأ في حد ذاته، بل تحقق أولًا من الدولة في كائن components، ولا تضع علامة على الصف للمراجعة إلا إذا كانت الدولة المعنية من الدول التي يُتوقع فيها الرمز البريدي عادةً.
تحقق ذو صلة
بمجرد أن يكون لديك رمز بريدي مرشح، فإن استدعاءً مباشرًا لـ /v1/postcode بهذا الرمز والدولة من كائن components طريقة سريعة للتحقق منه بشكل مستقل، وهو مفيد خصوصًا عندما تكون ثقة الترميز الجغرافي الأمامي الأصلية على الحد الفاصل، لا عالية بوضوح ولا منخفضة بوضوح.
ملء الرمز البريدي المفقود بهذه الطريقة يوفر حقلًا في النموذج وجولة مراسلة مع العميل. والتعريفات الكاملة للحقول موجودة في توثيق البحث عن الرموز البريدية وتوثيق الترميز الجغرافي الأمامي.