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

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

كيفية تحصيل رسوم Distance Matrix API

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

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

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

أسعار Distance Matrix API

رمز التخزين التعريفي: Distance Matrix

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

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

يُنشئ كل طلب بحث يتم إرساله إلى Distance Matrix API عناصر، حيث يكون عدد origins مضروبًا في عدد destinations يساوي عدد العناصر.

رمز التخزين التعريفي: Distance Matrix Advanced

طلب موجَّه إلى Distance Matrix API أو خدمة Distance Matrix في Maps JavaScript API التي تستخدِم معلومات حركة المرور و/أو عوامل تعديل الموقع الجغرافي

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

يُنشئ كل طلب بحث يتم إرساله إلى Distance Matrix API عناصر، حيث يساوي عدد origins مضروبًا في عدد destinations عدد العناصر.

يتم تحصيل رسوم SKU "Distance Matrix Advanced" مقابل Distance Matrix API أو Distance Matrix Service من Maps JavaScript API التي تستخدم واحدًا أو أكثر مما يلي:

  • معلومات عن عدد الزيارات: تُستخدَم معلومات حركة المرور عند استيفاء جميع الشروط التالية (هذه هي الشروط المطلوبة لتلقّي الحقل duration_in_traffic في استجابة "مصفوفة المسافات"):
    • قيمة مَعلمة travel mode هي driving أو لم يتم تحديدها (driving هي وضع السفر التلقائي).
    • يتضمّن الطلب مَعلمة departure_time صالحة. يمكن ضبط departure_time على الوقت الحالي أو وقت في المستقبل. لا يمكن أن يكون في الماضي.
  • معدّلات المواقع الجغرافية: عند استخدام مُعدِّلات الموقع الجغرافي التالية للإشارة إلى كيفية اقتراب السائقين من موقع جغرافي معيّن:
    • side_of_road
    • heading

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

على الرغم من عدم وجود حد أقصى لعدد العناصر في اليوم (EPD)، تم وضع حدود استخدام التالية لـ Distance Matrix API:

  • 25 نقطة منشأ أو 25 وجهة كحد أقصى لكل طلب
  • ‫100 عنصر كحد أقصى لكل طلب من جانب الخادم
  • 100 عنصر كحد أقصى لكل طلب من جهة العميل
  • ‫60,000 عنصر في الدقيقة (EPM)، يتم احتسابها على أنّها مجموع طلبات البحث من جهة العميل وطلبات البحث من جهة الخادم

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

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

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

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

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

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

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