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

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

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

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

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

الفئة	تفاصيل رموز التخزين التعريفية في "خرائط Google"	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: الخرائط الديناميكية	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: صور "التجوّل الافتراضي" الثابتة	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	SKU: Elevation	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: الخرائط الغامرة	قائمة الأسعار العالمية قائمة الأسعار في الهند
الفئة	تفاصيل رمز التخزين التعريفي لمكتبة الأماكن في 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 الرسوم الإضافية: رمز التخزين التعريفي: تفاصيل الأماكن رمز التخزين التعريفي: العثور على مكان رمز التخزين التعريفي: Places - بحث في الجوار رمز التخزين التعريفي: Places - Text Search	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: Find Place - ID only	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	SKU: Place Details Essentials- ID Refresh	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: ميزة "الإكمال التلقائي للبحث" - لكل طلب	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: العثور على مكان الرسوم الإضافية: SKU: Basic Data SKU: Contact Data SKU: Atmosphere Data	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Places - بحث في الجوار الرسوم الإضافية: SKU: Basic Data SKU: Contact Data SKU: Atmosphere Data	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Places - Text Search الرسوم الإضافية: SKU: Basic Data SKU: Contact Data SKU: Atmosphere Data	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: تفاصيل الأماكن الرسوم الإضافية: SKU: Basic Data SKU: Contact Data SKU: Atmosphere Data	قائمة الأسعار العالمية قائمة الأسعار في الهند
Enterprise	SKU: Atmosphere Data الرسوم الإضافية: رمز التخزين التعريفي: تفاصيل الأماكن رمز التخزين التعريفي: العثور على مكان رمز التخزين التعريفي: Places - بحث في الجوار رمز التخزين التعريفي: Places - Text Search	قائمة الأسعار العالمية قائمة الأسعار في الهند
Enterprise	SKU: Contact Data الرسوم الإضافية: رمز التخزين التعريفي: تفاصيل الأماكن رمز التخزين التعريفي: العثور على مكان رمز التخزين التعريفي: Places - بحث في الجوار رمز التخزين التعريفي: Places - Text Search	قائمة الأسعار العالمية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: صور الأماكن	قائمة الأسعار العالمية قائمة الأسعار في الهند
الفئة	Places UI Kit	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: طلب البحث في حزمة أدوات "خرائط Google" الجاهزة للأماكن	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: حزمة أدوات "خرائط Google" الجاهزة للأماكن - الإكمال التلقائي لكل جلسة	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: حزمة أدوات "خرائط Google" الجاهزة للأماكن (متقدّمة)	قائمة الأسعار العالمية قائمة الأسعار في الهند
الفئة	تفاصيل رموز التخزين التعريفية في Routes Library	أسعار رموز التخزين التعريفية
Essentials	رمز التخزين التعريفي: Routes: Compute Routes Essentials	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: Routes: Compute مصفوفة المسارات Essentials	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Routes: Compute Routes Pro	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Routes: Compute Route Matrix Pro	قائمة الأسعار العالمية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: المسارات: Compute Routes Enterprise	قائمة الأسعار العالمية قائمة الأسعار في الهند
Enterprise	رمز التخزين التعريفي: Routes: Compute Route Matrix Enterprise	قائمة الأسعار العالمية قائمة الأسعار في الهند
الفئة	تفاصيل رمز التخزين التعريفي لواجهة برمجة التطبيقات Routes API (القديمة)	أسعار رموز التخزين التعريفية
Essentials	SKU: Directions	قائمة الأسعار العالمية قائمة الأسعار في الهند
Essentials	رمز التخزين التعريفي: Distance Matrix	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Directions Advanced	قائمة الأسعار العالمية قائمة الأسعار في الهند
Pro	رمز التخزين التعريفي: Distance Matrix Advanced	قائمة الأسعار العالمية قائمة الأسعار في الهند

تفاصيل أسعار Routes Library

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

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

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

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

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

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

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

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

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

• يبلغ الحدّ الأقصى لمعدّل الطلبات 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، انتقِل إلى منصة خرائط Google > الحصص.
2. اختَر واجهة برمجة التطبيقات التي تريد تعديل الحصة لها.
3. حدِّد قيمة الحصة التي تريد تغييرها، واختَرها باستخدام مربّع الاختيار.
4. انقر على تعديل، وأدخِل قيمة جديدة للحصة، ثم انقر على إرسال الطلب.

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

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

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

القيود المفروضة على بنود الاستخدام

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