عندما يكتب المستخدم طلب بحث، يتم إرسال طلب إكمال تلقائي كل بضع ضغطات على المفاتيح (وليس لكل حرف)، ويتم عرض قائمة بالنتائج المحتملة. عندما
يختار المستخدم من قائمة النتائج، يتم احتساب الاختيار كطلب،
ويتم تجميع جميع الطلبات التي تم إجراؤها أثناء البحث واحتسابها
كطلب واحد. إذا اختار المستخدم مكانًا، يتوفّر طلب البحث
بدون أي رسوم، ويتم تحصيل رسوم مقابل طلب بيانات المكان فقط. إذا لم يحدّد المستخدم خيارًا في غضون بضع دقائق من بداية الجلسة، سيتم تحصيل رسوم مقابل طلب البحث فقط.
لنتناول تسلسل الأحداث هذا من منظور التطبيق.
يبدأ المستخدم في كتابة طلب بحث عن "باريس، فرنسا".
عند رصد إدخال من المستخدم، ينشئ التطبيق رمزًا مميزًا جديدًا للجلسة، وهو "الرمز المميز أ".
أثناء كتابة المستخدم، ترسل واجهة برمجة التطبيقات طلب إكمال تلقائي كل بضعة أحرف، وتعرض قائمة جديدة بالنتائج المحتملة لكل منها:
"P"
"Par"
"Paris,"
"Paris, Fr"
عندما يحدّد المستخدم خيارًا:
يتم تجميع كل الطلبات الناتجة عن طلب البحث وإضافتها إلى الجلسة
التي يمثّلها "الرمز المميّز أ" كطلب واحد.
يتم احتساب اختيار المستخدم كطلب "تفاصيل المكان"، وتتم إضافته إلى
الجلسة التي يمثّلها "الرمز المميّز أ".
تنتهي الجلسة، ويتجاهل التطبيق "الرمز المميّز أ".
لمزيد من المعلومات حول كيفية فوترة طلبات "الإكمال التلقائي"، يُرجى الاطّلاع على الاستخدام والفوترة.
تاريخ التعديل الأخير: 2026-11-10 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2026-11-10 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]