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

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

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

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

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

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

أسعار Maps JavaScript API

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

تطبيق يعرض خريطة تم تحميلها باستخدام معرّف خريطة أو بدونه باستخدام واجهة برمجة تطبيقات JavaScript للخرائط، أو خريطة تم تحميلها باستخدام معرّف خريطة وباستخدام إما حزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل 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، حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android تطبيق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS

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

تحدث عملية إنشاء مثيل لكائن بانوراما:

أسعار Places Library وMaps JavaScript API

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

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

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

  • إنهاء الجلسات بطلب واحد لوضع التفاصيل (جديد) الذي أي حقول محدّدة في رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
    • يتم تحصيل رسوم كل طلب من طلبات "الإكمال التلقائي (جديد)"، بما يصل إلى 12 طلبًا، باستخدامرمز التخزين التعريفي: طلبات الإكمال التلقائي.
    • يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
  • يمكنك التخلي عن الجلسة أو إنهائها من خلال إجراء مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط). بعد ذلك، يتمّ تحصيل رسوم منك مقابل كلّ طلبات "الإكمال التلقائي (جديد)" باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1,000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

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

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

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

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

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

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

  • تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى SKU: Address Validation Preferred.

النطاق الشهري للحجم
(سعر المكالمة)
من 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)

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

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

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": 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)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

مكتبة الأماكن وواجهة برمجة تطبيقات 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)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": allowsDogs، editorialSummary، evChargeOptions، fuelOptions، hasCurbsidePickup، hasDelivery، hasDineIn، hasLiveMusic، hasMenuForChildren، hasOutdoorSeating، hasRestroom، hasTakeout، hasWifi، isGoodForChildren، isGoodForGroups، isGoodForWatchingSports، isReservable، parkingOptions، paymentOptions، priceLevel، reviews، servesBeer، servesBreakfast، servesBrunch، servesCocktails، servesCoffee، servesDessert، servesDinner، servesLunch، servesVegetarianFood، servesWine

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

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

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

Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google": 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)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": allowsDogs، editorialSummary، evChargeOptions، fuelOptions، hasCurbsidePickup، hasDelivery، hasDineIn، hasLiveMusic، hasMenuForChildren، hasOutdoorSeating، hasRestroom، hasTakeout، hasWifi، isGoodForChildren، isGoodForGroups، isGoodForWatchingSports، isReservable، parkingOptions، paymentOptions، priceLevel، reviews، servesBeer، servesBreakfast، servesBrunch، servesCocktails، servesCoffee، servesDessert، servesDinner، servesLunch، servesVegetarianFood، servesWine

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

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

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

Places Library، وMaps JavaScript API: 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)

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

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

مكتبة الأماكن وواجهة برمجة تطبيقات 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)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google": allowsDogs، editorialSummary، evChargeOptions، fuelOptions، hasCurbsidePickup، hasDelivery، hasDineIn، hasLiveMusic، hasMenuForChildren، hasOutdoorSeating، hasRestroom، hasTakeout، hasWifi، isGoodForChildren، isGoodForGroups، isGoodForWatchingSports، isReservable، parkingOptions، paymentOptions، priceLevel، reviews، servesBeer، servesBreakfast، servesBrunch، servesCocktails، servesCoffee، servesDessert، servesDinner، servesLunch، servesVegetarianFood، servesWine

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 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)		 يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

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

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

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

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

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

لمحة عن أرقام تعريف المنتجات في "بيانات الأماكن"

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

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

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

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

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

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

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

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

  • Android: Place.Field.ACCESSIBILITY_OPTIONS، Place.Field.ADDRESS_COMPONENTS، Place.Field.BUSINESS_STATUS، Place.Field.DISPLAY_NAME، Place.Field.FORMATTED_ADDRESS، Place.Field.ICON_BACKGROUND_COLOR، Place.Field.ICON_MASK_URL، Place.Field.ID، Place.Field.LOCATION، Place.Field.PHOTO_METADATAS، Place.Field.PLUS_CODE، Place.Field.TYPES، Place.Field.VIEWPORT، أو Place.Field.UTC_OFFSET
  • نظام التشغيل 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.INTERNATIONAL_PHONE_NUMBER, Place.Field.OPENING_HOURS، 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 Data عند طلب أيّ من الحقول التالية:

  • 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_RATING_COUNT
  • نظام التشغيل 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)		 يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

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

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

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

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1,000)		 ‫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

iOS

خدمة ويب

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

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

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة ويب

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

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

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

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

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1,000)		 ‫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)		 يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

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

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

أمثلة

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

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

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

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

مثال

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

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

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

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

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

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

أمثلة

  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 دولار أمريكي 0.00 دولار أمريكي

مثال

تقدم طلب "العثور على مكان" وتحدد فقط حقل 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 دولار أمريكي لكل طلب)

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

يتم تحصيل رسوم من المكان – البحث النصي مقابل الطلبات المرسلة إلى خدمة "البحث النصي عن المكان" في "واجهة برمجة تطبيقات 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 ريال سعودي لكل طلب، بالإضافة إلى جميع رمزَي التخزين التعريفيَين لنوع البيانات (البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي).

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

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

مثال

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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