تنصحك Google باستخدام الجلسات مع الإكمال التلقائي (جديد). تساعد الجلسات في تبسيط الأسعار وتوفير نموذج أسعار ثابت لاستخدامه مع ميزة "الإكمال التلقائي (جديد)".
تبدأ الجلسة بطلب "الإكمال التلقائي (جديد)" الأول الذي يتضمّن رمزًا مميزًا للجلسة، وتستمر خلال كل طلب "إكمال تلقائي (جديد)" لاحق، ثم تنتهي بطلب "تفاصيل المكان (جديد)" أو "التحقّق من صحة العنوان" الذي يستخدم رمز الجلسة المميز.
بعد انتهاء الجلسة، سيتم تحصيل رسوم مقابل أي طلب إلى "الإكمال التلقائي (جديد)" أو "تفاصيل المكان (جديد)" أو "التحقّق من صحة العنوان" يستخدم رمز الجلسة المنتهي الصلاحية، كما لو لم يكن هناك رمز جلسة.
لا يتم تحصيل رسوم الجلسات غير المكتملة، أي الجلسات التي لا تنتهي بطلب إلى Place Details (New) أو Address Validation، إلا مقابل طلبات الإكمال التلقائي (جديد) باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
الفوترة حسب الجلسة
الجلسات التي تنتهي بطلب أساسي لتفاصيل المكان (جديد)
بالنسبة إلى جلسات "الإكمال التلقائي (جديد)" التي تنتهي بطلب يستخدم حقولاً من SKU: أساسيات تفاصيل الأماكن في Places API:
- أول 12 طلبًا من طلبات الإكمال التلقائي (جديد): يتم تحصيل رسوم منك مقابل كل طلب من طلبات الإكمال التلقائي (جديد)، بحد أقصى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
- بالنسبة إلى طلبات الإكمال التلقائي (جديد) رقم 13 والإصدارات الأحدث في الجلسة نفسها: سيتم تحصيل الرسوم منك وفقًا لرمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لن يتم تحصيل أي رسوم مقابل هذه الطلبات.
- أساسيات تفاصيل المكان (جديدة): يتم أيضًا تحصيل رسوم منك مقابل الطلب الذي تم إنهاؤه باستخدام رمز التخزين التعريفي: أساسيات تفاصيل المكان في Places API.
الجلسات التي تنتهي بطلبات "التحقّق من صحة العنوان" أو "تفاصيل المكان (جديد)" (غير أساسية)
بالنسبة إلى جلسات "الإكمال التلقائي (جديد)" التي تنتهي بطلب "التحقّق من صحة العنوان" أو طلب "تفاصيل المكان (جديد)" باستخدام حقول من "تفاصيل المكان" Pro أو Enterprise أو Enterprise + Atmosphere:
- طلبات الإكمال التلقائي (جديد): يتم تحصيل رسوم من جميع طلبات الإكمال التلقائي (جديد) وفقًا لوحدة حفظ المخزون: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لن يتم تحصيل أي رسوم مقابل هذه الطلبات.
-
طلب "تفاصيل المكان (جديد)" أو "التحقّق من صحة العنوان": يتم أيضًا تحصيل رسوم منك مقابل الطلب الذي تم إنهاؤه وفقًا لوحدة حفظ المخزون المناسبة:
- يتم تحصيل رسوم من طلبات إنهاء تفاصيل المكان (جديد) وفقًا لرمز التخزين التعريفي: Place Details Enterprise + Atmosphere، بغض النظر عن الحقول المطلوبة.
- يتم تحصيل رسوم مقابل طلبات إنهاء التحقّق من العنوان باستخدام رمز التخزين التعريفي: التحقّق من العنوان للمؤسسات.
سيناريوهات تسعير الجلسات
في ما يلي السيناريوهات الثلاثة الأكثر شيوعًا لتسعير الجلسات:
- الإكمال التلقائي لبيانات الموقع الجغرافي
- الإكمال التلقائي لاكتشاف الأماكن
- الإكمال التلقائي لعملية الدفع والتسليم
توضّح الأقسام التالية رسوم الفوترة الفردية لكل سيناريو.
الإكمال التلقائي لبيانات الموقع الجغرافي
في سيناريو "الإكمال التلقائي لبيانات الموقع الجغرافي"، يهمّك استخدام ميزة "الإكمال التلقائي (جديدة)" و"تفاصيل المكان (جديدة)" للحصول على معلومات الموقع الجغرافي لمكان معيّن. على سبيل المثال، يمكنك اختيار اقتراح من "الإكمال التلقائي" (جديد)، ثم استخدام "تفاصيل المكان" (جديد) للحصول على إحداثيات خطوط الطول والعرض الخاصة بالمكان لعرضه على الخريطة.
يمكن أن تتضمّن معلومات الموقع الجغرافي ما يلي:
- العنوان
- الموقع الجغرافي كإحداثيات خط العرض وخط الطول
- رمز Plus Codes
- الأنواع
- إطار العرض
يتم إنهاء هذه الجلسة بطلب واحد إلى Place Details (New) يطلب حقولاً محدّدة من خلال SKU: Place Details Essentials.
بعد ذلك، يتم تحصيل الرسوم منك على النحو التالي:
- يتم تحصيل رسوم أول 12 طلبًا من طلبات الإكمال التلقائي (جديد) وفقًا لرمز التخزين التعريفي: طلبات الإكمال التلقائي.
- يتم تحصيل رسوم عن أي طلبات متبقية من ميزة "الإكمال التلقائي (جديدة)" وفقًا لرمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لا يتم تحصيل رسوم عن هذه الطلبات.
- يتم تحصيل رسوم مقابل طلب إنهاء تفاصيل المكان (جديد) وفقًا لرمز التخزين التعريفي: أساسيات تفاصيل المكان في Places API.
الإكمال التلقائي لاقتراح أماكن
في سيناريو "الإكمال التلقائي" لاكتشاف الأماكن، يهمّك الحصول على أكثر من مجرد بيانات الموقع الجغرافي لمكان معيّن. على سبيل المثال، يمكنك طلب أي مما يلي:
- خيارات تسهيل الاستخدام
- ساعات العمل الحالية
- خيارات ركن السيارة
- المراجعات
- التقييمات
في هذا السيناريو، يتم إنهاء جلستك بطلب واحد إلى Place Details (New) يطلب أي حقول مضمّنة في رموز التخزين التعريفي Pro أو Enterprise أو Enterprise + Atmosphere في Place Details (New).
بعد ذلك، يتم تحصيل الرسوم منك على النحو التالي:
- يتم تحصيل رسوم مقابل جميع طلبات الإكمال التلقائي (الجديدة) وفقًا لوحدة حفظ المخزون: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لا يتم تحصيل أي رسوم مقابل هذه الطلبات.
- يتم تحصيل رسوم مقابل طلب إنهاء "تفاصيل المكان (جديد)" وفقًا لرمز التخزين التعريفي: Places API Place Details Enterprise + Atmosphere.
الإكمال التلقائي لعملية الدفع والتوصيل
Address Validation API هي خدمة تقبل عنوانًا. تحدّد هذه الخدمة مكوّنات العنوان وتتحقّق من صحتها. تعمل هذه الخدمة أيضًا على توحيد تنسيق العنوان المخصّص للمراسلة، وتحديد أفضل إحداثيات معروفة لخط الطول وخط العرض الخاصة به.
في سيناريو "الإكمال التلقائي لعملية الدفع والتسليم"، يمكنك إنهاء الجلسة بطلب إلى Address Validation API للتحقّق من صحة العنوان المحدّد.
بعد ذلك، يتم تحصيل الرسوم منك على النحو التالي:
- يتم تحصيل رسوم مقابل جميع طلبات الإكمال التلقائي (الجديدة) وفقًا لوحدة حفظ المخزون: استخدام جلسة الإكمال التلقائي، ما يعني أنّه لا يتم تحصيل أي رسوم مقابل هذه الطلبات.
- يتم تحصيل رسوم مقابل طلب اختياري لخدمة Place Details Essentials بدون أي تكلفة، إذا تم إرساله قبل طلب إنهاء خدمة Address Validation.
- يتم تحصيل رسوم طلب التحقّق من العنوان الذي تم إنهاؤه وفقًا لرمز التخزين التعريفي: Address Validation Enterprise.
الأسعار بدون جلسات
إذا كنت لا تستخدم الجلسات، سيتم تحصيل الرسوم منك مقابل كل طلب إلى ميزة "الإكمال التلقائي (جديدة)" باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
الأسعار للجلسات غير المكتملة أو التي تمّ التخلي عنها
في حال تم إيقاف الجلسة، أي لم يتم إنهاؤها من خلال طلب إلى Place Details (New) أو Address Validation، ستعود طلبات Autocomplete (New) إلى نموذج التسعير لكل طلب وسيتم تحصيل الرسوم وفقًا لرمز التخزين التعريفي: طلبات الإكمال التلقائي.