استخدام واجهة برمجة تطبيقات الأماكن والفوترة

الفوترة والأسعار لواجهة Places API

للحصول على معلومات عن كيفية احتساب Google لفواتيرك وأسعارك، يمكنك الاطّلاع على قائمة أسعار Google Maps Platform أو قائمة أسعار Google Maps Platform في الهند.

رموز التخزين التعريفية للمنتجات في "الأماكن" (الإصدار الجديد)

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

لمحة عن أقنعة الحقول

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

يُعدّ استخدام حجب الحقول من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.

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

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

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

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

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

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

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

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

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

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

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

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات الحصول على تفاصيل الأماكن التي لا تعرض سوى معرّف المكان.

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: حقول خدمة الويب attributions id name* photos * يحتوي الحقل name على مكان اسم المورد في الشكل: places/PLACE_ID. استخدِم displayName للوصول إلى الاسم النصي للمكان.
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل الطلبات التي يتم إرسالها إلى Place Details API لاسترداد الحقول الواردة في رمز التخزين التعريفي هذا.

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب حقول الموقع الجغرافي التالية: حقول خدمة الويب addressComponents adrFormatAddress formattedAddress location plusCode postalAddress shortFormattedAddress types viewport
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: Places API Place Details Pro

تُحصّل رمز التخزين التعريفي هذا رسومًا مقابل الحقول التي تحدّدها في طلب Place Details Pro.

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط أو الحقول ذات معدّل السعر الأدنى: حقول خدمة الويب accessibilityOptions businessStatus containingPlaces displayName googleMapsLinks* googleMapsUri iconBackgroundColor iconMaskBaseUri primaryType primaryTypeDisplayName pureServiceAreaBusiness subDestinations utcOffsetMinutes * الحقل googleMapsLinks في مرحلة معاينة الإصدار ما قبل الإطلاق للجمهور العام ولا يتم تحصيل أي رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: Places API Place Details Enterprise

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلب "الأماكن" الذي يتضمّن حقول Enterprise.

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: حقول خدمة الويب currentOpeningHours currentSecondaryOpeningHours internationalPhoneNumber nationalPhoneNumber priceLevel priceRange rating regularOpeningHours regularSecondaryOpeningHours userRatingCount websiteUri إذا أنهيت جلسة "الإكمال التلقائي" من خلال طلب أي حقل من رمز التخزين التعريفي: Place Details Essentials أو Pro أو Enterprise أو Enterprise + Atmosphere، يتم تحصيل رسوم المكالمة وفقًا لرمز التخزين التعريفي: Place Details Enterprise + Atmosphere. لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: واجهة برمجة التطبيقات Places API لعرض تفاصيل الأماكن في Enterprise + Atmosphere

تفرض فئة التخزين التعريفي هذه رسومًا على طلبات البيانات من واجهة برمجة التطبيقات Place Details API التي تطلب حقول الغلاف الجوي المحدّدة.

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: خدمة ويب: allowsDogs curbsidePickup delivery dineIn editorialSummary evChargeOptions fuelOptions goodForChildren goodForGroups goodForWatchingSports liveMusic menuForChildren parkingOptions paymentOptions outdoorSeating reservable restroom reviews routingSummaries* servesBeer servesBreakfast servesBrunch servesCocktails servesCoffee servesDessert servesDinner servesLunch servesVegetarianFood servesWine takeout * البحث النصي والبحث عن الأماكن المجاورة فقط إذا تم إنهاء جلسة الإكمال التلقائي من خلال طلب أي حقل من رمز التخزين التعريفي: Place Details Essentials أو Pro أو Enterprise أو Enterprise + Atmosphere، يتم تحصيل رسوم المكالمة وفقًا رمز التخزين التعريفي: Place Details Enterprise + Atmosphere. لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
	أمثلة على الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: Places API Nearby Search Pro

