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

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

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

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

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

أسعار حزمة SDK للأماكن لنظام التشغيل iOS

حول جلسات الإكمال التلقائي

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

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

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

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

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

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

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

وحدات 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 أو 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 دولارات أمريكية لكل 1000 دولار أمريكي)	تكلفة طلب الأماكن + 0.0024 دولار لكل منها (+ 2.40 USD لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد.

---

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

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

• نظام التشغيل Android: Place.Field.CURBSIDE_PICKUP أو Place.Field.DELIVERY أو 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.
• جافا سكريبت: راجع الحقول (تفاصيل المكان)
• خدمة الويب: 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 USD لكل 1000)	تكلفة طلب الأماكن زائد 0.004 دولار لكل منها (+ 4.00 USD لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد.

---

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

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

• نظام التشغيل Android: findAutocompletePredictions()
• نظام التشغيل iOS: findAutocompletePredictionsFromQuery:
• جافا سكريبت: خدمة الإكمال التلقائي لـ JavaScript API للخرائط
• خدمة الويب: خدمة الإكمال التلقائي لواجهة برمجة تطبيقات الأماكن

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

قد يتم تحصيل رسوم من خدمة الإكمال التلقائي لطلبات من أداة الإكمال التلقائي لـ "واجهة برمجة تطبيقات 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

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

iOS

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

خدمة ويب

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

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

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

---

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

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

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

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

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

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

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

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

مثال

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

Android

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

iOS

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

خدمة ويب

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

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

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

---

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

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

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

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

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

  

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

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

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

أمثلة

1. نفِّذ أحد هذه المكالمات أو الطلبات:
   • الجوّال: يمكنك الاتصال بـ fetchPlace() على نظام التشغيل Android أو fetchPlaceFromPlaceID: على iOS، وتحديد الحقل ADDRESS فقط
   • واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address)
   على فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
   • تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
   • البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
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 SAR)
   • بيانات الاتصال (يبدأ السعر من 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)، يتم أيضًا إنشاء رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو Atmosphere)، بناءً على الحقول المحدّدة في المكالمة. يمكنك تحديد حقول البيانات لحصر الاستجابة في هذه الحقول فقط. يتم تحصيل رسوم منك مقابل مكالمة "البحث عن المكان الحالي" بالإضافة إلى البيانات المطلوبة.

أمثلة

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

---

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

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

• Android: مكالمات إلى fetchPhoto()
• iOS: مكالمات صادرة إلى loadPlacePhoto:
• JavaScript: عند الانتقال إلى Library Places, Maps JavaScript's Place Photos Service عند طلب بيانات من عناوين 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 دولار أمريكي)	يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد.

---

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

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

• يبلغ الحدّ الأقصى لمعدّل الزحف 100 طلب في الثانية. ويتم حسابها من خلال مجموع الطلبات من جانب العميل وجميع الطلبات المقدمة من جانب الخادم لجميع التطبيقات باستخدام بيانات اعتماد المشروع نفسه.

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

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

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

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

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

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

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

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

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