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

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

انقر على رمز المعلومات info للاطّلاع على جدول المحتويات لهذه الصفحة.

تنشئ طلبات Maps JavaScript API طلبات إلى رموز تخزين تعريفية مختلفة استنادًا إلى نوع الطلب، مثلاً، تؤدي عمليات تحميل الخرائط إلى تفعيل رمز التخزين التعريفي "الخرائط الديناميكية"، وتؤدي المشاهد البانورامية إلى تفعيل رمز التخزين التعريفي "التجوّل الافتراضي الديناميكي". يتم تحديد أسعار طلبات مكتبة الأماكن في Maps JavaScript API وخدمات JavaScript الأخرى بشكل منفصل. لمزيد من المعلومات، يُرجى الاطّلاع على تفاصيل رموز التخزين التعريفية وقوائم الأسعار في الجدول التالي.

تفاصيل رمز التخزين التعريفي والأسعار في Maps JavaScript API

يعرض الجدول التالي تفاصيل رمز التخزين التعريفي وأسعار Maps JavaScript API.

الفئة	تفاصيل رموز التخزين التعريفية في "خرائط Google"	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: "خرائط ديناميكية"	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: صور "التجوّل الافتراضي" الثابتة	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: الارتفاع	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: خرائط غامرة	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
الفئة	تفاصيل رمز التخزين التعريفي الخاص بـ Places Library وMaps JavaScript API (جديد)	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: طلبات الإكمال التلقائي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	SKU: Autocomplete Session Usage	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: الترميز الجغرافي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: Place Details Essentials (المعرّفات فقط)	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: أساسيات "تفاصيل المكان"	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	SKU: Text Search Essentials (IDs Only)	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	SKU: Nearby Search Pro	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Place Details Pro	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	SKU: Text Search Pro	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: Nearby Search Enterprise	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: Place Details Enterprise	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: Place Details Enterprise + Atmosphere	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: Text Search Enterprise	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: Text Search Enterprise + Atmosphere	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	SKU: صور تفاصيل المكان	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
الفئة	تفاصيل رمز التخزين التعريفي الخاص بـ Places Library وMaps JavaScript API (الإصدار القديم)	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: الإكمال التلقائي - لكل طلب	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) - لكل جلسة	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: البيانات الأساسية رسوم إضافية: SKU: تفاصيل الأماكن رمز التخزين التعريفي: Find Place SKU: "أماكن" - "البحث القريب" SKU: "الأماكن" - البحث النصي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	SKU: Find Place - ID only	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	SKU: Place Details Essentials- ID Refresh	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: ميزة "الإكمال التلقائي للبحث" - لكل طلب	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Find Place رسوم إضافية: رمز التخزين التعريفي: البيانات الأساسية رمز التخزين التعريفي: بيانات الاتصال رمز التخزين التعريفي: بيانات الغلاف الجوي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	SKU: "أماكن" - "البحث القريب" رسوم إضافية: رمز التخزين التعريفي: البيانات الأساسية رمز التخزين التعريفي: بيانات الاتصال رمز التخزين التعريفي: بيانات الغلاف الجوي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	SKU: "الأماكن" - البحث النصي رسوم إضافية: رمز التخزين التعريفي: البيانات الأساسية رمز التخزين التعريفي: بيانات الاتصال رمز التخزين التعريفي: بيانات الغلاف الجوي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	SKU: تفاصيل الأماكن رسوم إضافية: رمز التخزين التعريفي: البيانات الأساسية رمز التخزين التعريفي: بيانات الاتصال رمز التخزين التعريفي: بيانات الغلاف الجوي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: بيانات الغلاف الجوي رسوم إضافية: SKU: تفاصيل الأماكن رمز التخزين التعريفي: Find Place SKU: "أماكن" - "البحث القريب" SKU: "الأماكن" - البحث النصي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: بيانات الاتصال رسوم إضافية: SKU: تفاصيل الأماكن رمز التخزين التعريفي: Find Place SKU: "أماكن" - "البحث القريب" SKU: "الأماكن" - البحث النصي	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: صور الأماكن	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
الفئة	Places UI Kit	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: طلب بحث في حزمة أدوات Places UI Kit	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: Places UI Kit - الإكمال التلقائي لكل جلسة	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
الفئة	تفاصيل رمز التخزين التعريفي لمكتبة المسارات	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: المسارات: Compute Routes Essentials	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: المسارات: أساسيات مصفوفة مسارات Compute	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: المسارات: Compute Routes Pro	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: المسارات: Compute Route Matrix Pro	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: المسارات: Compute Routes Enterprise	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: المسارات: Compute Route Matrix Enterprise	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
الفئة	تفاصيل وحدة حفظ المخزون (SKU) الخاصة بـ Routes API (الإصدار القديم)	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: الاتجاهات	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: مصفوفة المسافات	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Directions Advanced	قائمة الأسعار الرئيسية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: "مصفوفة المسافة" المتقدّمة	قائمة الأسعار الرئيسية قائمة الأسعار في الهند

