استخدام واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" والفوترة

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

تستخدم واجهة برمجة تطبيقات JavaScript للخرائط نموذج تسعير "الدفع حسب الاستخدام". تنشئ طلبات واجهة برمجة التطبيقات لتطبيق "خرائط Google" طلبات إلى رمزَي تخزين تعريفيَّين مختلفَين استنادًا إلى نوع الطلب: عمليات تحميل الخريطة أو صور بانورامية. يتم تسعير الطلبات الموجَّهة إلى مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط وخدمات JavaScript الأخرى بشكل منفصل عن رموز التخزين التعريفية الأصلية بلغة JavaScript. إلى جانب بنود استخدام Google العامة، هناك حدود استخدام خاصة بواجهة برمجة تطبيقات JavaScript للخرائط. يمكنك إدارة التكاليف والاستخدام باستخدام الأدوات المتاحة في Google Cloud Console.

كيفية فوترة واجهة برمجة تطبيقات JavaScript للخرائط

تستخدم واجهة برمجة تطبيقات JavaScript للخرائط نموذج تسعير "الدفع حسب الاستخدام". يتم تحصيل فواتير واجهات برمجة التطبيقات وحزم تطوير البرامج (SDK) في منصة خرائط Google بواسطة رمز التخزين التعريفي. ويتم تتبُّع الاستخدام لكل رمز تخزين تعريفي، وقد يتضمّن أيّ واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) أكثر من رمز تخزين تعريفي للمنتج. يتم حساب التكلفة على

استخدام رمز التخزين التعريفي × السعر لكل استخدام

استخدِم حاسبة الأسعار والاستخدام لتقدير تكلفة الاستخدام لكل واجهة برمجة تطبيقات أو حزمة SDK. بالنسبة إلى رموز التخزين التعريفية في "منصة خرائط Google" المؤهَّلة، يتوفّر رصيد في "منصة خرائط Google" بقيمة 200 دولار أمريكي شهريًا لكل حساب فوترة. يتم تطبيق هذا الرصيد تلقائيًا على رموز التخزين التعريفية المؤهّلة.

التسعير لواجهة برمجة تطبيقات JavaScript للخرائط

رمز التخزين التعريفي: الخرائط الديناميكية

تطبيق يعرض خريطة محمّلة مع رقم تعريف خريطة أو بدونه باستخدام Maps JavaScript API، أو خريطة محمّلة برقم تعريف الخريطة وتستخدم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) للخرائط لأجهزة iOS

نطاق الحجم الشهري (السعر لكل تحميل خريطة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000)	0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

لا تؤدي تفاعلات المستخدمين مع الخريطة، مثل العرض الشامل أو التكبير أو التصغير أو تبديل طبقات الخريطة، إلى إنشاء أحمال إضافية للخريطة.

---

رمز التخزين التعريفي: التجوّل الافتراضي الديناميكي

يتم الآن تحصيل رسوم صور "التجوّل الافتراضي" البانورامية وتحميلات الخريطة بشكل منفصل. يتم تحصيل رسوم صورة بانوراما ديناميكية في "التجوّل الافتراضي" مقابل كل إنشاء مثيل لكائن بانوراما في Maps JavaScript API وMaps SDK لأجهزة Android وحزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل iOS.

النطاق الشهري (السعر لكل PANORAMA)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.014 دولار أمريكي لكل (14.00 دولار أمريكي لكل 1,000)	0.0112 دولار أمريكي لكل (11.20 دولار أمريكي لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

يحدث مثيل لكائن بانوراما:

• في JavaScript باستخدام الفئة google.maps.StreetViewPanorama() أو طريقة Map.getStreetView(). ولا يتم تحصيل الرسوم من خلال تجربة "التجوّل الافتراضي" المدمجة استنادًا إلى عنصر تحكّم الدليل في "التجوّل الافتراضي" أو استخدام فئة StreetViewService().
• على Android مع أحد صفوف StreetViewPanoramaFragment أو SupportStreetViewPanoramaFragment أو StreetViewPanoramaView. يتم احتساب صورة بانوراما في كل مرة يتم فيها استدعاء طريقة onCreate() ذات الصلة.
• على iOS، باستخدام الكائن GMSPanoramaView.

أسعار مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط

رمز التخزين التعريفي: طلبات الإكمال التلقائي

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

ويتمّ تحصيل الرسوم أيضًا في حال استخدام رموز مميّزة للجلسة وإحدى الطريقتَين أدناه:

• عليك إنهاء الجلسات بطلب واحد للوصول إلى تفاصيل المكان (جديد) الذي يطلب أي حقول محدّدة في رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
  • يتم تحصيل فواتير كل طلب إكمال تلقائي (جديد)، وما يصل إلى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
  • تتم فوترة كل طلب لاحق للإكمال التلقائي (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
  ملاحظة: في حال إجراء مكالمة مع رمز التخزين التعريفي: التحقُّق من العنوان المفضَّل قبل انتهاء صلاحية الرمز المميّز للجلسة، لن يتم تحصيل رسوم مكالمة رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط) وسيتم تحصيل رسوم جلستك استنادًا إلى رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
• عليك تجاهل الجلسة أو إنهاؤها من خلال إجراء استدعاء رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط). وبعد ذلك، تتم فوترة جميع طلبات الإكمال التلقائي (الجديدة) باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000)	0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي

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