تُحصّل فئة التخزين التعريفية هذه رسومًا مقابل الحقول التي تحدّدها في طلب Nearby Search Pro.

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز SKU هذا عند طلب الحقول التالية فقط أو الحقول ذات السعر الأدنى: حقول خدمة الويب places.accessibilityOptions places.addressComponents places.adrFormatAddress places.attributions places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks* places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.id places.location places.name** places.photos places.plusCode places.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport * يُعدّ الحقل places.googleMapsLinks في مرحلة معاينة الإصدار التمهيدي من "إحصاءات Google" ولا يتم تحصيل أي رسوم، أي أنّ الفوترة تكون 0 دولار أمريكي مقابل الاستخدام أثناء مرحلة المعاينة. ** يحتوي الحقل places.name على اسم المورد للمكان على النحو التالي: places/PLACE_ID. استخدِم places.displayName للوصول إلى الاسم النصي للمكان.
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: Places API Nearby Search Enterprise

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات "البحث عن الأنشطة التجارية القريبة" التي تتضمّن أي حقول Enterprise.

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: حقول خدمة الويب places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: Places API Nearby Search Enterprise + Atmosphere

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

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: خدمة ويب: places.allowsDogs places.curbsidePickup places.delivery places.dineIn places.editorialSummary places.evChargeOptions places.fuelOptions places.goodForChildren places.goodForGroups places.goodForWatchingSports places.liveMusic places.menuForChildren places.parkingOptions places.paymentOptions places.outdoorSeating places.reservable places.restroom places.reviews places.routingSummaries* places.servesBeer places.servesBreakfast places.servesBrunch places.servesCocktails places.servesCoffee places.servesDessert places.servesDinner places.servesLunch places.servesVegetarianFood places.servesWine places.takeout * البحث النصي والبحث عن الأماكن المجاورة فقط
	أمثلة على الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يتم تحصيل رسوم رمز التخزين التعريفي هذا مقابل الطلبات التي يتم إرسالها إلى Text Search API والتي تعرض أرقام تعريف فقط.

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب فقط الحقول التالية: حقول خدمة الويب places.attributions places.id places.name* nextPageToken * يحتوي الحقل places.name على مكان اسم المورد في الشكل: places/PLACE_ID. استخدِم places.displayName للوصول إلى الاسم النصي للمكان.
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

رمز التخزين التعريفي هذا هو رمز تخزين تعريفي للبيانات يتم تحصيل رسومه مقابل الحقول التي تحدّدها في طلب Text Search Pro.

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب فقط الحقول التالية أو الحقول ذات السعر الأدنى: حقول خدمة الويب places.accessibilityOptions places.addressComponents places.adrFormatAddress places.businessStatus places.containingPlaces places.displayName places.formattedAddress places.googleMapsLinks* places.googleMapsUri places.iconBackgroundColor places.iconMaskBaseUri places.location places.photos places.plusCode places.postalAddress places.primaryType places.primaryTypeDisplayName places.pureServiceAreaBusiness places.shortFormattedAddress places.subDestinations places.types places.utcOffsetMinutes places.viewport * يُرجى العِلم أنّ الحقل places.googleMapsLinks في مرحلة معاينة الإصدار العلني ولا يتم تحصيل أي رسوم، أي أنّ الفوترة ستكون 0 دولار أمريكي مقابل الاستخدام أثناء مرحلة المعاينة.
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات "البحث النصي" التي تتضمّن أي حقول في Enterprise.

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: حقول خدمة الويب places.currentOpeningHours places.currentSecondaryOpeningHours places.internationalPhoneNumber places.nationalPhoneNumber places.priceLevel places.priceRange places.rating places.regularOpeningHours places.regularSecondaryOpeningHours places.userRatingCount places.websiteUri
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: البحث النصي في Places API لإصدار Enterprise + Atmosphere

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات البحث النصي التي تتضمّن أي حقول للجو.

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية: خدمة ويب: places.allowsDogs places.curbsidePickup places.delivery places.dineIn places.editorialSummary places.evChargeOptions places.fuelOptions places.goodForChildren places.goodForGroups places.goodForWatchingSports places.liveMusic places.menuForChildren places.parkingOptions places.paymentOptions places.outdoorSeating places.reservable places.restroom places.reviews places.routingSummaries* places.servesBeer places.servesBreakfast places.servesBrunch places.servesCocktails places.servesCoffee places.servesDessert places.servesDinner places.servesLunch places.servesVegetarianFood places.servesWine places.takeout * البحث النصي والبحث عن الأماكن المجاورة فقط
	أمثلة على الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يُستخدَم رمز التخزين التعريفي هذا لفواتير طلبات "صور تفاصيل المكان".

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تفعيل الفوترة عند طلب صورة من Place Details API.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رموز التخزين التعريفية القديمة للمنتجات في "الأماكن"

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

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

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

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

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

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

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

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

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

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

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

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

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

