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