يتم تحصيل رسوم رمز التخزين التعريفي هذا في الحالات التالية:

• تم إنهاء جلسة الإكمال التلقائي من خلال مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط):

  • يتم تحصيل فواتير كل طلب إكمال تلقائي (جديد)، وما يصل إلى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
  • تتم فوترة كل طلب لاحق للإكمال التلقائي (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.

• تم إنهاء جلسة الإكمال التلقائي بالاتصال بـ رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة).

  عند طلب استدعاء "تفاصيل مكان" أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل الرسوم على أساس رمز التخزين التعريفي: تفاصيل المكان (المفضّل).

• تم إنهاء جلسة الإكمال التلقائي باستدعاء رمز التخزين التعريفي: التحقق من صحة العنوان المفضَّل.

  ملاحظة: إذا أجريت مكالمة مع رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط) ثم اتصلت بـ رمز التخزين التعريفي: إثبات صحة العنوان المفضَّل قبل انتهاء صلاحية الرمز المميّز للجلسة، لن يتم تحصيل رسوم الاتصال رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط) وسيتم تحصيل فواتير جلستك مقابل المكالمة إلى رمز التخزين التعريفي: إثبات صحة العنوان المفضّل.

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)

---

رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لتفاصيل المكان (الموقع الجغرافي فقط)، سيتم تحصيل الرسوم منك بذلك السعر. في حال اختيار أيّ حقول من رمز التخزين التعريفي لتفاصيل المكان (الأساسي)، سيتم تحصيل الرسوم منك بهذا السعر. في حال اختيار أيّ حقول من رمز التخزين التعريفي الخاص بتفاصيل المكان (الإعدادات المتقدّمة)، سيتم تحصيل الرسوم منك بهذا السعر. في حال اختيار أيّ حقول من رمز التخزين التعريفي الخاص بـ "تفاصيل المكان" (المفضّلة)، سيتم تحصيل الرسوم منك بذلك السعر.

باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: id، photos

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)

---

رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لتفاصيل المكان (الأساسي)، سيتم تحصيل الرسوم منك بذلك المعدّل. في حال اختيار أيّ حقول من رمز التخزين التعريفي الخاص بتفاصيل المكان (الإعدادات المتقدّمة)، سيتم تحصيل الرسوم منك بهذا المعدّل. في حال اختيار أيّ حقول من رمز التخزين التعريفي الخاص بـ "تفاصيل المكان" (المفضّلة)، سيتم تحصيل الرسوم منك بهذا المعدّل.

باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: addressComponents، adrFormatAddress، formattedAddress، location، plusCode، types، viewport

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000)	0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: تفاصيل المكان (أساسية)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لتفاصيل المكان (الإعدادات المتقدّمة)، سيتم تحصيل الرسوم منك بهذا المعدّل. في حال اختيار أيّ حقول من رمز التخزين التعريفي الخاص بـ "تفاصيل المكان" (المفضّلة)، سيتم تحصيل الرسوم منك بهذا المعدّل.

باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: accessibilityOptions، businessStatus، displayName، googleMapsUri، iconBackgroundColor، primaryTypeDisplayName، svgIconMaskURI، types، utcOffsetMinutes

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.0170 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

SKU: تفاصيل المكان (متقدمة)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لتفاصيل المكان (المفضّلة)، سيتم تحصيل الرسوم منك بذلك المعدّل.

باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: internationalPhoneNumber، nationalPhoneNumber، priceLevel، rating، regularOpeningHours، userRatingCount، websiteUri

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000)	0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: تفاصيل المكان (المفضَّل)

باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: hasCurbsidePickup، hasDelivery، hasDineIn، editorialSummary، parkingOptions، paymentOptions، priceLevel، isReservable، reviews، servesBeer، servesBreakfast، servesBrunch، servesDinner، servesLunch، servesVegetarianFood، servesWine، hasTakeout{18

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1,000)	0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: البحث عن قرب (أساسي)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لميزة "البحث عن قرب" (الإعدادات المتقدّمة)، سيتم تحصيل الرسوم منك بذلك المعدّل. في حال اختيار أي حقول من رمز التخزين التعريفي لميزة "البحث عن قرب" (المُفضَّلة)، سيتم تحصيل الرسوم منك بذلك المعدّل.

