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