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

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

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

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

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

الفئةتفاصيل رموز التخزين التعريفية في "خرائط Google"أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: الخرائط الديناميكية قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: صور "التجوّل الافتراضي" الثابتة قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro SKU: Elevation قائمة الأسعار العالمية
قائمة الأسعار في الهند
Pro رمز التخزين التعريفي: خرائط غامرة قائمة الأسعار العالمية
قائمة الأسعار في الهند
الفئةتفاصيل رمز التخزين التعريفي لـ Places Library وMaps JavaScript API (الجديدة)أسعار رموز التخزين التعريفية
Essentials رمز التخزين التعريفي: طلبات الإكمال التلقائي قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: الترميز الجغرافي قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials SKU: Place Details Essentials (IDs Only) قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials رمز التخزين التعريفي: أساسيات تفاصيل المكان قائمة الأسعار العالمية
قائمة الأسعار في الهند
Essentials SKU: أساسيات البحث النصي (المعرّفات فقط) قائمة الأسعار العالمية
قائمة الأسعار في الهند
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

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

رسوم إضافية:

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

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

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

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

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

رسوم إضافية:

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

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

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

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

SKU: Contact Data

رسوم إضافية:

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

Compute route matrix

  • يبلغ الحد الأقصى المسموح به 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".