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