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

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

خطأ: 9005 PLACES_API_RATE_LIMIT_EXCEEDED

ملاحظة: إذا كان تطبيق Android الخاص بك يواجه أخطاء 9005 PLACES_API_RATE_LIMIT_EXCEEDED، قد يكون السبب أنك تستخدم إصدارًا متوقفًا من حزمة تطوير البرامج (SDK) للأماكن المخصّصة لأجهزة Android. تم إيقاف إصدار "خدمات Google Play" لحزمة تطوير البرامج (SDK) للأماكن في Android (على سبيل المثال com.google.android.gms:play-services-places)، اعتبارًا من 29 كانون الثاني (يناير) 2019، وتم إيقافه في 29 تموز (يوليو) 2019. يتوفّر الآن إصدار جديد من حزمة تطوير البرامج (SDK) للأماكن في نظام التشغيل Android. وننصحك بالتحديث إلى الإصدار الجديد في أقرب وقت ممكن. ولمعرفة التفاصيل، يُرجى الاطّلاع على دليل نقل البيانات.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 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 دولار أمريكي لكل 1,000)	تكلفة طلب الأماكن + 0.0024 دولار أمريكي لكل مبلغ (+ 2.40 دولار أمريكي لكل 1000)	يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد.

---

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

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

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

• 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: خدمة الإكمال التلقائي للأماكن في JavaScript من Maps
• خدمة الويب: خدمة الإكمال التلقائي للأماكن في واجهة برمجة التطبيقات للأماكن

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

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

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

iOS

• PLACESClient??findAutocompletePrediction(fromQuery: "par" ...)
• PLACESClient??findإجمالي التوقعات(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

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

iOS

• PLACESClient??findAutocompletePrediction(fromQuery: "par" ...)
• PLACESClient??findإجمالي التوقعات(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 دولار أمريكي لكل 1000)	0.0136 دولار أمريكي لكل (13.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي)	يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد.

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

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

  

  في نتائج تطبيق البحث المصغّر، بعد كتابة "بيتزا" في مربّع البحث، يُرجى ملاحظة أن البيتزا الآلية تحتوي على رمز يعني أنّ رمز{/1 نتيجة يشير إليه يشير إلى أنّ نص الرمز يشير إلى ذلك.

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

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

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

أمثلة

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 دولار أمريكي لكل طلب)

---

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

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

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

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

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

---

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

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

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

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

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

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

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

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

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

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

---

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