انقر على رمز المعلومات info للاطّلاع على جدول محتويات هذه الصفحة.
لمحة عن جلسات "الإكمال التلقائي (جديد)"
تتضمّن جلسة "الإكمال التلقائي (جديد)" طلبًا واحدًا أو أكثر من طلبات "الإكمال التلقائي (جديد)"، وطلبًا من طلبات "تفاصيل المكان (جديد)" أو طلب "Address Validation". يتم تمرير الرمز المميز للجلسة نفسه إلى طلب الإكمال التلقائي (جديد) وإلى طلب تفاصيل المكان (جديد) اللاحق أو طلب Address Validation.
تبدأ الجلسة بطلب "الإكمال التلقائي (جديد)" الأول. بعد ذلك، يتم إرسال طلب تفاصيل المكان (جديد) أو طلب Address Validation عندما يختار المستخدم أحد الاقتراحات من ميزة "الإكمال التلقائي" (جديدة). في حال تم إيقاف الجلسة، أي لم يتم إرسال طلب "تفاصيل المكان (جديد)" أو طلب "Address Validation"، يتم تحصيل رسوم من طلبات "الإكمال التلقائي (جديد)" كما لو لم يتم تقديم الرمز المميز للجلسة.
بعد أن يختار المستخدم مكانًا (أي يتم تقديم طلب "تفاصيل المكان (جديد)" أو طلب "التحقّق من صحة العنوان")، عليك بدء جلسة جديدة باستخدام رمز مميّز جديد للجلسة.
الرمز المميز للجلسة صالح لجلسة واحدة ولا يمكن استخدامه لأكثر من جلسة واحدة. في حال إعادة استخدام رمز مميّز للجلسة، تُعدّ الجلسة غير صالحة ويتم تحصيل رسوم مقابل الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.
تفاصيل رمز التخزين التعريفي والأسعار الخاصة بحزمة تطوير البرامج Places SDK for Android
يعرض الجدول التالي تفاصيل رمز التخزين التعريفي (SKU) ونظام الدفع حسب الاستخدام لحزمة تطوير البرامج Places SDK for Android.
سقف الاستخدام
لمراجعة الحصص وسقوف الاستخدام وإدارتها، يُرجى الاطّلاع على الحصص وتنبيهات الحصص.
تعتمد حصة طرق Places SDK for Android (الجديدة) على Places API (الجديدة)، وتعتمد حصة طرق Places SDK for Android على Places API (الإصدار القديم).
- Places API (جديدة): الحدّ الأقصى هو لكل طريقة API لكل مشروع. وهذا يعني أنّ لكل طريقة في واجهة برمجة التطبيقات حصة منفصلة.
- Places API (الإصدار القديم): هناك حدّ واحد فقط، وهو ينطبق على مجموع جميع طرق واجهة برمجة التطبيقات.
استراتيجيات فعّالة من حيث التكلفة لاستخدام Places API
يقدّم هذا القسم طرقًا لتحسين استخدامك وتقليل التكاليف المرتبطة بواجهة Places API.
استخدام أقنعة الحقول
يضمن استخدام إخفاء الحقول عدم طلب بيانات غير ضرورية، ما يساعد في تقليل وقت الاستجابة ورسوم الفوترة.
بالنسبة إلى طلبات تفاصيل المكان (جديد) وبحث في الجوار (جديد) والبحث النصي (جديد)، استخدِم قناع الحقل لتحديد قائمة الحقول المطلوب عرضها في الردّ.
يتم بعد ذلك تحصيل الرسوم منك وفقًا لأعلى رمز تخزين تعريفي ينطبق على طلبك. على سبيل المثال، إذا اخترت حقولاً من كلّ من رمز التخزين التعريفي Essentials ورمز التخزين التعريفي Pro، سيتم تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي Pro.
استخدام تسعير الجلسة مع خدمة "تفاصيل المكان" (جديد)
إذا كان لتطبيقاتك عدد طلبات بحث شهري يتراوح بين
لمزيد من المعلومات، يُرجى الاطّلاع على الإكمال التلقائي (جديد) وتسعير الجلسات.
تعديل الحصة
تحدّد حدود الحصة الحد الأقصى لعدد الطلبات المسموح بها لواجهة برمجة تطبيقات أو خدمة معيّنة خلال إطار زمني محدّد. عندما يصل عدد الطلبات في مشروعك إلى الحد الأقصى للحصة، تتوقف خدمتك عن الاستجابة للطلبات.
لتعديل قيمة حصة API، اتّبِع الخطوات التالية:
- في Cloud Console، انتقِل إلى منصة خرائط Google > الحصص.
- اختَر واجهة برمجة التطبيقات التي تريد تعديل الحصة فيها.
- حدِّد قيمة الحصة التي تريد تغييرها، ثم ضَع علامة في مربّع الاختيار بجانبها.
- انقر على تعديل، وأدخِل قيمة حصة جديدة، ثم انقر على إرسال الطلب.
عرض طلبات زيادة الحصة
للاطّلاع على جميع طلبات زيادة الحصة، بما في ذلك الطلبات السابقة والمعلّقة، اتّبِع الخطوات التالية:
- في Cloud Console، انتقِل إلى منصة خرائط Google > الحصص.
- اختَر واجهة برمجة التطبيقات التي تريد الاطّلاع على طلب زيادة الحصة لها.
- انقر على زيادة الطلبات.
قيود بنود الاستخدام
للحصول على معلومات حول بنود الاستخدام، يُرجى الاطّلاع على قسم قيود الترخيص في بنود خدمة "منصة خرائط Google".