وباستخدام قناع حقل أو قائمة حقول في طلب "البحث عن قرب" (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: accessibilityOptions، addressComponents، adrFormatAddress، businessStatus، displayName، formattedAddress، googleMapsUri، iconBackgroundColor، id، location، photos، plusCode، svgIconMaskURI، types، utcOffsetMinutes، viewport

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: البحث عن قرب (متقدم)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لميزة "البحث عن قرب" (المُفضَّل)، سيتم تحصيل الرسوم منك بذلك المعدّل.

وباستخدام قناع حقل أو قائمة حقول في طلب "البحث عن قرب" (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: internationalPhoneNumber، nationalPhoneNumber، priceLevel، rating، regularOpeningHours، userRatingCount، websiteUri

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000)	0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: البحث عن قرب (مفضل)

وباستخدام قناع حقل أو قائمة حقول في طلب "البحث عن قرب" (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: hasCurbsidePickup، hasDelivery، hasDineIn، editorialSummary، parkingOptions، paymentOptions، priceLevel، isReservable، reviews، servesBeer، servesBreakfast، servesBrunch، servesDinner، servesLunch، servesVegetarianFood، servesWine، hasTakeout{18

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000)	0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: البحث النصي (المعرّف فقط)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي للبحث النصي (الأساسي)، سيتم تحصيل الرسوم منك بذلك المعدّل. في حال اختيار أيّ حقول من رمز التخزين التعريفي الخاص بالبحث النصي (المتقدّم)، سيتم تحصيل الرسوم منك بهذا المعدّل. في حال اختيار أي حقول من رمز التخزين التعريفي للنص (المفضّل) الخاص بالبحث النصي، سيتم تحصيل الرسوم منك بهذا المعدّل.

باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط: id

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)	0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000)

---

SKU: البحث النصي (أساسي)

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي الخاص بالبحث النصي (المتقدّم)، سيتم تحصيل الرسوم منك بهذا المعدّل. في حال اختيار أي حقول من رمز التخزين التعريفي للنص (المفضّل) الخاص بالبحث النصي، سيتم تحصيل الرسوم منك بهذا المعدّل.

باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: accessibilityOptions، addressComponents، adrFormatAddress، businessStatus، displayName، formattedAddress، googleMapsUri، iconBackgroundColor، location، photos، plusCode، svgIconMaskURI، types، utcOffsetMinutes، viewport

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

SKU: البحث النصي (متقدم)

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

باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: internationalPhoneNumber، nationalPhoneNumber، priceLevel، rating، regularOpeningHours، userRatingCount، websiteUri

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000)	0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

SKU: البحث النصي (مفضل)

باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك حصر الاستجابة على تلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب فقط الحقول التالية:

مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط: hasCurbsidePickup، hasDelivery، hasDineIn، editorialSummary، parkingOptions، paymentOptions، priceLevel، isReservable، reviews، servesBeer، servesBreakfast، servesBrunch، servesDinner، servesLunch، servesVegetarianFood، servesWine، hasTakeout{18

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000)	0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

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

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

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000)	0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

لمحة عن جلسات الإكمال التلقائي

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

بعد أن يختار المستخدم مكانًا (أي يتم إجراء استدعاء تفاصيل الأماكن)، يجب بدء جلسة جديدة باستخدام رمز مميز جديد للجلسة.

يمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:

• خدمة الإكمال التلقائي للأماكن في Places API أو خدمة الإكمال التلقائي للأماكن في Maps JavaScript API. تحتاج إلى تصميم تطبيقك لتقديم رموز مميّزة للجلسة (قد تحتاج إلى تغيير الرمز الحالي).
• أداة الإكمال التلقائي في Maps JavaScript API. يتم تفعيل الفوترة المستندة إلى الجلسات تلقائيًا على هذه التطبيقات المصغّرة، بدون الحاجة إلى أيّ تغيير في الرمز.

يكون الرمز المميّز للجلسة صالحًا لجلسة مستخدم واحدة ويجب عدم استخدامه لأكثر من جلسة مستخدم واحدة. إذا أعدت استخدام رمز مميَّز للجلسة، تُعتبر الجلسة غير صالحة ويتم تحصيل رسوم من الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.

يتم إصدار فواتير لطلبات الإكمال التلقائي وطلبات "تفاصيل الأماكن" باستخدام الجلسات على رموز تخزين تعريفية مختلفة.

لمحة عن رموز التخزين التعريفية لبيانات الأماكن

رموز التخزين التعريفية الثلاثة لبيانات الأماكن هي: البيانات الأساسية وبيانات الاتصال وبيانات الغلاف.

يتم تشغيل رمز تخزين تعريفي واحد (SKU) للبيانات أو أكثر لما يلي:

• Android: كل طلب يُرسل إلى fetchPlace() أو findCurrentPlace()
• iOS: كل مكالمة إلى fetchPlaceFromPlaceID: أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
• خدمة الويب: لكل طلب من طلبات "الأماكن" بناءً على الحقول المحددة في الطلب

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

بالنسبة إلى خدمة الويب، تتيح طلبات البيانات من واجهات برمجة تطبيقات الأماكن تحديد حقول البيانات المطلوب عرضها:

