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

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

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

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

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

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

SKU: Basic Data

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

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

رمز التخزين التعريفي: العثور على مكان

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

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

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

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

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

رمز التخزين التعريفي: Places - Text Search

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

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

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

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

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

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

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

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

SKU: Contact Data

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

قائمة الأسعار العالمية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: صور الأماكن قائمة الأسعار العالمية
قائمة الأسعار في الهند
الفئةPlaces UI Kitأسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: طلب البحث في حزمة أدوات "خرائط Google" الجاهزة للأماكن قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: حزمة أدوات "خرائط Google" الجاهزة للأماكن - الإكمال التلقائي لكل جلسة قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: حزمة أدوات "خرائط Google" الجاهزة للأماكن (متقدّمة) قائمة الأسعار العالمية
قائمة الأسعار في الهند
الفئةتفاصيل رمز التخزين التعريفي لمكتبة المساراتأسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: Routes: Compute Routes Essentials قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: المسارات: أساسيات مصفوفة حساب المسار قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: المسارات: Compute Routes Pro قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Routes: Compute Route Matrix Pro قائمة الأسعار العالمية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Routes: Compute Routes Enterprise قائمة الأسعار العالمية
قائمة الأسعار في الهند
Enterprise رمز التخزين التعريفي: Routes: Compute Route Matrix Enterprise قائمة الأسعار العالمية
قائمة الأسعار في الهند
الفئةتفاصيل رمز التخزين التعريفي لواجهة برمجة التطبيقات Routes API (القديمة)أسعار رموز التخزين التعريفية
Essentials SKU: Directions قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: Distance Matrix قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Directions Advanced قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: Distance Matrix Advanced قائمة الأسعار العالمية
قائمة الأسعار في الهند

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

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

  • تتم فوترة طلبات احتساب المسار لكل طلب.

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

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

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

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

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

تنطبق حدود الاستخدام التالية على JavaScript.

Compute routes

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

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

احتساب مصفوفة المسارات

  • الحد الأقصى المسموح به هو 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" الجاهزة للأماكن لحدود الاستخدام التالية:

  • طلبات البحث في حزمة أدوات "خرائط Google" الجاهزة للأماكن: الطلبات من عناصر تفاصيل المكان والبحث عن الأماكن تقتصر على 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".