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

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

كيفية فوترة واجهة برمجة التطبيقات Directions API

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

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

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

التسعير في Directions API

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

طلب مُرسَل إلى خدمة الاتجاهات في Maps JavaScript API (باستثناء الطلبات التي تؤدي إلى رمز التخزين التعريفي للفوترة للتوجيه المتقدّم) أو Directions API.

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

رمز التخزين التعريفي: الإعدادات المتقدمة

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

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

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

  • معلومات عن حركة المرور: يتم استخدام معلومات حركة المرور عندما تنطبق جميع الشروط التالية (هذه هي الشروط المطلوبة لتلقّي حقل duration_in_traffic في استجابة الاتجاهات):
    • معلمة السفر mode هي driving، أو لم يتم تحديدها (driving هو وضع السفر التلقائي).
    • يتضمّن الطلب مَعلمة 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. انقر على القائمة المنسدلة لواجهات برمجة التطبيقات وحدد واجهة برمجة التطبيقات للاتجاهات.
  3. للاطّلاع على حدود الحصص، انتقِل للأسفل وصولاً إلى بطاقة الطلبات.
    يسرد جدول أسماء الحصص وحدودها.
  4. لتغيير الحدّ الأقصى للحصة، انقر على رمز تعديل لهذا الحدّ.
    في مربّع الحوار الذي يظهر، في حقل الحدّ الأقصى للحصة، أدخِل الحدّ المفضّل للحصة اليومية القابلة للفوترة (ما يصل إلى الحدّ الأقصى للحصة المحدّدة من قِبل Google، إن توفّر) ثم انقر على حفظ.

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