راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
أضف حاسبة للمسافة من المتجر إلى صفحة هبوط
"كم يبعد أقرب فرع لكم عني" سؤال تستطيع صفحة الهبوط الإجابة عنه مباشرة بدلًا من إرسال الزائر إلى خريطة منفصلة ليكتشف ذلك بنفسه.
الترميز الجغرافي لمدخلات الزائر
خذ أي عنوان أو رمز بريدي يكتبه الزائر في حقل نموذج بسيط وطبّق عليه الترميز الجغرافي.
GET /v1/forward?q=350 Fifth Avenue, New York&limit=1{
"status": "ok",
"results": [
{"formatted": "350 Fifth Avenue, New York, NY", "lat": 40.7484, "lon": -73.9857, "type": "address", "precision": "house", "confidence": 0.96, "place_id": "es234", "components": {}}
]
}حساب المسافة إلى كل متجر
بعد الحصول على إحداثيات الزائر، احسب المسافة في خط مستقيم من تلك النقطة إلى كل موقع من مواقع متاجرك، التي تحتفظ بها كقائمة ثابتة من الإحداثيات في شيفرتك الخاصة، باستخدام صيغة هافرساين القياسية.
for store in stores:
store.distance_km = haversine(store.lat, store.lon, 40.7484, -73.9857)عرض النتيجة
رتّب قائمة المتاجر حسب المسافة المحسوبة واعرض أقربها، أو أقرب بضعة منها، مع رقم المسافة. وبما أن كل ذلك يعمل من جهة الخادم عند إرسال النموذج، فلا حاجة إلى أي سكربت من جهة العميل، إذ تعرض الصفحة النتيجة ببساطة عند تحميل الصفحة التالية.
مثال ثانٍ: عرض أقرب ثلاثة متاجر بدلًا من متجر واحد
بدلًا من الإبلاغ عن أقرب متجر واحد فقط، فإن ترتيب القائمة كاملة وعرض أول ثلاثة يمنح الزائر خيارًا حقيقيًا، وهذا مفيد بشكل خاص عندما يكون لأقرب متجر ساعات عمل أو مخزون مختلف عن متجر أبعد قليلًا قد يفضله الزائر فعلًا. ولا يكلف ذلك شيئًا إضافيًا، لأن الترتيب يتم على الإحداثيات نفسها الناتجة عن الطلب الواحد نفسه.
التعامل مع تطابق منخفض الثقة
إذا عاد العنوان الذي كتبه الزائر بدرجة ثقة منخفضة، فاعرض عليه النتيجة المنسقة لتأكيدها قبل تشغيل حساب المسافة، بدلًا من الإبلاغ بثقة عن مسافة مبنية على تخمين لما كان يقصده.
خطأ شائع يجب تجنبه
لا تشغّل حساب المسافة على استعلام حُلّ بدقة أقل بكثير مما قصده الزائر على الأرجح، مثل اسم مدينة أو منطقة مجرد يطابق نتيجة من النوع "locality"، دون تنبيه الزائر إلى ذلك أولًا. فالمسافة المحسوبة من وسط المدينة بدلًا من الشارع الفعلي للزائر قد تنحرف عدة كيلومترات في أي اتجاه، وهذا يكفي لتغيير المتجر الذي يبدو الأقرب. والتحقق من حقل الدقة قبل الإبلاغ عن رقم مسافة يبدو واثقًا يتجنب تقديم تقدير تقريبي على أنه قيمة دقيقة.
السماح للزائر بالاختيار بين التطابقات الملتبسة
رفع قيمة limit فوق 1 في طلب الترميز الجغرافي يعيد عدة تطابقات مرشحة عندما تكون المدخلات ملتبسة فعلًا، مثل اسم شارع موجود في أكثر من بلدة. وعرض تلك القائمة القصيرة وترك الزائر يختار الصحيح منها قبل تشغيل حساب المسافة نتيجة أفضل من الالتزام بصمت بالمرشح الذي صادف أنه جاء في المرتبة الأولى.
كم يكلف
كل عملية حساب تساوي طلب ترميز جغرافي واحدًا، بغض النظر عن عدد المتاجر التي تقارن بها الإحداثيات الناتجة، لأن قائمة المتاجر نفسها لا تتطلب أي استدعاءات API إضافية بعد حصولك على إحداثيات الزائر. وصفحة الهبوط ذات الزيارات الكبيرة تستخدم هذه الميزة بمعدل طلب واحد لكل عملية حساب يجريها زائر، وهو ضمن 2,500 طلب مجاني يوميًا المضمنة مع كل مفتاح بفارق كبير.
حاسبة المسافة هذه تجيب عن سؤال محدد وشائع مباشرة على الصفحة بدلًا من دفع الزائر إلى مكان آخر لمعرفة الجواب. المعاملات الكاملة للطلب موجودة في توثيق الترميز الجغرافي الأمامي.