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