أثناء كتابة المستخدم لطلب بحث، يتم استدعاء طلب الإكمال التلقائي كل بضع ضغطات على المفاتيح (وليس لكل حرف)، ويتم عرض قائمة بالنتائج المحتملة. عندما يختار المستخدم نتيجة من قائمة النتائج، يتم احتساب هذا الاختيار كطلب، ويتم تجميع كل الطلبات التي تم إجراؤها أثناء البحث واحتسابها كطلب واحد. إذا اختار المستخدم مكانًا، يتوفّر طلب البحث بدون أي رسوم، ويتم تحصيل رسوم طلب بيانات المكان فقط. إذا لم يحدّد المستخدم أي اختيار خلال بضع دقائق من بداية الجلسة، سيتم تحصيل رسوم مقابل طلب البحث فقط.
لنتناول الآن تسلسل الأحداث هذا من منظور تطبيق.
يبدأ المستخدم في كتابة طلب بحث للعثور على "باريس، فرنسا".
عند رصد إدخال من المستخدم، ينشئ التطبيق رمزًا مميزًا جديدًا للجلسة، وهو "الرمز المميز أ".
أثناء كتابة المستخدم، يرسل واجهة برمجة التطبيقات طلب إكمال تلقائي كل بضعة أحرف، ويعرض قائمة جديدة بالنتائج المحتملة لكل منها:
"ب"
"بر"
"برلين"
"برلين، ألمانيا"
عندما يحدّد المستخدم خيارًا:
يتم تجميع جميع الطلبات الناتجة عن طلب البحث وإضافتها إلى الجلسة الممثّلة بالرمز المميز "أ" كطلب واحد.
يتم احتساب اختيار المستخدِم كطلب تفاصيل عن المكان، ويتم إضافته إلى الجلسة الممثّلة بالرمز المميز "Token A".
تنتهي الجلسة، ويتجاهل التطبيق الرمز المميّز "أ".
لمزيد من المعلومات حول كيفية احتساب تكلفة طلبات الإكمال التلقائي، يُرجى الاطّلاع على الاستخدام والفوترة.
تاريخ التعديل الأخير: 2026-09-14 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-09-14 (حسب التوقيت العالمي المتفَّق عليه)"],[],["This document details the use of session tokens with the Places API. A session token groups a user's autocomplete search into a single session for billing. Users must create unique session tokens (version 4 UUIDs recommended) for each session, ensuring uniqueness within a project. Requests are bundled into a session. If a user selects a place, only the place details are charged; otherwise, only the search query is charged. Each session ends after a user's selection or inactivity, at which point the token is discarded.\n"]]
