راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
الترميز الجغرافي لجدول بيانات من العناوين في طلب دفعي واحد
جدول البيانات المليء بالعناوين لا يحتاج إلى حلقة تكرار. فكل نقطة نهاية في My Geocode تقبل طلب POST يحتوي على مصفوفة JSON بدلًا من معاملات الاستعلام، ونقطة نهاية الترميز الجغرافي الأمامي تقبل عمودًا كاملًا من العناوين دفعة واحدة، وتُرجع نتيجة مرمّزة جغرافيًا واحدة لكل صف بالترتيب نفسه الذي أرسلتها به.
بناء الطلب
صدّر عمود العناوين من جدول البيانات كمصفوفة بسيطة من السلاسل النصية، ثم أرسلها بطلب POST إلى /v1/forward. يُعامل كل عنصر في المصفوفة كاستعلام مستقل ويُرجع نتيجته الخاصة، بالترتيب نفسه الذي أرسلتها به.
POST /v1/forward
Content-Type: application/json
["221B Baker Street, London", "1600 Pennsylvania Avenue, Washington"]{
"status": "ok",
"results": [
{"formatted": "221B Baker Street, London, UK", "lat": 51.5237, "lon": -0.1585, "type": "address", "precision": "house", "confidence": 0.95, "place_id": "abc123", "components": {}},
{"formatted": "1600 Pennsylvania Avenue, Washington, DC", "lat": 38.8977, "lon": -77.0365, "type": "address", "precision": "house", "confidence": 0.97, "place_id": "def456", "components": {}}
]
}تضييق النتائج عند وجود قائمة دول مختلطة
إذا كان جدول البيانات يغطي عدة دول، فإن المصفوفة البسيطة من السلاسل النصية تظل تعمل، لكن أسماء الشوارع الملتبسة في دول مختلفة قد ينتهي بها الأمر إلى أن تُحدَّد في الدولة الخطأ. وحين يحتوي جدول البيانات على عمود منفصل للدولة، أرسل صفوف كل دولة كدفعة مستقلة مع ضبط المعامل countries على رمز ISO المطابق، بدلًا من خلط الدول في طلب واحد والأمل في أن يكفي نص العنوان وحده لإزالة الالتباس.
كم يكلف
يُحتسب الطلب المجمّع حسب العنصر، لا حسب الطلب. فعنوانان في طلب POST واحد يستهلكان طلبين من حصتك اليومية، تمامًا كما لو أرسلت طلبي GET منفصلين. جدول بيانات من 500 صف يكلّف 500 طلب، وهو ما يقع بارتياح ضمن 2,500 طلب مجاني يوميًا التي تأتي مع كل مفتاح، أو حتى دون مفتاح على الإطلاق.
مطابقة الصفوف من جديد
تعود النتائج بالترتيب نفسه للمصفوفة التي أرسلتها، لذا احتفظ برقم الصف الأصلي إلى جانب كل عنوان قبل إرسال الطلب. وحين تصل الاستجابة، طابق النتائج مع صفوف جدول البيانات حسب الموضع، لا بمقارنة النص، لأن العنوان المنسّق في الاستجابة نادرًا ما يُقرأ مطابقًا لما كتبته.
التعامل مع الإخفاقات الجزئية
الصف الذي تغيب نتيجته، أو تكون درجة الثقة فيه منخفضة، أو تكون دقته أقل مما تحتاج، ينبغي وضع علامة عليه بدلًا من قبوله تلقائيًا. افحص حقل confidence في كل عنصر وحوّل كل ما هو دون الحد الذي تضعه إلى قائمة مراجعة يدوية.
حالة حدّية: الصفوف الفارغة
كثيرًا ما يحمل ملف جدول البيانات المُصدَّر عددًا قليلًا من الصفوف الفارغة تمامًا قرب نهاية الملف، متبقية من التنسيق أو من مرشّح كان يشمل خلايا فارغة في وقت ما. والسلسلة الفارغة في المصفوفة تظل تُحتسب عنصرًا واحدًا وعادة ما تُرجع نتيجة فارغة أو ذات ثقة منخفضة جدًا، يلزم بعدها تصفيتها قبل أن تصل إلى جدول بياناتك، لذا احذف الصفوف الفارغة وقت التصدير بدلًا من إرسالها ضمن الدفعة أصلًا.
خطأ يستحق التجنب
إرسال العنوان نفسه مرتين، مرة من قائمة العملاء النشطين ومرة أخرى من ملف تصدير قديم لم يُنظَّف قط، طريقة سهلة لاستهلاك جزء من حصتك اليومية في عمل مكرر. أزل التكرار من عمود العناوين قبل بناء المصفوفة، ولا تُعد معالجة إلا الصفوف التي تغيّرت منذ آخر تصدير، بدلًا من إعادة الترميز الجغرافي لجدول بيانات كامل كلما أُضيف عدد قليل من الصفوف.
تقسيم الملفات الكبيرة
الملفات الكبيرة جدًا أسهل في الإدارة عند تقسيمها إلى أجزاء من بضع مئات إلى بضعة آلاف من الصفوف. كما يسهّل التقسيم فحص ترويسات الحصة بين الدفعات والتوقف قبل أن تتجاوز حصتك المجانية أو رصيدك المسبق الدفع.
إذا كان جدول بياناتك يحتوي على أكثر من عدد قليل من الصفوف، فهذا هو الفرق بين طلب واحد ومئات من الرحلات ذهابًا وإيابًا. والبنية الكاملة للطلب والاستجابة موثقة في صفحة الترميز الجغرافي الأمامي.