• تفاصيل الأماكن
• البحث عن مكان

بالنسبة إلى خدمة الويب، لا تتيح استدعاءات Places API هذه تحديد الحقول التي تم عرضها. تعرض هذه الطلبات دائمًا جميع بيانات الأماكن، مع تحصيل رسوم رموز التخزين التعريفية لبيانات الأماكن الثلاثة بالإضافة إلى الرسوم لكل طلب من طلبات واجهة برمجة التطبيقات:

• الأماكن – البحث عن أماكن قريبة
• الأماكن – البحث النصي

---

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

ملاحظة: رمز التخزين التعريفي هذا هو رمز تخزين تعريفي للبيانات، ويتم تحصيل الرسوم منه بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي أدّى إلى تشغيله.

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

• Android: Place.Field.ADDRESS أو Place.Field.ADDRESS_COMPONENTS أو Place.Field.BUSINESS_STATUS أو Place.Field.ICON_BACKGROUND_COLOR أو Place.Field.ICON_URL أو Place.Field.ID أو Place.Field.LAT_LNG أو Place.Field.NAME أو Place.Field.PHOTO_METADATAS أو Place.Field.PLUS_CODE أو Place.Field.TYPES أو Place.Field.VIEWPORT أو Place.Field.UTC_OFFSET أو Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
• iOS: GMSPlaceFieldFormattedAddress أو GMSPlaceFieldBusinessStatus أو GMSPlaceFieldID أو GMSPlaceFieldCoordinate أو GMSPlaceFieldName أو GMSPlaceFieldPhotos أو GMSPlaceFieldPlusCode أوGMSPlaceFieldTypes أو GMSPlaceFieldViewport
• خدمة الويب: address_component أو adr_address أو business_status أو formatted_address أو geometry أو icon أو name أو permanently_closed أو photo أو place_id أو plus_code أو type أو url أو utc_offset أو vicinity أو wheelchair_accessible_entrance

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
تكلفة طلب الأماكن + 0.00 دولار أمريكي	تكلفة طلب الأماكن + 0.00 دولار أمريكي	تكلفة طلب الأماكن + 0.00 دولار أمريكي

---

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

ملاحظة: رمز التخزين التعريفي هذا هو رمز تخزين تعريفي للبيانات، ويتم تحصيل الرسوم منه بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي أدّى إلى تشغيله.

باستخدام مَعلمة الحقول في "تفاصيل المكان" أو "طلب البحث عن مكان" لخدمات الويب أو مصفوفة Place.Field لأجهزة Android أو iOS، يمكنك قصر الاستجابة على تلك الحقول المحدّدة فقط. تؤدي الحقول في فئة جهة الاتصال إلى تحصيل رسوم إضافية. يتم تشغيل رمز التخزين التعريفي لبيانات الاتصال عند طلب أيّ من هذه الحقول:

