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

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

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

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

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

الفئةتفاصيل رمز التخزين التعريفي في "خرائط Google"أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: "خرائط ديناميكية" قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: صور "التجوّل الافتراضي" الثابتة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: الارتفاع قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: خرائط غامرة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
الفئةتفاصيل رمز التخزين التعريفي الخاص بـ مكتبة الأماكن وMaps JavaScript API (الجديدة)أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: طلبات الإكمال التلقائي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: Autocomplete Session Usage قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: الترميز الجغرافي قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: Place Details Essentials (IDs Only) قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: أساسيات تفاصيل الأماكن قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: أساسيات البحث النصي (المعرّفات فقط) قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro SKU: Nearby Search Pro قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: تفاصيل المكان Pro قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro SKU: Text Search Pro قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: بحث في الجوار رزمة الشركات قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: تفاصيل المكان رزمة الشركات قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: تفاصيل المكان Enterprise + Atmosphere قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Text Search Enterprise قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Text Search Enterprise + Atmosphere قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise SKU: صور تفاصيل المكان قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
الفئةتفاصيل رمز التخزين التعريفي الخاص بـ مكتبة الأماكن في Maps JavaScript API (الإصدار القديم)أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: الإكمال التلقائي - لكل طلب قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) - لكل جلسة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials

رمز التخزين التعريفي: البيانات الأساسية

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: Find Place - ID only قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: Place Details Essentials- ID Refresh قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: ميزة "الإكمال التلقائي للبحث" - لكل طلب قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro

SKU: Find Place

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro

رمز التخزين التعريفي: أماكن - بحث في الجوار

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro

SKU: "أماكن" - البحث النصي

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Pro

SKU: تفاصيل الأماكن

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise

رمز التخزين التعريفي: بيانات الغلاف الجوي

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise

رمز التخزين التعريفي: بيانات الاتصال

الرسوم الإضافية:

قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Enterprise SKU: صور الأماكن قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
الفئةPlaces UI Kitأسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: طلب بحث في حزمة أدوات "خرائط Google" الجاهزة للأماكن قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: حزمة أدوات "خرائط Google" الجاهزة للأماكن للإكمال التلقائي لكل جلسة قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
الفئةتفاصيل رمز التخزين التعريفي لمكتبة المساراتأسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: المسارات: Compute Routes Essentials قائمة الأسعار الرئيسية
قائمة الأسعار في الهند
Essentials SKU: المسارات: أساسيات مصفوفة مسارات 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 SKU: Distance Matrix Advanced قائمة الأسعار الرئيسية
قائمة الأسعار في الهند

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

تحتوي الفئتان 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 وإدارتها، يُرجى الاطّلاع على الحصص وتنبيهات الحصص.

حصص تحميل الخريطة

تنطبق الحصص التالية على عمليات تحميل الخرائط الثنائية والثلاثية الأبعاد في Maps JavaScript API:

  • ‫30,000 عملية تحميل للخريطة في الدقيقة لكل مشروع
  • ‫300 عملية تحميل للخريطة في الدقيقة لكل عنوان IP

حدود استخدام حزمة أدوات "خرائط Google" الجاهزة للأماكن

تخضع حزمة أدوات "خرائط Google" الجاهزة للأماكن لحدود الاستخدام التالية:

  • طلب بحث في Places UI Kit: يقتصر عدد الطلبات من العنصرَين تفاصيل المكان والبحث عن مكان على 6,000 طلب بحث في الدقيقة لكل مشروع.

  • حزمة أدوات "خرائط Google" الجاهزة للأماكن: يقتصر عدد الطلبات من عنصر الإكمال التلقائي على 6,000 طلب في الدقيقة لكل مشروع.

لا تستهلك الطلبات الأساسية إلى Places API وGeocoding API حصة في مشروعك على السحابة الإلكترونية.

استراتيجيات فعّالة من حيث التكلفة لاستخدام Places API

يقدّم هذا القسم طرقًا لتحسين استخدامك وتقليل التكاليف المرتبطة بواجهة Places API.

استخدام أقنعة الحقول

يضمن استخدام إخفاء الحقول عدم طلب بيانات غير ضرورية، ما يساعد في تقليل وقت الاستجابة ورسوم الفوترة.

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

يتم بعد ذلك تحصيل رسوم منك وفقًا لأعلى رمز تخزين تعريفي ينطبق على طلبك. على سبيل المثال، إذا اخترت حقولاً من كلّ من رموز التخزين التعريفية Essentials وPro، سيتم تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي Pro.

استخدام تسعير الجلسة مع خدمة "تفاصيل المكان" (جديد)

إذا كانت تطبيقاتك تتضمّن عدد طلبات شهريًا يبلغ 100,001 إلى 500,000 أو أكثر، أو إذا أرسل المستخدمون أكثر من 12 طلب إكمال تلقائي في كل جلسة، تنصح Google باستخدام الجلسات مع ميزة "الإكمال التلقائي (جديد)". تساعد الجلسات في تبسيط الأسعار وتوفير نموذج تسعير متّسق لاستخدامه مع ميزة "الإكمال التلقائي (جديد)".

لمزيد من المعلومات، يُرجى الاطّلاع على الإكمال التلقائي (جديد) والأسعار حسب الجلسة.

تعديل الحصة

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

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

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

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

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

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

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

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