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

تستخدِم واجهة برمجة التطبيقات Directions API نموذج تسعير "الدفع حسب الاستخدام". تُنشئ طلبات البيانات من واجهة برمجة التطبيقات Directions API طلبات إلى أحد رمزَي التخزين التعريفيَين استنادًا إلى نوع الطلب: أساسي أو متقدّم. بالإضافة إلى بنود استخدام Google العامة، هناك حدود للاستخدام خاصة لواجهة برمجة التطبيقات Directions API. إدارة التكاليف ومستوى الاستخدام باستخدام الأدوات المتاحة في Google Cloud Console

طريقة فوترة Directions API

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

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

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

أسعار واجهة برمجة التطبيقات Directions API

رمز التخزين التعريفي: الاتجاهات

طلب موجَّه إلى "خدمة الاتجاهات" في واجهة برمجة التطبيقات JavaScript لخرائط Google (يستبعد الطلبات التي تؤدي إلى تنشيط رمز التخزين التعريفي للفوترة Directions Advanced) أو واجهة برمجة التطبيقات Directions API

نطاق الحجم الشهري
(السعر لكل طلب بحث)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: مسار الاتجاهات المتقدّم

طلب موجَّه إلى خدمة "الاتجاهات" في واجهة برمجة التطبيقات JavaScript API لخرائط Google أو Directions API يستخدم معلومات عدد الزيارات وأكثر من 10 نقاط طريق و/أو تحسين نقاط الطريق و/أو عوامل تعديل الموقع الجغرافي

نطاق الحجم الشهري
(السعر لكل طلب بحث)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.008 دولار أمريكي لكل
(8.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم لميزة "الاتجاهات" مقابل طلبات Directions Service من واجهة برمجة التطبيقات JavaScript لخرائط Google أو Directions API التي تستخدم واحدًا أو أكثر مما يلي:

  • معلومات عن عدد الزيارات: يتم استخدام معلومات حركة المرور عند استيفاء جميع الشروط التالية (هذه هي الشروط المطلوبة لتلقّي الحقل duration_in_traffic في ردّ "الاتجاهات"):
    • قيمة مَعلمة travel mode هي driving أو لم يتم تحديدها (driving هي وضع السفر التلقائي).
    • يتضمّن الطلب معلَمة válida departure_time. يمكن ضبط departure_time على الوقت الحالي أو وقت في المستقبل. لا يمكن أن يكون في الماضي.
    • لا يتضمّن الطلب نقاط توقف نقاط الطريق. إذا كان الطلب يتضمّن نقاط طريق، أضِف البادئة via: إلى كل نقطة طريق للتأثير في المسار ولكن تجنَّب التوقفات. على سبيل المثال، 
      &waypoints=via:San Francisco|via:Mountain View|...
  • أكثر من 10 نقاط طريق (بين 11 و25)
  • تحسين نقاط التوقف يتم ضبط المَعلمة optimize على true لنقاط التوقف. على سبيل المثال، 
    &waypoints=optimize:true|San Francisco|Mountain View|...
  • معدّلات المواقع الجغرافية: عند استخدام مُعدِّلات الموقع الجغرافي التالية للإشارة إلى كيفية اقتراب السائقين من موقع جغرافي معيّن:
    • side_of_road
    • heading

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

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

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

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

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

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

لعرض حدود الحصص أو تغييرها لواجهة برمجة التطبيقات Directions API:

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

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