• Places Details Pro
• العثور على مكان

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

• الأماكن - البحث عن الأماكن المجاورة
• الأماكن: البحث النصي

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

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

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

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي Basic Data عند طلب أيّ من الحقول التالية: الحقول لحزمة تطوير البرامج (SDK) لنظام التشغيل Android Place.Field.ACCESSIBILITY_OPTIONS*    * استخدِم هذا الرمز بدلاً من Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (تم إيقافه نهائيًا) Place.Field.ADDRESS_COMPONENTS Place.Field.BUSINESS_STATUS Place.Field.DISPLAY_NAME*    * استخدِم هذا الرمز بدلاً من Place.Field.NAME (تم إيقافه نهائيًا) Place.Field.FORMATTED_ADDRESS*    * استخدِم هذا الرمز بدلاً من Place.Field.ADDRESS (تم إيقافه نهائيًا) Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL*    * استخدِم هذا الرمز بدلاً من Place.Field.ICON_URL (تم إيقافه نهائيًا) Place.Field.ID Place.Field.LOCATION*    * استخدِم هذا الرمز بدلاً من Place.Field.LAT_LNG (تم إيقافه نهائيًا) 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
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

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

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي Contact Data عند طلب أيّ من الحقول التالية: الحقول لحزمة تطوير البرامج (SDK) لنظام التشغيل Android Place.Field.CURRENT_OPENING_HOURS Place.Field.INTERNATIONAL_PHONE_NUMBER*       * استخدِم بدلاً من Place.Field.PHONE_NUMBER (متوقّفة نهائيًا). Place.Field.OPENING_HOURS Place.Field.SECONDARY_OPENING_HOURS Place.Field.WEBSITE_URI الحقول لحزمة تطوير البرامج (SDK) لنظام التشغيل iOS GMSPlaceFieldOpeningHours GMSPlaceFieldPhoneNumber GMSPlaceFieldWebsite حقول خدمة الويب formatted_phone_number international_phone_number opening_hours current_opening_hours secondary_opening_hours website
	الفوترة باستخدام قناع الحقل	يتم تحصيل رسوم طلبك استنادًا إلى الحقول المقدَّمة في قناع الحقول. على سبيل المثال: إذا كان قناع الحقول يتضمّن حقولًا من رمز التخزين التعريفي هذا فقط: يتم تحصيل الرسوم من الطلب وفقًا للسعر المرتبط برمز التخزين التعريفي هذا. إذا كان قناع الحقول يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيله بالاستناد إلى أعلى تعرفة رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من رمز التخزين التعريفي لإصدار Essentials ورمز التخزين التعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفي لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل الطلبات التي يتم إرسالها إلى واجهة برمجة التطبيقات Atmosphere Data API والتي تحدّد الحقول في رمز التخزين التعريفي هذا.

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

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

