استخدام واجهة برمجة التطبيقات للتحقق من صحة العنوان والفوترة

تستخدم واجهة برمجة تطبيقات التحقّق من صحة العناوين نموذج أسعار الدفع حسب الاستخدام. بالإضافة إلى "بنود استخدام Google" العامة، هناك حدود استخدام خاصة بواجهة برمجة تطبيقات التحقّق من صحة العناوين. يمكنك إدارة التكاليف والاستخدام من خلال الأدوات المتاحة في Google Cloud Console.

كيفية فوترة واجهة برمجة تطبيقات التحقّق من صحة العناوين

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

استخدام رمز التخزين التعريفي × السعر لكل استخدام

استخدِم حاسبة الأسعار والاستخدام لتقدير تكلفة الاستخدام لكل واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK). بالنسبة إلى رموز التخزين التعريفية المؤهلة في "منصة خرائط Google"، يتوفر رصيد بقيمة 200 دولار أمريكي (أو ما يعادله بالعملة المحلية) على "منصة خرائط Google" كل شهر لكل حساب فوترة. يتم تطبيق هذا الرصيد تلقائيًا 1 على رموز التخزين التعريفية المؤهَّلة.

تحديد أسعار واجهة برمجة تطبيقات التحقّق من صحة العنوان

رمز التخزين التعريفي: التحقق من العنوان

طلب إلى طريقة validateAddress (REST) وطريقة ValidateAddress (gRPC) في واجهة برمجة التطبيقات للتحقّق من صحة العنوان.

النطاق الزمني الشهري
(السعر لكل طلب)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.017 دولار أمريكي لكل
(17.00 دولار أمريكي لكل 1000)
0.0136 دولار أمريكي لكل
(13.60 دولار أمريكي لكل 1000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد.

رمز التخزين التعريفي: يُفضَّل التحقق من صحة العنوان

تعمل ميزة "الخيار المفضّل للتحقّق من العنوان" مع نقطة نهاية الإكمال التلقائي (جديد) في واجهة برمجة التطبيقات Places API عند استخدامها مع الجلسات التي تنتهي باستدعاء واجهة برمجة التطبيقات التحقّق من صحة العنوان. على وجه التحديد، تندرج الجلسات التي تستخدم الإكمال التلقائي (جديد) وتنتهي إما بطلب validateAddress (REST) أو ValidateAddress (gRPC) ضمن نموذج التسعير هذا.

للحصول على تفاصيل حول التسعير واستخدام جلسات الإكمال التلقائي (الجديدة) مع Places API، راجع الأدلة التالية في مستندات Places API:

عند استخدام "الخيار المفضّل للتحقق من العنوان" في نهاية جلسة الإكمال التلقائي (الجديدة)، سيتم تحصيل الرسوم منك على النحو التالي:

النطاق الزمني الشهري
(السعر لكل طلب)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.025 دولار أمريكي لكل
(25.00 دولار أمريكي لكل 1000)
0.020 دولار أمريكي لكل
(20.00 دولار أمريكي لكل 1,000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد.

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

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

  • الحد الأقصى لطلبات البحث في الدقيقة: 6,000

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

للحصول على التفاصيل الكاملة حول الاستخدام المسموح به، يمكنك الرجوع إلى قسم "قيود الترخيص" في "بنود خدمة منصة خرائط Google".

إدارة تكلفة الاستخدام

لإدارة تكاليف استخدامك لواجهة برمجة التطبيقات Address Verification API أو لتلبية متطلبات زيارات الإنتاج، يمكنك ضبط حدود للحصة اليومية على جميع الطلبات الواردة إلى أي واجهة برمجة تطبيقات. تتم إعادة تعيين الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.

للاطّلاع على حدود الحصص المسموح بها أو تغييرها لواجهة برمجة التطبيقات Address Verification API، اتّبِع الخطوات التالية:

  1. في Cloud Console، افتح صفحة حصص الحصص في "منصة خرائط Google".
  2. انقر على القائمة المنسدلة لواجهات برمجة التطبيقات وحدِّد واجهة برمجة تطبيقات التحقُّق من صحة العناوين.
  3. للاطّلاع على حدود الحصة، انتقِل للأسفل وصولاً إلى بطاقة الطلبات.
    جدول يسرد أسماء الحصص وحدودها.
  4. لتغيير حد حصة معيّنة، انقر على رمز التعديل لهذا الحدّ.
    في مربّع الحوار الذي يظهر، في الحقل حدّ الحصّة المسموح بها، أدخِل الحدّ الأقصى للحصّة اليومية القابلة للفوترة (حتى حدّ الحصّة التي تحدّدها Google، في حال توفّرها) واختَر حفظ.

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


  1. على المستخدمين في الهند إنشاء حساب فوترة على Google Cloud Platform قبل إنشاء حساب فوترة على "منصة خرائط Google" لتلقّي رصيد "منصة خرائط Google".