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

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

الخطأ: kGMSPlacesRateLimitExceeded

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

تستخدم حزمة تطوير برامج الأماكن لأجهزة iOS نموذج تسعير الدفع حسب الاستخدام. يتم تحصيل فواتير حزمة تطوير برامج الأماكن لطلبات iOS المتعلّقة بـ Places API من خلال رمز التخزين التعريفي. إلى جانب بنود استخدام Google العامة، هناك حدود استخدام الخاصة بحزمة تطوير برامج الأماكن لأجهزة iOS. يمكنك إدارة التكاليف والاستخدام باستخدام الأدوات المتاحة في Google Cloud Console.

كيفية تحصيل فواتير حزمة تطوير برامج الأماكن لأجهزة iOS

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

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

تعد أسعار الإكمال التلقائي للأماكن والأماكن الحالية وصور الأماكن هي نفسه لكلتا حِزم SDK.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

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

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

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

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

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

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

---

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

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

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

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

---

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

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

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

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)

---

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

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

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

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

---

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

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

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

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

---

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

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

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

---

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

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

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

---

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

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

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

---

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

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

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

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

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

---

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

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

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

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

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

---

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

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

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

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

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

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

---

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

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

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

مثال

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

Android

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

iOS

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

خدمة ويب

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

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

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

---

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

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

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

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

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

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

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

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

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

مثال

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

Android

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

iOS

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

خدمة ويب

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

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

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

---

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

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

النطاق الشهري للحجم (سعر المكالمة)
من 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: أداة الإكمال التلقائي للأماكن في "خرائط Google" (getPlace)
• JavaScript: أداة Place SearchBox في "واجهة برمجة تطبيقات JavaScript للخرائط": getPlaces() بعد أن يختار المستخدم نتيجة مكان (رمز: دبوس)، *وليس* طلب بحث (رمز: المكبِّر)، كما هو موضّح هنا:

  

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

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

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

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

أمثلة

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

---

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

يتم تحصيل رسوم خدمة العثور على المكان الحالي مقابل المكالمات إلى 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) أيضًا إنشاء رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو Atmosphere)، استنادًا إلى الحقول المحدّدة في المكالمة. حدِّد حقول البيانات لقصر الاستجابة على هذه الحقول فقط. تم إرسال فاتورة إليك مقابل البحث الحالي يمكنك إجراء مكالمة بالإضافة إلى البيانات المطلوبة.

أمثلة

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: للانتقال إلى مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط خدمة "صور المكان" عند طلب بيانات من عناوين URL التي تم عرضها من خلال PlacePhoto.getUrl() لتحميل بيانات بكسل الصورة
• خدمة الويب: الطلبات إلى مكان واجهة برمجة التطبيقات للأماكن خدمة "صور Google"

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

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

---

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

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

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

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

للحصول على معلومات بشأن بنود الاستخدام، يُرجى مراجعة قسم "قيود الترخيص" لبنود خدمة Google Maps Platform

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

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

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

لعرض أو تغيير الحصص المسموح بها في حزمة تطوير برامج الأماكن لأجهزة iOS:

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

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

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

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

---