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