حزمة تطوير برامج الأماكن المخصّصة لاستخدام Android والفوترة

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الخطأ: 9005 PLACES_API_rate_LIMIT_EXCEEDED

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

كيفية تحرير فواتير حزمة تطوير البرامج (SDK) لأماكن Android

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

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

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

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

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

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

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

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

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

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

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

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

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

تُنشئ طلبات البيانات رسومًا بالإضافة إلى تكلفة طلب "الأماكن". تكون رسوم البيانات جنبًا إلى جنب مع طلبات الأماكن.


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

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

Android

address_component أو adr_address أو business_status أو formatted_address أو geometry أو icon أو icon_mask_base_uri أو icon_background_color أوname أو permanently_closed أو photo أو type أو url أو utc_offset أو vicinity

iOS

GMSPlaceFieldFormattedAddress أو GMSPlaceFieldBusinesssStatus أو 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

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

SKU: بيانات الاتصال

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

Android

OPENING_HOURS أو PHONE_NUMBER أو WEBSITE_URI

iOS

GMSPlaceFieldOpeningHours أو GMSPlaceFieldPhoneNumber أو GMSPlaceFieldWebsite

خدمة ويب

formatted_phone_number أو international_phone_number أو opening_hours أو website

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

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

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

  • Android: PRICE_LEVEL أو RATING أو USER_RATINGS_TOTAL
  • iOS: GMSPlaceFieldPriceLevel أو GMSPlaceFieldRating أو GMSPlaceFieldUserRatingsTotal
  • JavaScript: يُرجى الاطّلاع على الحقول (تفاصيل المكان).
  • خدمة الويب: تتوفّر خدمة curbside_pickup أو delivery أو dine_in أو price_level أو rating أو review أو takeout أو user_ratings_total
نطاق القيمة الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب الأماكن
+ 0.005 دولار أمريكي لكل واحدة
(+ 5.00 SAR لكل 1,000)
تكلفة طلب الأماكن
+ 0.004 دولار أمريكي لكل واحدة
(+ 4.00 دولارات أمريكية لكل 1,000 دولار أمريكي)
تواصَل مع فريق المبيعات لمعرفة سعر البيع.

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة ويب

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

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

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

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

  • 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

iOS

خدمة ويب

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

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

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

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

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

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

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

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

أمثلة

  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، وتحديد جميع الحقول
    • واجهة برمجة التطبيقات أو خدمة الويب: أدخِل طلب تفاصيل المكان وحدِّد جميع الحقول (هذا النوع من الطلب هو الإعداد التلقائي في حال عدم تحديد أي حقول): 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 دولار أمريكي لكل 1000 دولار أمريكي)
0.024 دولار أمريكي لكل
(24.00 دولار أمريكي لكل 1000 دولار أمريكي)
تواصَل مع فريق المبيعات لمعرفة سعر البيع.

تنشئ أيضًا المكالمات إلى 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 دولار أمريكي لكل طلب)

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

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

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

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

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

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

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

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

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

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

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


  1. على المستخدمين في الهند إنشاء حساب فوترة على Google Cloud Platform قبل إنشاء حساب فوترة على "منصة خرائط Google" للحصول على رصيد في "منصة خرائط Google".