تُستخدم رمز التخزين التعريفي هذا لفواتير الطلبات التي لا تتضمّن رمز أمان الجلسة.

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

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

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تفعيل الفوترة لما يلي: Android: findAutocompletePredictions() أجهزة iOS: findAutocompletePredictionsFromQuery: JavaScript: خدمة "إكمال الأماكن تلقائيًا" في Maps JavaScript API خدمة الويب: خدمة الإكمال التلقائي للأماكن في Places API
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الجلسة
	عوامل التفعيل	يتم تفعيل الفوترة إذا أرسل تطبيقك الطلبَين التاليَين في جلسة واحدة: Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... خدمة الويب طلب الإكمال التلقائي للأماكن (input="par", session_token: XYZ) طلب الإكمال التلقائي للأماكن (input="paris", session_token: XYZ) عند عرض فاتورتك حسب رمز التخزين التعريفي، سيظهر لك رمز التخزين التعريفي هذا: الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الجلسة
	عوامل التفعيل	الإكمال التلقائي (مضمّن في تفاصيل الأماكن) – لكل جلسة يتم تحصيل رسوم رمز التخزين التعريفي مقابل جلسة الإكمال التلقائي التي تطلب تفاصيل الأماكن. على وجه التحديد: Android: مكالمة إلى fetchPlace() iOS: طلب إلى fetchPlaceFromPlaceID: خدمة الويب: طلب تفاصيل مكان الحقول في الطلب: احرص على تحديد الحقول التي تحتاج إليها في الطلب لتجنّب أي رسوم غير ضرورية. استنادًا إلى الحقول التي تحدّدها، يؤدي طلب "تفاصيل المكان" أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات التالية: البيانات الأساسية (Essentials) الأماكن - بيانات الاتصال (للمؤسسات) الأماكن - الأجواء (Enterprise) إذا لم تحدّد حقولًا في طلب "تفاصيل المكان"، سيتم تنشيط جميع رموز التخزين التعريفية للبيانات. إذا طلبت فقط إعادة تحميل رقم تعريف تفاصيل المكان (يحدّد طلبك فقط الحقل place_id) أثناء جلسة الإكمال التلقائي، يتم تحصيل رسوم الجلسة على النحو التالي: رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة.
	أمثلة	يوضّح هذا المثال سلسلة من الطلبات، حسب المنصة، التي ستؤدي إلى ظهور رموز التخزين التعريفية التالية في فاتورتك عند عرض فاتورتك حسب رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في "تفاصيل المكان") - لكل جلسة تفاصيل المكان البيانات الأساسية مثال على الطلب حسب النظام الأساسي: طلبات Android findAutocompletePredictions() (.setQuery("par"), .setSessionToken(XYZ)) findAutocompletePredictions() (.setQuery("paris"), .setSessionToken(XYZ)) fetchPlace() (مع FetchPlaceRequest بما في ذلك رقم تعريف المكان وحقل ADDRESS) طلبات iOS placesClient?.findAutocompletePredictions(fromQuery: "par" ... placesClient?.findAutocompletePredictions(fromQuery: "paris" ... fetchPlaceFromPlaceID: (بما في ذلك رقم تعريف المكان وحقل GMSPlaceFieldFormattedAddress) طلبات خدمات الويب طلب الإكمال التلقائي للأماكن (input="par", session_token: XYZ) طلب الإكمال التلقائي للأماكن (input="paris", session_token: XYZ) تفاصيل الأماكن (place_id, session_token: XYZ, fields:formatted_address)
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

تُحصّل رمز التخزين التعريفي القديم هذا رسوم طلبات ميزة "الإكمال التلقائي لطلبات البحث".

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند تقديم طلب ميزة "الإكمال التلقائي للطلبات" باستخدام الخدمات التالية: JavaScript: تشمل هذه الواجهة خدمة "الإكمال التلقائي للأماكن" في واجهة برمجة تطبيقات JavaScript للخرائط (getQueryPredictions()) واستخدام التطبيق المصغّر SearchBox في واجهة برمجة تطبيقات JavaScript للخرائط (يتم إنشاء طلبات "الإكمال التلقائي للطلبات" أثناء كتابة المستخدم). خدمة الويب: خدمة الإكمال التلقائي لطلبات البحث في Places API لا تتوفّر ميزة تحديد الأسعار حسب جلسة الإكمال التلقائي باستخدام ميزة "إكمال الطلب تلقائيًا". يتم تحصيل رسوم منك مقابل طلبات تفاصيل الأماكن اللاحقة استنادًا إلىرمز التخزين التعريفي لميزة "تفاصيل الأماكن" المدفوعة.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

رمز التخزين التعريفي: Place Details Pro

يُستخدَم رمز التخزين التعريفي هذا لفواتير طلبات "تفاصيل الأماكن" القديمة.

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تفعيل الفوترة للطلبات الواردة من واجهات برمجة التطبيقات التالية: Android: حزمة تطوير برامج "الأماكن" لأجهزة Android (fetchPlace()) iOS: حزمة تطوير برامج "الأماكن" لأجهزة iOS (fetchPlaceFromPlaceID:) JavaScript: خدمة "تفاصيل الأماكن" في واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google" (getDetails) JavaScript: تطبيق مصغّر "إكمال تلقائي للأماكن" في Maps JavaScript API (getPlace) JavaScript: تطبيق JavaScript API لتطبيق "خرائط Google"، التطبيق المصغّر "مربّع البحث عن الأماكن": getPlaces() بعد اختيار المستخدِم نتيجة مكان (رمزها: دبوس)، *وليس* طلب بحث (رمزه: عدسة مكبرة)، كما هو موضّح هنا: خدمة الويب: خدمة "تفاصيل الأماكن" في Places API باستخدام واجهة برمجة التطبيقات والخدمات على الويب، يتم تحصيل رسوم رمز التخزين التعريفي لتفاصيل المكان سواء قدّمت رمز تمييز جلسة أم لا. يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	يمكنك إجراء أحد هذه المكالمات أو الطلبات: الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد الحقل ADDRESS فقط. Web API أو الخدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address) ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي): تفاصيل المكان البيانات الأساسية يمكنك إجراء أحد هذه المكالمات أو الطلبات: الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد الحقل PHONE_NUMBER فقط. Web API أو الخدمة: يمكنك تقديم طلب للحصول على تفاصيل المكان وتحديد حقل رقم الهاتف: getPlaceDetails(fields: formatted_phone_number) ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي): تفاصيل المكان بيانات الاتصال يمكنك إجراء أحد هذه المكالمات أو الطلبات: الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد جميع الحقول. Web API أو خدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد جميع الحقول (هذا النوع من الطلبات هو التلقائي في حال عدم تحديد أي حقول): getPlaceDetails(). ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي): تفاصيل المكان البيانات الأساسية بيانات الاتصال بيانات الغلاف الجوي
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

تفرض رمز التخزين التعريفي هذا رسومًا على الطلبات التي يتم إرسالها إلى Place Details API من أجل تحديث أرقام تعريف الأماكن القديمة.

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تفعيل الفوترة عند تقديم طلب للحصول على تفاصيل عن مكان معيّن مع تحديد حقل رقم تعريف المكان فقط: getPlaceDetails(fields: place_id).
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات البحث عن مكان تُعرِض حقولًا أكثر من معرّف المكان فقط.

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	تُحصّل قيمة رمز التخزين التعريفي هذه رسومًا مقابل الطلبات التي يتم إجراؤها بالطرق التالية: العثور على المكان الحالي يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	توضِّح الأمثلة التالية رموز التخزين التعريفية التي يتم تحصيل رسومها منك عند إجراء طلب "العثور على المكان الحالي" وتحديد الحقول من رموز التخزين التعريفية لبيانات "البيانات الأساسية" و"جهة الاتصال" و"الجو". للاطّلاع على رموز التخزين التعريفية في فاتورتك، اطّلِع على فاتورتك حسب رمز التخزين التعريفي كما هو موضّح في تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي. عند تقديم طلب "العثور على مكان" باستخدام حقل ADDRESS فقط: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي البيانات الأساسية عند تقديم طلب "العثور على مكان" باستخدام حقل PHONE_NUMBER فقط: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي بيانات الاتصال يمكنك تقديم طلب "العثور على مكان" باستخدام الحقول الثلاثة التالية لأنواع البيانات: تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على المكان الحالي البيانات الأساسية بيانات الاتصال بيانات الغلاف الجوي
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	Category (الفئة)	Essentials
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	إذا أرسلت طلبًا للعثور على مكان بدون تحديد أي حقول، أو إذا حدّدت فقط حقل place_id: FindPlace(fields: place_id)
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند تقديم طلب بحث عن المنتجات بالقرب منك باستخدام إحدى واجهات برمجة التطبيقات التالية: خدمة البحث عن الأماكن المجاورة في Maps JavaScript API (nearbySearch()) خدمة البحث عن الأماكن المجاورة في Places API لا يتيح هذا الطلب تحديد الحقول التي سيتم عرضها. يعرض الردّ قائمة بالمواقع الجغرافية ومجموعة فرعية من حقول البيانات المتوافقة. يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	إذا قدّمت طلب بحث بالقرب منك، مثل NearbySearch (San Francisco, 100 meters) تعرض فاتورتك رموز التخزين التعريفية التالية عند عرض فاتورتك حسب رمز التخزين التعريفي: مكان البيانات الأساسية بيانات الاتصال بيانات الغلاف الجوي
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

يُستخدَم رمز التخزين التعريفي هذا لإصدار الفواتير مقابل الطلبات المرسَلة إلى خدمة "البحث النصي عن الأماكن".

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تفعيل الفوترة للطلبات المقدَّمة إلى الخدمات التالية: خدمة البحث عن الأماكن النصية في Maps JavaScript API (textSearch()). خدمة البحث النصي في Places API تعرِض طلبات البحث النصي قائمة بالأماكن، ولكن لا تتيح تحديد الحقول التي يتم عرضها. تعرض طلبات "البحث النصي" مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث النصي بالإضافة إلى جميع رموز التخزين التعريفية لأنواع البيانات: البيانات الأساسية، بيانات الاتصال، بيانات الغلاف الجوي. يتم أيضًا تنشيط رمز التخزين التعريفي للبحث عن الأماكن باستخدام نص من خلال العنصر المكوّن "مربّع البحث عن الأماكن" في واجهة برمجة تطبيقات JavaScript لخرائط Google: getPlaces() بعد أن يختار المستخدم طلب بحث عن مكان (الرمز: المكبّر)، وليس نتيجة (الرمز: دبوس)، كما هو موضّح هنا:
	مثال	إذا قدّمت طلب بحث نصي، مثل TextSearch(123 Main Street)، تعرِض فاتورتك رموز التخزين التعريفية التالية عند عرض فاتورتك حسب رمز التخزين التعريفي: مكان - البحث باستخدام نص البيانات الأساسية بيانات الاتصال بيانات الغلاف الجوي
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب
	عوامل التفعيل	يتم تفعيل الفوترة لما يلي: Android: المكالمات إلى fetchPhoto() iOS: طلبات الاتصال loadPlacePhoto: JavaScript: لتحميل مكتبة "الأماكن" وخدمة "صور الأماكن" في واجهة برمجة التطبيقات JavaScript لخرائط Google عند طلب البيانات من عناوين URL التي يعرضها PlacePhoto.getUrl() لتحميل بيانات وحدات بكسل الصور ولا يتم تفعيل الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات وحدة البكسل. خدمة الويب: طلبات إلى خدمة "صور الأماكن" في Places API
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

• ‫Places API (الإصدار الجديد): الحدّ الأقصى للمعدل هو 600 طلب كل دقيقة (طلبات في الدقيقة) لكل طريقة لواجهة برمجة التطبيقات لكل مشروع. وهذا يعني أنّ لكل طريقة من طرق واجهة برمجة التطبيقات حصة منفصلة.

• ‫Places API: الحدّ الأقصى للمعدل هو 6,000 طلب في الدقيقة (طلبات في الدقيقة). ويتم احتسابه على أنّه مجموع الطلبات من جهة العميل ومن جهة الخادم لجميع التطبيقات التي تستخدم بيانات اعتماد المشروع نفسه.

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

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