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