استخدام واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" والفوترة

تذكير: لاستخدام واجهة برمجة تطبيقات JavaScript للخرائط، يجب تفعيل الفوترة لكلٍّ من مشروعاتك وتضمين مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز مع جميع طلبات واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK).

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

كيفية إصدار فواتير لواجهة برمجة تطبيقات JavaScript للخرائط

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

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

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

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

رمز التخزين التعريفي: الخرائط الديناميكية

تطبيق يعرض إما خريطة تم تحميلها مع معرّف الخريطة أو بدونه باستخدام واجهة برمجة تطبيقات JavaScript للخرائط، أو خريطة محمّلة برقم تعريف خريطة وتستخدم إما حزمة تطوير برامج "SDK للخرائط" لنظام التشغيل Android أو SDK للخرائط لنظام التشغيل iOS.

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

لا تؤدي تفاعلات المستخدمين مع الخريطة، مثل التحريك أو التكبير أو التصغير أو تبديل طبقات الخريطة، إلى إنشاء أحمال خريطة إضافية.

---

رمز التخزين التعريفي: التجوّل الافتراضي الديناميكي

يتم الآن شحن الصور البانورامية للتجوّل الافتراضي وتحميل الخريطة بشكل منفصل. يتم تحصيل رسوم بانوراما ديناميكية في ميزة "التجوّل الافتراضي" عن كل مثيل من كائن بانوراما في واجهة برمجة تطبيقات JavaScript للخرائط، أوحزمة تطوير برامج "خرائط Google" لأجهزة Android، أوتطبيق "SDK للخرائط" لنظام التشغيل iOS.

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

يحدث مثيل لكائن بانوراما:

• في JavaScript، باستخدام فئة google.maps.StreetViewPanorama() أو طريقة Map.getStreetView(). لن يتم تحصيل رسوم من تجربة "التجوّل الافتراضي" المُدمجة استنادًا إلى عنصر تحكُّم دليل "التجوُّل الافتراضي" أو استخدام فئة StreetViewService().
• على جهاز Android، مع أحد صفوف StreetViewPanoramaFragment أو SupportStreetViewPanoramaFragment أو StreetViewPanoramaView. ويتم احتساب صورة بانورامية في كل مرة يتم فيها استدعاء طريقة onCreate() ذات الصلة.
• على iOS، باستخدام الكائن GMSPanoramaView.

أسعار خدمات JavaScript

ويتم تسعير خدمات JavaScript بشكل منفصل. راجع صفحة استخدام الخدمة والفوترة للحصول على مزيد من المعلومات:

• خدمة الاتجاهات -- استخدام واجهة برمجة تطبيقات الاتجاهات والفوترة
• خدمة مصفوفة المسافات -- استخدام وفوترة واجهة برمجة التطبيقات لمصفوفة المسافات
• خدمة الارتفاع -- استخدام واجهة برمجة تطبيقات Elevation وفواتيرها
• خدمة الترميز الجغرافي -- استخدام وفوترة واجهة برمجة التطبيقات للترميز الجغرافي
• خدمة التجوّل الافتراضي -- استخدام وفوترة واجهة برمجة تطبيقات التجوّل الافتراضي
• مكتبة الأماكن -- استخدام واجهة برمجة تطبيقات الأماكن والفوترة

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

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

• 30000 طلب في الدقيقة.
• 300 طلب في الدقيقة لكل عنوان IP. في Google Cloud Console، يُشار إلى هذه الحصة باسم يتم تحميل الخريطة في الدقيقة لكل مستخدم.

نقطة رئيسية: قد تتضمّن المشاريع القديمة حصة قديمة وهي 60 QPM لكل عنوان IP. إذا أردت زيادة هذه القيمة إلى 300 QQ، يُرجى التواصل مع فريق الدعم وطلب زيادة الحصة.

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

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

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

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

ملاحظة: يمكنك ضبط حدود الحصة اليومية القابلة للفوترة على واجهات برمجة التطبيقات القابلة للفوترة فقط. في حال لم يكن مشروعك يستخدم أي واجهات برمجة تطبيقات قابلة للفوترة، لا يمكنك ضبط حدود يومية.

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

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

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

موارد إدارة التكاليف ذات الصلة

• الفوترة والأسعار في "منصة خرائط Google"
• إعداد التقارير والمراقبة في "منصة خرائط Google"

---

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