حزمة تطوير برامج الأماكن لاستخدام نظام التشغيل iOS والفوترة

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

الخطأ: kGMSPlacesRateLimitExceeded

إشعار: إذا كان تطبيقك المتوافق مع نظام التشغيل iOS يواجه kGMSPlacesRateLimitExceeded أخطاء، قد تكون تستخدِم إصدارًا قديمًا من Places API. تم إيقاف الإصدار 2.7.0 من Places API نهائيًا اعتبارًا من 29 كانون الثاني (يناير) 2019، وتم إيقافه نهائيًا في 29 تموز (يوليو) 2019. يتوفّر الآن إصدار جديد من Places API. ننصحك بالتحديث إلى الإصدار الجديد في أقرب وقت ممكن. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل نقل البيانات.

تستخدِم حزمة تطوير برامج "الأماكن" لنظام التشغيل iOS نموذج الدفع حسب الاستخدام. يتم تحصيل رسوم طلبات حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل iOS من واجهة برمجة التطبيقات Places API حسب رمز التخزين التعريفي. بالإضافة إلى بنود استخدام Google العامة، هناك حدود استخدام خاصة بحزمة تطوير برامج "الأماكن" لأجهزة iOS. إدارة التكاليف ومستوى الاستخدام باستخدام الأدوات المتاحة في Google Cloud Console

كيفية تحصيل رسوم حزمة تطوير برامج "الأماكن" لنظام التشغيل iOS

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

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

إنّ أسعار ميزة "الإكمال التلقائي للأماكن" و"المكان الحالي" و"صور الأماكن" متطابقة لكلتا حِزم تطوير البرامج (SDK).

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

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

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

ملاحظة: يسري عرض "منصة خرائط Google" الذي يتضمّن رصيدًا شهريًا بقيمة 200 دولار أمريكي حتى 28 شباط (فبراير) 2025، الساعة 11:59 مساءً (بالتوقيت المحلي). اعتبارًا من 1 آذار (مارس) 2025، سيتم بدلاً من الرصيد بقيمة 200 دولار أمريكي تطبيق حدّ أقصى للاستخدام المجاني لكل واجهة برمجة تطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على الأسئلة الشائعة.

أسعار حزمة تطوير البرامج (SDK) لميزة "الأماكن" لأجهزة iOS (جديد)

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

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

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

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

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

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

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

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

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

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

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

يتم تحصيل الرسوم أيضًا في حال استخدام الرموز المميّزة للجلسات وتنفيذ أيّ مما يلي:

• يمكنك إنهاء الجلسات من خلال طلب واحد إلى "تفاصيل المكان" (جديد) يطلب أي حقول محدّدة من خلال رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
  • يتم تحصيل رسوم كل طلب من طلبات "الإكمال التلقائي (جديد)"، بما يصل إلى 12 طلبًا، باستخدامرمز التخزين التعريفي: طلبات الإكمال التلقائي.
  • يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
  ملاحظة: في حال إجراء مكالمة إلى SKU: Address Validation Preferred قبل انتهاء صلاحية رمز الجلسة، لن يتم تحصيل رسوم منك مقابل المكالمة التي تم إجراؤها باستخدام SKU: Place Details (Location Only)، وسيتم تحصيل رسوم منك مقابل جلستك استنادًا إلى SKU: Autocomplete Session Usage.
• يمكنك التخلي عن الجلسة أو إنهائها من خلال إجراء مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط). بعد ذلك، يتمّ تحصيل رسوم منك مقابل كلّ طلبات "الإكمال التلقائي (جديد)" باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.

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

---

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

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

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

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

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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الميزة التلقائية (الجديدة) وأسعار الجلسات.

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

---

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

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

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

iOS: GMSPlacePropertyPlaceID، GMSPlacePropertyName، GMSPlacePropertyPhotos

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

---

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

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

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

iOS: GMSPlacePropertyAddressComponents، GMSPlacePropertyFormattedAddress، GMSPlacePropertyCoordinate، GMSPlacePropertyPlusCode، GMSPlacePropertyTypes، GMSPlacePropertyViewport

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

---

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

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

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

iOS: GMSPlacePropertyBusinessStatus، GMSPlacePropertyIconBackgroundColor، GMSPlacePropertyIconImageURL، GMSPlacePropertyUTCOffsetMinutes، GMSPlacePropertyWheelchairAccessibleEntrance

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

---

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

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

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

iOS: GMSPlacePropertyCurrentOpeningHours، GMSPlacePropertySecondaryOpeningHours، GMSPlacePropertyPhoneNumber، GMSPlacePropertyPriceLevel، GMSPlacePropertyRating، GMSPlacePropertyOpeningHours، GMSPlacePropertyUserRatingsTotal، GMSPlacePropertyWebsite

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

---

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

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

iOS: GMSPlacePropertyCurbsidePickup، GMSPlacePropertyDelivery، GMSPlacePropertyDineIn، GMSPlacePropertyEditorialSummary، GMSPlacePropertyReservable، GMSPlacePropertyReviews، GMSPlacePropertyServesBeer، GMSPlacePropertyServesBreakfast، GMSPlacePropertyServesBrunch، GMSPlacePropertyServesDinner، GMSPlacePropertyServesLunch، GMSPlacePropertyServesVegetarianFood، GMSPlacePropertyServesWine، GMSPlacePropertyTakeout

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

---

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

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

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

