استخدام واجهة برمجة تطبيقات الأماكن والفوترة

لمحة عن أقنعة الحقول

بالنسبة إلى طلبات "تفاصيل الأماكن" (ميزة جديدة) و"البحث في الأماكن القريبة" (ميزة جديدة) و"البحث النصي" (ميزة جديدة)، استخدِم الرأس FieldMask في طلبات واجهة برمجة التطبيقات لتحديد قائمة الحقول التي سيتم عرضها في الاستجابة. ويتم بعد ذلك تحصيل الرسوم منك وفقًا لأعلى قيمة رقم تعريف المنتج السارية على طلبك. وهذا يعني أنّه في حال اختيار حقول في كلّ من رمز التخزين التعريفي Essentials ورمز التخزين التعريفي Pro، سيتمّ تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي Pro.

يُعدّ استخدام حجب الحقول ممارسة تصميم جيدة لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.

لمحة عن جلسات "الإكمال التلقائي (جديد)"

تتضمّن جلسة "الإكمال التلقائي (جديد)" طلبًا واحدًا أو أكثر من طلبات "الإكمال التلقائي (جديد)"، وأحد طلبَي "تفاصيل المكان (جديد)" أو "التحقّق من العنوان". يتم تمرير رمز الجلسة نفسه إلى طلب الإكمال التلقائي (جديد) وإلى طلب "تفاصيل المكان (جديد)" أو طلب إثبات صحة العنوان التالي.

تبدأ الجلسة بأول طلب من ميزة "الإكمال التلقائي (جديد)". بعد ذلك، يتم إرسال طلب "تفاصيل المكان (جديد)" أو طلب "إثبات صحة العنوان" عندما يختار المستخدم أحد اقتراحات "الإكمال التلقائي (جديد)". في حال إلغاء جلسة، أي عدم تقديم طلب "تفاصيل المكان (جديد)" أو طلب "التحقّق من العنوان"، يتم تحصيل رسوم طلبات "الإكمال التلقائي (جديد)" كما لو لم يتم تقديم رمز مميّز للجلسة.

بعد اختيار المستخدم مكانًا (أي تقديم طلب "تفاصيل المكان (جديد)" أو طلب "إثبات صحة العنوان")، عليك بدء جلسة جديدة باستخدام رمز ترويجي جديد للجلسة.

يُستخدم الرمز المميّز للجلسة لجلسة واحدة ولا يمكن استخدامه لأكثر من جلسة واحدة. في حال إعادة استخدام رمز مميّز للجلسة، تُعتبر الجلسة غير صالحة ويتم تحصيل رسوم الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.

تفاصيل رموز التخزين التعريفية وأسعارها لواجهة برمجة التطبيقات Places API

يعرض الجدول التالي تفاصيل رمز التخزين التعريفي (SKU) وأسعار واجهة برمجة التطبيقات Places API.

الفئةتفاصيل رمز التخزين التعريفي في Places API (الإصدار الجديد)أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: طلبات الإكمال التلقائي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: أساسيات تفاصيل المكان (المعرّفات فقط) قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: أساسيات تفاصيل الأماكن قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: أساسيات البحث النصي (المعرّفات فقط) قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: ميزة "البحث عن الأماكن القريبة" المدفوعة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Place Details Pro قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Text Search Pro قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Nearby Search Enterprise قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: ميزة "البحث عن الأماكن القريبة" في Enterprise Plus قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: تفاصيل المكان للمؤسسات قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: تفاصيل المكان في Enterprise + Atmosphere قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Text Search Enterprise قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Text Search Enterprise + Atmosphere قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: صور تفاصيل المكان قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
الفئةتفاصيل رموز التخزين التعريفية في Places API (الإصدار القديم)أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: الإكمال التلقائي - لكل طلب قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) - لكل جلسة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: البيانات الأساسية قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: العثور على مكان - رقم التعريف فقط قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: أساسيات تفاصيل الأماكن - إعادة تحميل رقم التعريف قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: الإكمال التلقائي لطلبات البحث - لكل طلب قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Find Place قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: الأماكن - البحث عن الأماكن المجاورة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: الأماكن - البحث النصي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Place Details Pro قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: بيانات الغلاف الجوي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: بيانات الاتصال قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: وضع الصور قائمة الأسعار الرئيسية
قائمة الأسعار في الهند

حدود الاستخدام الأخرى

لمراجعة الحصص وحدود الاستخدام وإدارتها، اطّلِع على الحصص والتحذيرات المتعلّقة بالحدود القصوى المسموح بها للحصص.

  • Places API (جديدة): الحدّ الأقصى للمعدل في الدقيقة هو لكل طريقة لواجهة برمجة التطبيقات لكل مشروع. وهذا يعني أنّ لكل طريقة من طرق واجهة برمجة التطبيقات حصة منفصلة.

  • Places API (الإصدار القديم): يتم احتساب الحدّ الأقصى للمعدل في الدقيقة على أنّه مجموع الطلبات من جهة العميل وخادم لجميع التطبيقات التي تستخدم بيانات اعتماد المشروع نفسه.

قيود بنود الاستخدام

للحصول على معلومات عن بنود الاستخدام، يُرجى الاطّلاع على سياسات Places API و قسم "قيود الترخيص" في بنود خدمة "منصّة خرائط Google".