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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

• أجهزة 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 أو 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 أو 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_VEGETARIAN_FOOD أو Place.Field.SERVES_WINE أوPlace.Field.TAKEOUT أو Place.Field.USER_RATINGS_TOTALPlace.Field.SERVES_LUNCH
• 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: خدمة الإكمال التلقائي للأماكن من خلال واجهة برمجة التطبيقات JavaScript API
• خدمة الويب: خدمة الإكمال التلقائي لمكان المكان

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

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

نطاق الحجم الشهري (السعر لكل طلب)
من 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

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

iOS

• placeClient?.findAutocompleteForecastions(fromQuery: "par" ...
• placeClient?.findAutocompleteForecastions(fromQuery: "paris" ...

خدمة الويب

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

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

• الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة (يبدأ السعر من 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

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

iOS

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

خدمة الويب

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

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

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

---

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

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

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

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

• نظام التشغيل Android: حزمة تطوير البرامج لأماكن Google لأجهزة Android (fetchPlace())
• iOS: Places SDK for iOS (fetchPlaceFromPlaceID:)
• JavaScript: خدمة "تفاصيل المكان" من واجهة برمجة تطبيقات JavaScript للخرائط (getDetails)
• JavaScript: أداة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (getPlace)
• JavaScript: أداة Place SearchBox في واجهة برمجة تطبيقات "خرائط Google": getPlaces() بعد أن يختار المستخدم نتيجة مكان (رمز: تثبيت)، *وليس* طلب بحث (رمز: المكبِّر)، كما هو موضّح هنا:

  

• خدمة الويب: خدمة Places API في Place

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

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

أمثلة

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

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

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

---

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

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

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

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

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

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

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

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

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

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

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

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