اقتراحات الأماكن قد تصبح مكلفة أو مشوشة إذا لم تربط الجلسة بالاختيار النهائي.

نُشر في 11 أغسطس 2026 · Places API / Autocomplete / Session Tokens

توضح Google أن Autocomplete New يقدم توقعات للأماكن أو عبارات البحث أثناء الكتابة، ويمكن تحسين النتائج عبر locationBias أو locationRestriction وأنواع الأماكن. كما توصي باستخدام session tokens لأن الجلسة تبدأ مع أول طلب Autocomplete يحتوي token وتنتهي بطلب Place Details أو Address Validation بنفس token. بالنسبة لصفحات الفروع، هذا ليس تفصيلًا للمطور فقط؛ بل يؤثر على التكلفة ودقة اختيار الفرع أو العنوان.

أين تظهر المشكلة؟

نموذج حجز أو تواصل قد يرسل طلبًا مع كل حرف، ثم لا ينهي الجلسة بطلب تفاصيل المكان. في هذه الحالة تصبح الجلسات المهجورة أقرب إلى تسعير كل طلب، وتفقد القدرة على ربط ما كتبه المستخدم بالاختيار النهائي.

مشكلة أخرى أن تستخدم locationBias وlocationRestriction بطريقة عشوائية. الأول يوجه النتائج نحو منطقة مع السماح بخارجها، والثاني يقيد النتائج داخل المنطقة. اختيار غير مناسب قد يخفي فرعًا صحيحًا أو يعرض اقتراحات بعيدة.

طريقة تنفيذ أكثر انضباطًا

أنشئ session token لكل محاولة بحث حقيقية، وأعد استخدامه حتى يختار المستخدم مكانًا أو تنتهي الرحلة. عند الاختيار، اطلب Place Details بالحقول الضرورية فقط، ثم احفظ Place ID أو النتيجة التي تحتاجها الصفحة بدون تخزين زائد.

لصفحات الفروع، اجعل القيود مرتبطة بسياق الصفحة: مدينة أو منطقة خدمة أو نطاق توصيل. لا تجعل autocomplete عامًا إذا كان هدف الصفحة توجيه المستخدم لأقرب فرع أو عنوان محدد.

Checklist

• أنشئ token جديدًا لكل رحلة autocomplete فعلية.
• أنه الجلسة بطلب Place Details أو Address Validation عند الاختيار.
• استخدم locationBias أو locationRestriction ولا تجمعهما معًا.
• اطلب الحقول الضرورية فقط في Place Details.
• راقب الجلسات المهجورة وتكلفتها.
• اختبر اللغة وترتيب الاقتراحات على الهاتف.

أين تدخل ok4host؟

ok4host يراجع نماذج الفروع والخرائط المحلية بحيث تكون تجربة البحث دقيقة، تكلفة API مفهومة، وبيانات Place ID قابلة للتحديث.

أسئلة شائعة

هل أحتاج session token دائمًا؟ Google توصي به لتبسيط التسعير وربط طلبات الجلسة.

هل أحفظ كل بيانات المكان؟ احفظ ما تحتاجه فقط، مثل Place ID والحقول التشغيلية المسموح بها.

ما أول فحص؟ راقب هل كل اختيار نهائي ينهي جلسة autocomplete بشكل صحيح.

المصادر

• Google Maps Platform: Autocomplete New.
• Google Maps Platform: Autocomplete session pricing.
• Google Maps Platform: Places API policies.