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