• Android: Place.Field.CURRENT_OPENING_HOURS أو Place.Field.OPENING_HOURS أو Place.Field.PHONE_NUMBER أو Place.Field.SECONDARY_OPENING_HOURS أو Place.Field.WEBSITE_URI
• iOS: GMSPlaceFieldOpeningHours أو GMSPlaceFieldPhoneNumber أو GMSPlaceFieldWebsite
• خدمة الويب: formatted_phone_number أو international_phone_number أو opening_hours أو current_opening_hours أو secondary_opening_hours أو website

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
تكلفة طلب الأماكن + 0.003 دولار أمريكي لكل مكان (+ 3.00 دولار أمريكي لكل 1,000)	تكلفة طلب الأماكن + 0.0024 دولار أمريكي لكل مكان (+ 2.40 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

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

ملاحظة: رمز التخزين التعريفي هذا هو رمز تخزين تعريفي للبيانات، ويتم تحصيل الرسوم منه بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي أدّى إلى تشغيله.

باستخدام معلمة الحقول في تفاصيل المكان أو طلب البحث عن مكان، يمكنك قصر الاستجابة على هذه الحقول المحددة فقط. تؤدي الحقول في فئة Atmosphere إلى تحصيل رسوم إضافية. يتم تشغيل رمز التخزين التعريفي لبيانات الغلاف الجوي عند طلب أي من هذه الحقول:

• Android: Place.Field.CURBSIDE_PICKUP أو Place.Field.DELIVERY أو Place.Field.EDITORIAL_SUMMARY أو Place.Field.DINE_IN أو Place.Field.PRICE_LEVEL أو Place.Field.RATING أو Place.Field.RESERVABLE أو Place.Field.SERVES_BEER أو Place.Field.SERVES_BREAKFAST أو Place.Field.SERVES_BRUNCH أو Place.Field.SERVES_DINNER أو Place.Field.SERVES_LUNCH أو Place.Field.SERVES_VEGETARIAN_FOOD أو Place.Field.SERVES_WINE أوPlace.Field.TAKEOUT أو Place.Field.USER_RATINGS_TOTAL
• أجهزة iOS: GMSPlaceFieldPriceLevel أو GMSPlaceFieldRating أو GMSPlaceFieldUserRatingsTotal أو GMSPlaceFieldTakeout أو GMSPlaceFieldDelivery أو GMSPlaceFieldDineIn أو GMSPlaceFieldCurbsidePickup أو GMSPlaceFieldReservable أوGMSPlaceFieldServesBreakfast أو GMSPlaceFieldServesLunch أو GMSPlaceFieldServesDinner أو GMSPlaceFieldServesBeer أو GMSPlaceFieldServesWine أو GMSPlaceFieldServesBrunch أو GMSPlaceFieldServesVegetarianFood.
• JavaScript: الاطّلاع على الحقول (تفاصيل المكان)
• خدمة الويب: curbside_pickup أو delivery أو dine_in أو editorial_summary أو price_level أو rating أو reservable أو reviews أو serves_beer أو serves_breakfast أو serves_brunch أو serves_dinner أو serves_lunch أو serves_vegetarian_food أو serves_wine أو takeout أو user_ratings_total.

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
تكلفة طلب الأماكن + 0.005 دولار أمريكي لكل مكان (+ 5.00 دولار أمريكي لكل 1,000)	تكلفة طلب الأماكن + 0.004 دولار أمريكي لكل مكان (+ 4.00 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: الإكمال التلقائي – لكل طلب

يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي - لكل طلب مقابل أي من هذه المكالمات أو الطلبات التي لا تتضمّن رمزًا مميّزًا للجلسة:

• Android: findAutocompletePredictions()
• على iOS: findAutocompletePredictionsFromQuery:
• JavaScript: خدمة الإكمال التلقائي للأماكن في Maps JavaScript API
• خدمة الويب: خدمة "الإكمال التلقائي للأماكن" في "واجهة برمجة التطبيقات للأماكن"

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

قد يتم تحصيل رسوم على طلبات الإكمال التلقائي من أداة الإكمال التلقائي للأماكن في Maps JavaScript API مقابل رمز التخزين التعريفي الخاص بالإكمال التلقائي - لكل طلب في حال إجراء الطلبات من جلسة إكمال تلقائي غير صالحة. وقد يحدث هذا عندما يكتب المستخدم عدة عناوين مختلفة أو ينسخ/لصق عناوين مختلفة في الأداة ولا يختار دائمًا أحد عبارات البحث المقترحة للإكمال التلقائي.

نطاق الحجم الشهري (السعر لكل طلب)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000)	0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة

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

النطاق الشهري (السعر لكل جلسة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

مثال

إذا تسبب تطبيقك في حدوث هاتين المكالمتين في جلسة واحدة:

Android

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

• placeClient?.findAutocompletePromptions(fromQuery: "par" ...
• placeClient?.findAutocompletePromptions(fromQuery: "paris" ...

خدمة ويب

• طلب الإكمال التلقائي للمكان (input=”par”, session_token: XYZ)
• طلب الإكمال التلقائي للمكان (input=”paris”, session_token: XYZ)

سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

• الإكمال التلقائي بدون تفاصيل المكان: لكلّ جلسة (يبدأ السعر من 0.017 دولار أمريكي لكلّ جلسة)

---

رمز التخزين التعريفي: الإكمال التلقائي (مشمول مع تفاصيل المكان) - لكلّ جلسة

ملاحظة: يظهر رمز التخزين التعريفي هذا في تقارير الفوترة، ولكن ليس في صفحة الفوترة > الأسعار في Google Cloud Console.

يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي (مضمّن مع تفاصيل المكان) - لكل جلسة، مقابل جلسة الإكمال التلقائي التي تتضمن أيًا مما يلي:

• Android: مكالمة إلى fetchPlace()
• iOS: مكالمة إلى fetchPlaceFromPlaceID:
• خدمة الويب: طلب "تفاصيل مكان"

يتوفّر طلب الإكمال التلقائي بدون أي رسوم، ويتم تحصيل الرسوم من مكالمة "تفاصيل المكان" اللاحقة استنادًا إلى أسعار "تفاصيل المكان" العادية.

ينشئ طلب "تفاصيل المكان" رموز التخزين التعريفية للبيانات (الأساسي و/أو جهة الاتصال و/أو الغلاف الجوي) استنادًا إلى الحقول المحدّدة في الطلب.

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

أثناء جلسة الإكمال التلقائي، يتم تحصيل فواتير طلبات إعادة تحميل معرّف تفاصيل المكان (الطلبات التي تحدّد الحقل place_id فقط) على النحو التالي: رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة.

النطاق الشهري (السعر لكل جلسة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 SAR	0.00 SAR	0.00 SAR

مثال

إذا أصدر طلبك المكالمات الثلاثة التالية في جلسة واحدة:

Android

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
• fetchPlace() (مع FetchPlaceRequest بما في ذلك رقم تعريف المكان والحقل ADDRESS)

iOS

• placeClient?.findAutocompletePromptions(fromQuery: "par" ...
• placeClient?.findAutocompletePromptions(fromQuery: "paris" ...
• fetchPlaceFromPlaceID: (بما في ذلك رقم تعريف المكان والحقل GMSPlaceFieldFormattedAddress)

خدمة ويب

• طلب الإكمال التلقائي للأماكن (input=”par”, session_token: XYZ)
• طلب الإكمال التلقائي للأماكن (input=”paris”, session_token: XYZ)
• تفاصيل الأماكن (place_id، session_token: XYZ، الحقول:format_address)

ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):

• الإكمال التلقائي (مضمّن مع تفاصيل المكان) - لكلّ جلسة (تحصيل الرسوم مقابل 0.00 دولار أمريكي)
• تفاصيل المكان (سعر يبدأ من 0.017 دولار أمريكي للجلسة)
• البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)

---

رمز التخزين التعريفي: الإكمال التلقائي لطلب البحث – لكل طلب

يتم تحصيل رسوم رمز تخزين تعريفي الإكمال التلقائي لطلبات البحث - لكل طلب مقابل كل طلب موجَّه إلى:

• JavaScript: خدمة الإكمال التلقائي للأماكن في Maps JavaScript API (getQueryPredictions()) واستخدام أداة SearchBox في Maps JavaScript API (يتم إنشاء طلبات الإكمال التلقائي لطلبات البحث على أنّها أنواع المستخدمين).
• خدمة الويب: خدمة الإكمال التلقائي لطلبات البحث في Places API

نطاق الحجم الشهري (السعر لكل طلب)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000)	0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

لا تتوفّر إمكانية التسعير حسب جلسة الإكمال التلقائي باستخدام ميزة الإكمال التلقائي لطلبات البحث. يتم تحصيل رسوم مكالمات "تفاصيل الأماكن" اللاحقة بناءً على أسعار "تفاصيل الأماكن" العادية.

---

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

يتم تحصيل رسوم مكالمات تفاصيل الأماكن على النحو التالي:

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

يتم إنشاء رمز التخزين التعريفي لتفاصيل المكان من واجهات برمجة التطبيقات التالية:

• Android: حزمة تطوير برامج الأماكن لأجهزة Android (fetchPlace())
• iOS: حزمة تطوير برامج الأماكن لأجهزة iOS (fetchPlaceFromPlaceID:)
• JavaScript: خدمة "تفاصيل المكان" في JavaScript API للخرائط (getDetails)
• JavaScript: أداة الإكمال التلقائي للأماكن في Maps JavaScript API (getPlace)
• JavaScript: تطبيق Place SearchBox في Google Maps API: getPlaces() بعد أن يختار المستخدم نتيجة مكان (رمز: دبوس)، *وليس* طلب بحث (رمز: مكبّر)، كما هو موضّح هنا:

  

  في نتائج تطبيق مربّع البحث المصغّر، بعد كتابة "بيتزا" في مربّع البحث، لاحِظ أنّ بيتزا Autentico هي عبارة عن رمز دبابيس.{/1 يظهر بجانبها رمز الدبوس{/0.

• خدمة الويب: خدمة "تفاصيل الأماكن" في Places API

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

يؤدي طلب أو مكالمة "تفاصيل المكان" أيضًا إلى إنشاء رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو الغلاف الجوي)، استنادًا إلى الحقول المحدّدة في المكالمة أو الطلب. إذا تم تحديد حقل لا في استدعاء أو طلب "تفاصيل المكان"، فسيتم تشغيل جميع رموز التخزين التعريفية للبيانات، وسيتم تحصيل رسوم منك مقابل استدعاء أو طلب "تفاصيل الأماكن" بالإضافة إلى تكلفة جميع البيانات.

أمثلة

1. أجرِ أحد المكالمات أو الطلبات التالية:
   • الجهاز الجوّال: يمكنك الاتصال بـ fetchPlace() على نظام التشغيل Android أو fetchPlaceFromPlaceID: على iOS، مع تحديد الحقل ADDRESS فقط.
   • واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address)
   ستظهر رموز التخزين التعريفية هذه في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان (سعر يبدأ من 0.017 دولار أمريكي للجلسة)
   • البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
2. أجرِ أحد المكالمات أو الطلبات التالية:
   • الجهاز الجوّال: يمكنك الاتصال بـ fetchPlace() على نظام التشغيل Android أو fetchPlaceFromPlaceID: على iOS، مع تحديد الحقل PHONE_NUMBER فقط.
   • واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل مكان" وتحديد حقل رقم الهاتف: getPlaceDetails(fields: formatted_phone_number)
   ستظهر رموز التخزين التعريفية هذه في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان (سعر يبدأ من 0.017 دولار أمريكي للجلسة)
   • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
3. أجرِ أحد المكالمات أو الطلبات التالية:
   • الجهاز الجوّال: يمكنك الاتصال بـ fetchPlace() على نظام التشغيل Android أو fetchPlaceFromPlaceID: على iOS، وتحديد جميع الحقول.
   • واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان" وتحديد جميع الحقول (يكون هذا النوع من الطلبات تلقائيًا في حال عدم تحديد أي حقول): getPlaceDetails().
   ستظهر رموز التخزين التعريفية هذه في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان (سعر يبدأ من 0.017 دولار أمريكي للجلسة)
   • البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
   • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
   • بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)

---

رمز التخزين التعريفي: تفاصيل المكان – إعادة تحميل المعرّف

استخدِم طلب "تفاصيل المكان" من أجل إعادة تحميل أرقام تعريف الأماكن القديمة. تتوفر هذه الأنواع من الطلبات بدون أي رسوم.

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 SAR	0.00 SAR	0.00 SAR

مثال

قدِّم طلب "تفاصيل مكان" مع تحديد حقل معرّف المكان فقط: getPlaceDetails(fields: place_id). سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

• تفاصيل المكان - إعادة تحميل مستندات التعريف (تحصيل الفواتير بقيمة 0.00 دولار أمريكي)

---

SKU: البحث عن مكان

يتم تحصيل رسوم من العثور على المكان مقابل طلب "العثور على مكان".

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000)	0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

تؤدي طلبات "العثور على المكان" أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات (أساسي و/أو جهة اتصال و/أو الغلاف الجوي)، استنادًا إلى الحقول المحدّدة في الطلب. مثل طلبات "تفاصيل المكان"، يمكنك استخدام معلمة الحقول في طلب "العثور على مكان" لقصر الاستجابة على تلك الحقول المحددة فقط. يتم تحصيل الرسوم منك مقابل طلب "العثور على مكان" بالإضافة إلى البيانات المطلوبة. وبشكلٍ تلقائي، إذا تم طلب حقول لا، يتم عرض رقم تعريف المكان فقط، لذلك لا يتم تحصيل رسوم إضافية للبيانات.

أمثلة

1. عليك تقديم طلب "العثور على مكان" وتحديد حقل العنوان فقط: FindPlace(fields: formatted_address). ستظهر في فاتورتك رموز التخزين التعريفية هذه مُدرَجة (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
   • البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
   • البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
2. تقدم طلب "العثور على مكان" وتحدد حقل رقم الهاتف: FindPlace(fields: formatted_phone_number). في فاتورتك، ستظهر لك رموز التخزين التعريفية هذه مُدرَجة (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
   • البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
   • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
3. عليك إرسال طلب "العثور على مكان" وتحديد الحقول من مجموعات البيانات الثلاث جميعها: FindPlace(fields: formatted_address, opening_hours, price_level). في فاتورتك، ستظهر رموز التخزين التعريفية هذه مُدرَجة (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
   • البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
   • البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
   • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
   • بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)

---

رمز التخزين التعريفي: البحث عن مكان - رقم التعريف فقط

يتم تحصيل رسوم من البحث عن مكان - رقم التعريف فقط مقابل طلبات "العثور على المكان" التي تحدّد فقط رقم تعريف المكان المطلوب عرضه. وبشكلٍ تلقائي، إذا لم يتم تحديد أي حقول في طلب "البحث عن مكان"، سيتم عرض معرّف المكان فقط.

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00 SAR	0.00 SAR	0.00 SAR

مثال

تقدم طلب "العثور على مكان" وتحدد فقط حقل place_id: FindPlace(fields: place_id). سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

• البحث عن مكان - رقم التعريف فقط (تحصيل الفواتير بسعر 0.00 دولار أمريكي)

---

رمز التخزين التعريفي: المكان – البحث عن أماكن قريبة

يتم تحصيل رسوم المكان – البحث عن الأماكن المجاورة مقابل الطلبات الموجّهة إلى خدمة "البحث عن الأماكن المجاورة" في واجهة برمجة تطبيقات JavaScript للخرائط (nearbySearch()) أو إلى خدمة "البحث عن الأماكن المجاورة" في واجهة برمجة تطبيقات الأماكن

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

مثال

إذا أرسلت طلبًا من خلال ميزة "البحث عن قرب"، مثل NearbySearch (San Francisco, 100 meters). ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):

• المكان - البحث عن قرب (يبدأ السعر من 0.032 دولار أمريكي للمكالمة)
• البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
• بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
• بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)

---

رمز التخزين التعريفي: المكان – البحث النصي

يتم تحصيل رسوم المكان – البحث النصي مقابل الطلبات المُرسَلة إلى خدمة "البحث عن النص عن الأماكن" (Place Text) من واجهة برمجة تطبيقات JavaScript (textSearch()) أو إلى خدمة "البحث النصي في الأماكن" (Places API).

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

يتم أيضًا إنشاء رمز التخزين التعريفي لـ Place – Text Search بواسطة أداة Place SearchBox في Maps JavaScript API: getPlaces() بعد أن يختار المستخدم طلب بحث عن مكان (رمز: المكبِّر)، وليس نتيجة (رمز: دبوس)، كما هو موضّح هنا:

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

مثال

إذا أرسلت طلب بحث نصي، مثلاً TextSearch(123 Main Street). سترى في فاتورتك رموز التخزين التعريفية هذه مُدرَجة (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):

• المكان - البحث النصي (يبدأ السعر من 0.032 دولار أمريكي للمكالمة)
• البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
• بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
• بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)

---

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

يتم تحصيل رسوم رمز التخزين التعريفي لصورة المكان مقابل:

• جهاز Android: المكالمات إلى fetchPhoto()
• iOS: المكالمات إلى loadPlacePhoto:
• JavaScript: يؤدي إلى مكتبة الأماكن، خدمة صور الأماكن على JavaScript API عند طلب بيانات من عناوين URL التي يعرضها PlacePhoto.getUrl() لتحميل بيانات وحدات بكسل الصور
• خدمة الويب: الطلبات إلى خدمة "صور الأماكن" في واجهة برمجة تطبيقات الأماكن

بالنسبة إلى خدمة JavaScript، لا يؤدي استدعاء طريقة PlacePhoto.getUrl() إلى الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات البكسل.

النطاق الشهري للحجم (سعر المكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000)	0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

تحديد أسعار خدمات JavaScript

ويتم تسعير خدمات JavaScript بشكل منفصل. راجع صفحة استخدام الخدمة والفوترة للحصول على مزيد من المعلومات:

• Directs Service: استخدام واجهة برمجة التطبيقات للاتجاهات والفوترة
• خدمة مصفوفة المسافة -- استخدام واجهة برمجة التطبيقات لمصفوفة المسافة والفوترة
• Eliffation Service (خدمة الارتفاع): استخدام واجهة برمجة التطبيقات Elevation والفوترة
• Geocoding Service -- استخدام Geocoding API والفوترة
• خدمة "التجوّل الافتراضي" -- استخدام واجهة برمجة تطبيقات "التجوّل الافتراضي" والفوترة</a

حدود استخدام أخرى

على الرغم من عدم وجود حد أقصى لعدد الطلبات في اليوم، فقد تم فرض حدود الاستخدام التالية على Maps JavaScript API:

• 30000 QPM (طلب في الدقيقة).
• 300 وحدة QPM (طلب في الدقيقة) لكل عنوان IP. وفي Google Cloud Console، يُشار إلى هذه الحصة باسم عمليات تحميل الخريطة في الدقيقة لكل مستخدم.

نقطة رئيسية: قد تحصل المشاريع القديمة على حصة قديمة تبلغ 60 وحدة QPM لكل عنوان IP. وإذا أردت زيادة القيمة إلى 300 وحدة QPM، يُرجى التواصل مع فريق الدعم وطلب زيادة الحصة.

حدود استخدام JavaScript للخرائط الثلاثية الأبعاد ذات الصور الواقعية في "خرائط Google"

ملاحظة: خلال المرحلة التجريبية، سيكون استخدامك للخرائط الثلاثية الأبعاد ذات الصور الواقعية في JavaScript في "خرائط Google": (1) بدون أي رسوم و (2) يتطلّب منك تفعيل الفوترة في كل مشروع من مشاريعك باستخدام خرائط ذات صور واقعية ثلاثية الأبعاد في JavaScript في "خرائط Google". لسنا ملزمين بإبلاغك عند انتهاء الفترة التجريبية، ونحتفظ بالحق في تعديل الفترة التجريبية أو إنهائها في أي وقت، بدون إشعار ووفقًا لتقديرنا الخاص.

تم فرض حدود الاستخدام التالية للخرائط الثلاثية الأبعاد ذات الصور الواقعية في JavaScript في "خرائط Google"

• 100 QPM (طلب في الدقيقة) .
• 10 QPM (طلب في الدقيقة) لكل عنوان IP .

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

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

إدارة تكلفة الاستخدام

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

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

لعرض حدود الحصص أو تغييرها في Maps JavaScript API:

1. في Cloud Console، افتح صفحة حصص "خرائط Google".
2. انقر على القائمة المنسدلة لواجهات برمجة التطبيقات واختَر Maps JavaScript API.
3. للاطّلاع على حدود الحصص، انتقِل للأسفل وصولاً إلى بطاقة الطلبات.
   يسرد جدول أسماء الحصص وحدودها.
4. لتغيير الحدّ الأقصى للحصة، انقر على رمز تعديل لهذا الحدّ.
   في مربّع الحوار الذي يظهر، في حقل الحدّ الأقصى للحصة، أدخِل الحدّ المفضّل للحصة اليومية القابلة للفوترة (ما يصل إلى الحدّ الأقصى للحصة المحدّدة من قِبل Google، إن توفّر) ثم انقر على حفظ.

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

مراجع إدارة التكاليف ذات الصلة

• الفوترة والأسعار في "منصة خرائط Google"
• إعداد التقارير والمراقبة في "منصة خرائط Google"

---