يمكنك تجربة الجيل التالي من ميزات الاتجاهات باستخدام Routes API التي أصبحت متوفّرة الآن في المعاينة.

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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

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

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

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

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

  • معلومات عن حركة المرور: تُستخدم معلومات حركة المرور عندما تنطبق جميع الشروط التالية (هذه هي الشروط المطلوبة لتلقّي الحقل 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

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

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

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

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

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

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

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

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

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


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