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

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

كيفية إصدار الفواتير من Directions API

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

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

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

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

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

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

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

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

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

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

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

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


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