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