راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
اقرأ درجة الثقة بشكل صحيح قبل أن تعتمد عليها
تبدو قيمة الثقة بين 0.0 و1.0 في نتيجة الترميز الجغرافي كإشارة نجاح أو فشل بسيطة، لكن معاملتها بهذه الطريقة تغفل ما تقيسه فعلًا.
ما الذي تقيسه الثقة
تعكس الثقة مدى يقين المطابقة، بالنظر إلى نص الإدخال، بأن هذه النتيجة تحديدًا هي التي كان الإدخال يشير إليها. ودرجة الثقة العالية على إدخال غامض أو منسق بشكل غريب لا تزال تعني أن النظام واثق من أفضل تخمين لديه، لا أن الإدخال كان صحيحًا بالتأكيد أو أن الموقع موجود بالتأكيد كما وُصف.
GET /v1/forward?q=Main Street, Springfield&limit=1{
"status": "ok",
"query": "Main Street, Springfield",
"results": [
{"formatted": "Main Street, Springfield, IL", "lat": 39.7817, "lon": -89.6501, "type": "address", "precision": "street", "confidence": 0.62, "place_id": "sp901", "components": {}}
]
}تعكس الثقة البالغة 0.62 هنا حقيقة أن بلدات كثيرة تحمل اسم Springfield، لذلك حتى المطابقة الصحيحة مع Springfield محددة تحمل قدرًا من عدم اليقين المتأصل بشأن ما إذا كانت هي Springfield التي قصدها الإدخال.
الثقة مقابل الدقة
هذان حقلان مختلفان يقيسان شيئين مختلفين. تصف الدقة مدى تحديد المطابقة: منزل، أو شارع، أو مستوى أعم. وتصف الثقة مدى يقين النظام من المطابقة التي أجراها. فالنتيجة بدقة "house" قد تحمل درجة ثقة متوسطة إذا كان الإدخال غامضًا بشأن أي منزل في أي شارع، والنتيجة بدقة "street" قد تحمل درجة ثقة عالية إذا كانت المطابقة، رغم عموميتها، لا لبس فيها.
تحديد حد أدنى
اختر حدًا أدنى للثقة بناءً على ما ستكلفك إياه النتيجة الخاطئة. فالحد البالغ 0.8 أو أعلى منطقي لشيء آلي وذي عواقب، مثل ملء ملصق شحن تلقائيًا دون مراجعة بشرية. والحد الأدنى الأقل معقول لشيء يتحقق فيه إنسان من النتيجة لاحقًا، مثل اقتراح يُعرض على العميل لتأكيده.
الجمع مع معامل countries
المطابقات الغامضة مثل مثال Springfield أعلاه تُحل غالبًا بتضييق البحث باستخدام معامل countries عندما تعرف مسبقًا الدولة التي يجب أن يكون فيها العنوان، وهذا يرفع احتمال الحصول على مطابقة عالية الثقة من المحاولة الأولى بدلًا من الحاجة إلى استعلام ثانٍ.
التكلفة تبقى كما هي
قراءة الثقة بشكل صحيح لا تغير تكلفة الاستعلام، فهي طلب واحد في الحالتين. ما تغيره هو ما إذا كنت تتصرف بناءً على النتيجة بالقدر المناسب من الثقة.
الثقة إشارة محددة وضيقة، وليست ضمانًا عامًا للصحة، وقراءتها بهذه الطريقة تجنبك التصرف بسرعة بناءً على مطابقة مهزوزة. التعريفات الكاملة للحقول موجودة في توثيق الترميز الجغرافي الأمامي.