iOS: GMSPlacePropertyAddressComponents، GMSPlacePropertyBusinessStatus، GMSPlacePropertyCoordinate، GMSPlacePropertyFormattedAddress، GMSPlacePropertyName، GMSPlacePropertyIconBackgroundColor، GMSPlacePropertyIconImageURL، GMSPlacePropertyPhotos، GMSPlacePropertyPlaceID، GMSPlacePropertyPlusCode، GMSPlacePropertyTypes، GMSPlacePropertyUTCOffsetMinutes، GMSPlacePropertyViewport، GMSPlacePropertyWheelchairAccessibleEntrance

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

---

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

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

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

iOS: GMSPlacePropertyCurrentOpeningHours، GMSPlacePropertySecondaryOpeningHours، GMSPlacePropertyPhoneNumber، GMSPlacePropertyPriceLevel، GMSPlacePropertyRating، GMSPlacePropertyOpeningHours، GMSPlacePropertyUserRatingsTotal، GMSPlacePropertyWebsite

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

---

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

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

iOS: GMSPlacePropertyCurbsidePickup، GMSPlacePropertyDelivery، GMSPlacePropertyDineIn، GMSPlacePropertyEditorialSummary، GMSPlacePropertyReservable، GMSPlacePropertyReviews، GMSPlacePropertyServesBeer، GMSPlacePropertyServesBreakfast، GMSPlacePropertyServesBrunch، GMSPlacePropertyServesDinner، GMSPlacePropertyServesLunch، GMSPlacePropertyServesVegetarianFood، GMSPlacePropertyServesWine، GMSPlacePropertyTakeout

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

---

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

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

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

iOS: GMSPlacePropertyPlaceID، GMSPlacePropertyName

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

---

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

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

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

iOS: GMSPlacePropertyAddressComponents، GMSPlacePropertyBusinessStatus، GMSPlacePropertyFormattedAddress، GMSPlacePropertyIconBackgroundColor، GMSPlacePropertyIconImageURL، GMSPlacePropertyCoordinate، GMSPlacePropertyPhotos، GMSPlacePropertyPlusCode، GMSPlacePropertyTypes، GMSPlacePropertyUTCOffsetMinutes، GMSPlacePropertyViewport، GMSPlacePropertyWheelchairAccessibleEntrance

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

---

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

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

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

iOS: GMSPlacePropertyCurrentOpeningHours، GMSPlacePropertySecondaryOpeningHours، GMSPlacePropertyPhoneNumber، GMSPlacePropertyPriceLevel، GMSPlacePropertyRating، GMSPlacePropertyOpeningHours، GMSPlacePropertyUserRatingsTotal، GMSPlacePropertyWebsite

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

---

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

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

iOS: GMSPlacePropertyCurbsidePickup، GMSPlacePropertyDelivery، GMSPlacePropertyDineIn، GMSPlacePropertyEditorialSummary، GMSPlacePropertyReservable، GMSPlacePropertyReviews، GMSPlacePropertyServesBeer، GMSPlacePropertyServesBreakfast، GMSPlacePropertyServesBrunch، GMSPlacePropertyServesDinner، GMSPlacePropertyServesLunch، GMSPlacePropertyServesVegetarianFood، GMSPlacePropertyServesWine، GMSPlacePropertyTakeout

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

---

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

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

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

---

أسعار حزمة تطوير برامج "الأماكن" لأجهزة iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

• Android: Place.Field.ACCESSIBILITY_OPTIONS، Place.Field.ADDRESS_COMPONENTS، Place.Field.BUSINESS_STATUS، Place.Field.DISPLAY_NAME، Place.Field.FORMATTED_ADDRESS، Place.Field.ICON_BACKGROUND_COLOR، Place.Field.ICON_MASK_URL، Place.Field.ID، Place.Field.LOCATION، Place.Field.PHOTO_METADATAS، Place.Field.PLUS_CODE، Place.Field.TYPES، Place.Field.VIEWPORT، أو Place.Field.UTC_OFFSET
ملاحظة: تم إيقاف حقول Place.Field.ADDRESS وPlace.Field.ICON_URL Place.Field.LAT_LNG وPlace.Field.NAME Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE نهائيًا في الإصدار 4.0 من حزمة SDK لتطبيق "الأماكن" على نظام التشغيل Android. استخدِم 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

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

---

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

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

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

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

---

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

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

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

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

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

---

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

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

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

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

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

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

---

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

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

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

مثال

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

Android

• 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)

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

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

---

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

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

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

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

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

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

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

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

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

مثال

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

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)

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

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

---

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

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

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

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

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

  

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

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

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

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

أمثلة

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

---

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

يتم تحصيل رسوم منك مقابل استخدام ميزة العثور على المكان الحالي عند إجراء مكالمات إلى findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

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

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

أمثلة

1. يمكنك الاتصال بـ findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد الحقل ADDRESS فقط. ستظهر رموز التخزين التعريفية التالية في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • العثور على المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
   • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
2. يمكنك الاتصال بـ findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد الحقل PHONE_NUMBER. ستظهر لك رموز التخزين التعريفية التالية في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • العثور على المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
   • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
3. يمكنك الاتصال بـ findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد الحقول من جميع الحِزم الثلاث لأنواع البيانات. ستظهر لك رموز التخزين التعريفية التالية في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • العثور على المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
   • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
   • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
   • بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

---

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

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

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

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

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

---

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

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

• الحد الأقصى للمعدل هو 6,000 طلب في الدقيقة. ويتم احتسابها كإجمالي طلبات جهة العميل وخادم لجميع التطبيقات التي تستخدم بيانات اعتماد المشروع نفسه.

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

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

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

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

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

للاطّلاع على حدود الحصة أو تغييرها لحزمة تطوير البرامج بالاستناد إلى بيانات "الأماكن" لأجهزة iOS، اتّبِع الخطوات التالية:

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

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

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

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

---