تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

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

بالنسبة إلى طلبات البحث "تفاصيل الأماكن" (جديد) و"البحث في الأماكن القريبة" (جديد) و"البحث النصي" (جديد)، استخدِم العنوان 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` `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` إذا أنهيت جلسة "الإكمال التلقائي" من خلال طلب بيانات عن "تفاصيل المكان" يطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسي أو متقدّم أو مفضّل)، يتم تحصيل رسوم الطلب وفقًا لرمز التخزين التعريفي: تفاصيل المكان (مفضّل). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
	أمثلة على الفوترة باستخدام قناع الحقل	في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول. إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا. إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار 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` ^* البحث النصي والبحث عن الأماكن المجاورة فقط إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
	أمثلة على الفوترة باستخدام قناع الحقل	في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول. إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا. إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	Category (الفئة)	Pro
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط أو الحقول ذات معدّل السعر الأدنى: خدمة الويب: `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.primaryType` `places.primaryTypeDisplayName` `places.pureServiceAreaBusiness` `places.shortFormattedAddress` `places.subDestinations` `places.types` `places.utcOffsetMinutes` `places.viewport` ^* الحقل `places.googleMapsLinks` في مرحلة معاينة الإصدار العلني المُسبَق ولا يتم تحصيل أي رسوم، أي أنّ الفوترة هي 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.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
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي البيانات الأساسية عند طلب أيّ من الحقول التالية: 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`. الحقول التي سيتم إيقافها نهائيًا:تم إيقاف الحقول التالية نهائيًا في الإصدار 4.0 من حزمة SDK لتطبيق "الأماكن" على Android: `Place.Field.ADDRESS` و`Place.Field.ICON_URL` `Place.Field.LAT_LNG` و`Place.Field.NAME` `Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE` ويمكنك بدلاً من ذلك استخدام `Place.Field.FORMATTED_ADDRESS` و`Place.Field.ICON_MASK_URL` `Place.Field.LOCATION` `Place.Field.DISPLAY_NAME` و`Place.ACCESSIBILITY_OPTIONS` على التوالي. لا تتوفّر `Place.Field.ACCESSIBILITY_OPTIONS` إلا لميزة "تفاصيل المكان" (الجديدة). أجهزة 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.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

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

	Category (الفئة)	Enterprise
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تنشيط رمز التخزين التعريفي Contact Data عند طلب أيّ من الحقول التالية: Android: `Place.Field.CURRENT_OPENING_HOURS` أو `Place.Field.INTERNATIONAL_PHONE_NUMBER` أو `Place.Field.OPENING_HOURS` أو `Place.Field.SECONDARY_OPENING_HOURS` أو `Place.Field.WEBSITE_URI` الحقول التي سيتم إيقافها نهائيًا: تم إيقاف الحقل `Place.Field.PHONE_NUMBER` نهائيًا في الإصدار 4.0 من حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لأجهزة Android. استخدِم `Place.Field.INTERNATIONAL_PHONE_NUMBER` بدلاً من ذلك. 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
	الحدث القابل للفوترة	الطلب باستخدام أقنعة الحقول المحدّدة
	عوامل التفعيل	يتم تفعيل الفوترة عند طلب أيّ من الحقول التالية: AndroidiOSJavaScript `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` الحقول التي سيتم إيقافها نهائيًا: تم إيقاف الحقل `Place.Field.USER_RATINGS_TOTAL` نهائيًا في الإصدار 4.0 من حزمة تطوير برامج "الأماكن" لنظام التشغيل Android. استخدِم `Place.Field.USER_RATING_COUNT` بدلاً من ذلك. `GMSPlaceFieldPriceLevel` `GMSPlaceFieldRating` `GMSPlaceFieldUserRatingsTotal` `GMSPlaceFieldTakeout` `GMSPlaceFieldDelivery` `GMSPlaceFieldDineIn` `GMSPlaceFieldCurbsidePickup` `GMSPlaceFieldReservable` `GMSPlaceFieldServesBreakfast` `GMSPlaceFieldServesLunch` `GMSPlaceFieldServesDinner` `GMSPlaceFieldServesBeer` `GMSPlaceFieldServesWine` `GMSPlaceFieldServesBrunch` `GMSPlaceFieldServesVegetarianFood`. اطّلِع على الحقول (تفاصيل المكان) `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`.
	أمثلة على الفوترة باستخدام قناع الحقل	في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول. إذا كانت قناع حقول الطلب لا تتضمّن سوى حقول من رمز التخزين التعريفي هذا: يتم تحصيل رسوم الطلب وفقًا لرقم التخزين التعريفي هذا. على سبيل المثال، يمكنك طلب حقل واحد أو أكثر من رمز التخزين التعريفي هذا، ويتم تحصيل الرسوم منك وفقًا لرقم التخزين التعريفي هذا. إذا كان قناع حقل الطلب يتضمّن حقولًا من رموز تخزين تعريفية أخرى: يتم تحصيل رسوم الطلب وفقًا لأعلى سعر رمز تخزين تعريفي للحقول المطلوبة. على سبيل المثال، إذا أدرجت حقولًا من عدة رموز تخزين تعريفية، مثل رمز تخزين تعريفي لإصدار Essentials ورمز تخزين تعريفي لإصدار Enterprise، يتمّ تحصيل رسوم الطلب وفقًا لرموز التخزين التعريفية لإصدار Enterprise.
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

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

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

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

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

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

	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 وPro وEnterprise وEnterprise + Atmosphere). حدِّد الحقول التي تحتاج إليها فقط لتجنُّب أي رسوم غير ضرورية. إذا طلبت فقط إعادة تحميل معرّف تفاصيل المكان (يحدّد طلبك حقل `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()` بعد اختيار المستخدِم نتيجة مكان (رمزها: دبوس)، وليس طلب بحث (رمزه: عدسة مكبرة)، كما هو موضّح هنا: في نتائج التطبيق المصغّر "مربّع البحث"، بعد كتابة "بيتزا" في مربّع البحث، يُرجى ملاحظة أنّ Pizza Autentico يظهر بجانبها رمز دبوس، ما يشير إلى أنّه نتيجة مكان (وليس طلب بحث). خدمة الويب: خدمة "تفاصيل الأماكن" في 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. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.
	أمثلة	توضِّح الأمثلة التالية رموز التخزين التعريفية التي يتم تحصيل رسومها منك عند تقديم طلب "العثور على المكان الحالي" وتحديد الحقول من رموز التخزين التعريفية لبيانات "البيانات الأساسية" و"جهة الاتصال" و"الجوّ". للاطّلاع على رموز التخزين التعريفية في فاتورتك، اطّلِع على فاتورتك حسب رمز التخزين التعريفي كما هو موضّح في مقالة تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي. يمكنك تقديم طلب "العثور على مكان" وتحديد حقل العنوان فقط: `FindPlace(fields: formatted_address)`. تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على مكان البيانات الأساسية يمكنك تقديم طلب "العثور على مكان" وتحديد حقل رقم الهاتف: `FindPlace(fields: formatted_phone_number)`. تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على مكان بيانات الاتصال يمكنك تقديم طلب "العثور على مكان" وتحديد حقول من جميع حِزم أنواع البيانات الثلاثة: `FindPlace(fields: formatted_address, opening_hours, price_level)`. تعرض فاتورتك رموز التخزين التعريفية التالية: العثور على مكان البيانات الأساسية بيانات الاتصال بيانات الغلاف الجوي
	التسعير	جدول الأسعار الرئيسي جدول الأسعار في الهند

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

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

	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".