تفاصيل أسعار مكتبة المسارات

تحتوي الفئتان Route وRouteMatrix على ثلاثة رموز تخزين تعريفية تحدّد تكلفة الطلب. يعتمد رمز التخزين التعريفي (SKU) المستخدَم لتحديد التكلفة على الخدمة التي تستخدمها أو فئة Route أو فئة RouteMatrix، والميزات التي تستخدمها في الطلب. على سبيل المثال:

• يتم تحصيل رسوم مقابل طلبات حساب المسار لكل طلب.

• يتم تحصيل رسوم طلبات Compute route matrix لكل ELEMENT يتم إرجاعه من الطلب. عدد العناصر هو عدد المصادر مضروبًا في عدد الوجهات. على سبيل المثال، إذا كان الطلب يتضمّن مصدرَين وثلاث وجهات، سيتم تحصيل رسوم مقابل ستة عناصر.

تحدّد الميزات التي تستخدمها فئة رمز التخزين التعريفي التي يتم إصدار فواتيرها:

• Essentials: يتم تحصيل رسوم مقابل الطلبات التي تستخدم الميزات الأساسية فقط مع 10 نقاط توقّف وسيطة كحد أقصى.

• Pro: يتم تحصيل رسوم منك مقابل الطلبات التي تستخدم ميزة متقدّمة، مثل معدّلات التوجيه TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.

• Enterprise: يتم تحصيل رسوم مقابل الطلبات التي تستخدم ميزة Enterprise، مثل توجيه المركبات ذات العجلتين.

تتوفّر حدود الاستخدام التالية لرمز JavaScript.

حساب المسارات

• يبلغ الحدّ الأقصى لعدد طلبات البحث في الدقيقة 3,000 طلب.

• الحد الأقصى المسموح به لعدد نقاط المرور الوسيطة لكل طلب computeRoutes هو 25.

ComputeRouteMatrix

• يبلغ الحد الأقصى المسموح به 3,000 عنصر في الدقيقة، ويتم احتسابه من خلال ضرب عدد المصادر في عدد الوجهات.

• الحد الأقصى لعدد المصادر والوجهات التي يمكنك تحديدها باستخدام رقم تعريف مكان أو عنوان هو 50.

• الحدّ الأقصى لعدد العناصر المسموح به لكل طلب computeRouteMatrix مع ضبط routingPreference على TRAFFIC_AWARE_OPTIMAL هو 100.

• الحدّ الأقصى لعدد العناصر المسموح به لكل طلب computeRouteMatrix مع ضبط travelMode على TRANSIT هو 100.

• الحدّ الأقصى المسموح به لإجمالي عدد العناصر لكل طلب computeRouteMatrix هو 625.

الحصص وحدود الاستخدام

لمراجعة حصصك وحدود الاستخدام في Maps JavaScript API وإدارتها، يُرجى الاطّلاع على الحصص وتنبيهات الحصص.

تعديل الحصة

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

ملاحظة مهمة: للتعرّف على كيفية تأثير زيادة الحصة في فاتورتك، يمكنك الاطّلاع على حاسبة الأسعار.

لتعديل قيمة الحصة لواجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

1. في Cloud Console، انتقِل إلى Google Maps Platform > الحصص.
2. اختَر واجهة برمجة التطبيقات التي تريد تعديل الحصة فيها.
3. حدِّد قيمة الحصة التي تريد تغييرها، ثم ضَع علامة في مربّع الاختيار بجانبها.
4. انقر على تعديل، وأدخِل قيمة حصة جديدة، ثم انقر على إرسال الطلب.

عرض طلبات زيادة الحصة

ملاحظة مهمة: يجب أن يكون لديك أذونات إدارة الهوية وإمكانية الوصول المناسبة لعرض طلبات زيادة الحصة.

للاطّلاع على جميع طلبات زيادة الحصة، بما في ذلك الطلبات السابقة والمعلّقة، اتّبِع الخطوات التالية:

1. في Cloud Console، انتقِل إلى Google Maps Platform > الحصص.
2. اختَر واجهة برمجة التطبيقات التي تريد الاطّلاع على طلب زيادة الحصة لها.
3. انقر على زيادة الطلبات.

ملاحظة: احرص على مراقبة استخدامك للحصة بانتظام لتجنُّب انقطاع الخدمة. مزيد من المعلومات حول الحصص وتنبيهات الحصص

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

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

---