خطأ: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
تستخدم حزمة تطوير برامج الأماكن لأجهزة Android نموذج أسعار الدفع حسب الاستخدام. تُحصَّل رسوم حزمة تطوير برامج الأماكن لأجهزة Android التي تخصّ حزمة تطوير برامج الأماكن لأجهزة Android من خلال رمز التخزين التعريفي. إلى جانب بنود استخدام Google العامة، هناك حدود استخدام خاصة بحزمة تطوير برامج الأماكن لأجهزة Android. يمكنك إدارة التكاليف والاستخدام من خلال الأدوات المتاحة في Google Cloud Console.
كيفية فوترة حزمة تطوير برامج الأماكن لأجهزة Android
تستخدم حزمة تطوير برامج الأماكن لأجهزة Android (الجديدة) وحزمة تطوير برامج الأماكن لنظام التشغيل Android نموذج أسعار الدفع حسب الاستخدام. تتم فوترة واجهات برمجة التطبيقات في "منصة خرائط Google" وحِزم تطوير البرامج (SDK) من خلال رمز التخزين التعريفي. يتم تتبُّع الاستخدام لكل رمز تخزين تعريفي، وقد تتضمّن أي واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) أكثر من رمز تخزين تعريفي واحد للمنتج. ويتم احتساب التكلفة على النحو التالي:
استخدِم حاسبة الأسعار والاستخدام لتقدير تكلفة الاستخدام لكل واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK). بالنسبة إلى رموز التخزين التعريفية المؤهلة في "منصة خرائط Google"، يتوفر رصيد بقيمة 200 دولار أمريكي (أو ما يعادله بالعملة المحلية) على "منصة خرائط Google" كل شهر لكل حساب فوترة. يتم تطبيق هذا الرصيد تلقائيًا 1 على رموز التخزين التعريفية المؤهَّلة.
أسعار حزمة تطوير برامج الأماكن لأجهزة Android (جديدة)
لمحة عن أقنعة الحقول
استخدام أقنعة الحقول، التي يُطلق عليها أيضًا قوائم الحقول، في طلباتك لتحديد قائمة الحقول المطلوب عرضها في الاستجابة تتم بعد ذلك تحصيل رسوم منك أعلى رمز تخزين تعريفي ينطبق على طلبك. وهذا يعني أنّه في حال اختيار الحقول في كلّ من رمز التخزين التعريفي (الأساسي) ورمز التخزين التعريفي (المتقدّم)، سيتم تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي (المتقدّم).
يعد استخدام قناع الحقل ممارسة تصميم جيدة لضمان عدم طلب بيانات غير ضرورية، مما يساعد على تجنب وقت المعالجة غير الضروري ورسوم الفوترة.
رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.ID
،
Place.Field.NAME
،
Place.Field.PHOTO_METADATAS
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1000) |
رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.ADDRESS_COMPONENTS
،
Place.Field.ADDRESS
،
Place.Field.LAT_LNG
،
Place.Field.PLUS_CODE
،
Place.Field.TYPES
،
Place.Field.VIEWPORT
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولارات أمريكية (أو ما يعادلها بالعملة المحلية) لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: تفاصيل المكان (أساسية)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.BUSINESS_STATUS
،
Place.Field.ICON_BACKGROUND_COLOR
،
Place.Field.ICON_URL
،
Place.Field.UTC_OFFSET
،
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.0170 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: تفاصيل المكان (إعدادات متقدّمة)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.CURRENT_OPENING_HOURS
،
Place.Field.SECONDARY_OPENING_HOURS
،
Place.Field.PHONE_NUMBER
،
Place.Field.PRICE_LEVEL
،
Place.Field.RATING
،
Place.Field.OPENING_HOURS
،
Place.Field.USER_RATINGS_TOTAL
،
Place.Field.WEBSITE_URI
.
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: تفاصيل المكان (يُفضَّل)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.CURBSIDE_PICKUP
،
Place.Field.DELIVERY
،
Place.Field.DINE_IN
،
Place.Field.EDITORIAL_SUMMARY
،
Place.Field.RESERVABLE
،
Place.Field.REVIEWS
،
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
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1000) |
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: البحث النصي (المعرّف فقط)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.ID
،
Place.Field.NAME
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1000) |
رمز التخزين التعريفي: البحث النصي (أساسي)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.ADDRESS_COMPONENTS
،
Place.Field.BUSINESS_STATUS
،
Place.Field.ADDRESS
،
Place.Field.ICON_BACKGROUND_COLOR
،
Place.Field.ICON_URL
،
Place.Field.LAT_LNG
،
Place.Field.PHOTO_METADATAS
،
Place.Field.PLUS_CODE
،
Place.Field.TYPES
،
Place.Field.UTC_OFFSET
،
Place.Field.VIEWPORT
،
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: البحث النصي (متقدم)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.CURRENT_OPENING_HOURS
،
Place.Field.SECONDARY_OPENING_HOURS
،
Place.Field.PHONE_NUMBER
،
Place.Field.PRICE_LEVEL
،
Place.Field.RATING
،
Place.Field.OPENING_HOURS
،
Place.Field.USER_RATINGS_TOTAL
،
Place.Field.WEBSITE_URI
.
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: البحث النصي (مفضّل)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك حصر الاستجابة على الحقول المحدّدة فقط. يتم تشغيل رمز التخزين التعريفي هذا عندما تطلب الحقول التالية فقط:
نظام التشغيل Android:
Place.Field.CURBSIDE_PICKUP
،
Place.Field.DELIVERY
،
Place.Field.DINE_IN
،
Place.Field.EDITORIAL_SUMMARY
،
Place.Field.RESERVABLE
،
Place.Field.REVIEWS
،
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
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: صورة المكان
يتم تحصيل رسوم رمز تخزين تعريفي لصورة المكان مقابل كل طلب لواجهة برمجة التطبيقات.
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
أسعار حزمة تطوير برامج الأماكن لأجهزة Android
لمحة عن جلسات الإكمال التلقائي
تشتمل جلسة الإكمال التلقائي على بعض طلبات الإكمال التلقائي (لاسترداد اقتراحات حول مكان ما يكتبه المستخدم)، بالإضافة إلى طلب واحد على الأكثر لتفاصيل الأماكن (لاسترداد تفاصيل عن المكان الذي اختاره المستخدم). يتم تمرير الرمز المميز نفسه للجلسة إلى الإكمال التلقائي وطلب تفاصيل المكان اللاحق. تبدأ الجلسة بطلب الإكمال التلقائي الأول (والذي يحدث عادةً عندما يبدأ المستخدم في الكتابة). يتم إجراء استدعاء "تفاصيل الأماكن" عندما يحدد المستخدم أحد اقتراحات الإكمال التلقائي. إذا لم يحدد المستخدم اقتراحًا، فلن يتم إجراء استدعاء لـ "تفاصيل الأماكن".
بعد أن يختار المستخدم مكانًا (أي إجراء استدعاء "تفاصيل الأماكن")، يجب أن تبدأ جلسة جديدة باستخدام رمز جلسة جديد.
ويمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:
- خدمة الإكمال التلقائي لمكان "واجهة برمجة تطبيقات الأماكن" أو خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". يجب تصميم تطبيقك لتوفير الرموز المميّزة للجلسة (قد تحتاج إلى تغيير الرمز الحالي).
- أداة الإكمال التلقائي في Maps JavaScript API. يتم تفعيل الفوترة المستندة إلى الجلسات تلقائيًا في هذه التطبيقات المصغّرة، بدون الحاجة إلى تغيير الرمز.
يصلح الرمز المميز للجلسة إلى جلسة مستخدم واحدة، ويجب عدم استخدامه لأكثر من جلسة مستخدم واحدة. إذا أعدت استخدام رمز مميّز للجلسة، سيتم اعتبار الجلسة غير صالحة ويتم تحصيل رسوم من الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.
يتم تحصيل فواتير طلبات الإكمال التلقائي وطلبات "تفاصيل الأماكن" باستخدام الجلسات على رموز تخزين تعريفية مختلفة.
لمحة عن رموز التخزين التعريفية لبيانات الأماكن
رموز التخزين التعريفية الثلاثة لبيانات الأماكن هي: البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي.يتم تشغيل رمز تخزين تعريفي واحد أو أكثر للبيانات لـ:
- 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.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.003 دولار أمريكي لكل 1,003 دولار أمريكي (+ 3.00 دولار أمريكي لكل 1,000) |
تكلفة طلب الأماكن + 0.0024 دولار أمريكي لكل منها (+ 2.40 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: بيانات الغلاف الجوي
باستخدام معلمة الحقول في طلب تفاصيل المكان أو طلب البحث عن مكان، يمكنك تقييد الاستجابة إلى تلك الحقول المحددة فقط. ينتج عن الحقول في فئة Atmo المعروفة تحصيل رسوم إضافية. يتم تشغيل رمز التخزين التعريفي لبيانات الغلاف الجوي عند طلب أي من هذه الحقول:
- أجهزة 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.005 دولار أمريكي لكل منها (+ 5.00 دولار أمريكي لكل 1,000) |
تكلفة طلب الأماكن + 0.004 دولار أمريكي لكل 1,004 دولار أمريكي (+ 4.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الإكمال التلقائي – لكل طلب
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي - لكل طلب لأي من هذه المكالمات أو الطلبات التي لا تتضمن رمزًا مميزًا للجلسة:
- على أجهزة Android:
findAutocompletePredictions()
- نظام التشغيل iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: خدمة الإكمال التلقائي للأماكن من واجهة برمجة تطبيقات JavaScript للخرائط
- خدمة الويب: خدمة الإكمال التلقائي لمكان واجهة برمجة تطبيقات الأماكن
يتم أيضًا تحصيل رمز إكمال تلقائي - لكل طلب، عن المكالمات التي تتم من خلال جلسة إكمال تلقائي غير صالحة (على سبيل المثال، جلسة تعيد استخدام رمز مميز للجلسة).
قد يتم تحصيل رسوم إكمال تلقائي - لكل طلب SKU في حال إجراء استدعاءات من جلسة إكمال تلقائي غير صالحة، وذلك لطلبات الإكمال التلقائي من Maps JavaScript API. وقد يحدث ذلك عندما يكتب المستخدم عدة عناوين مختلفة أو ينسخ/يلصق عناوين مختلفة في التطبيق المصغَّر ولا يختار دائمًا عبارة بحث مقترحة للإكمال التلقائي.
النطاق الزمني الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة مقابل جلسة الإكمال التلقائي التي لا تتضمّن طلب تفاصيل المكان (خلال بضع دقائق من بداية الجلسة).
النطاق الزمني الشهري (السعر لكل جلسة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
مثال
فإذا أصدر تطبيقك هاتين المكالمتين في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- PlacesClient?.findAutocompleteReplies(fromQuery: "par" ...
- PlacesClient?.findAutocompleteReplies(fromQuery: "paris" ...
خدمة الويب
- طلب الإكمال التلقائي للمكان (input=”par”, session_token: XYZ)
- طلب الإكمال التلقائي لتقديم المكان (input=”paris”, session_token: XYZ)
سيظهر في فاتورتك رمز التخزين التعريفي هذا (عند الاطّلاع على الفاتورة حسب رمز التخزين التعريفي):
- الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة (يبدأ السعر من 0.017 دولار أمريكي للجلسة)
رمز التخزين التعريفي: الإكمال التلقائي (مضمّن مع تفاصيل المكان) - لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي للإكمال التلقائي (المضمّن مع تفاصيل المكان) - لكل جلسة مقابل جلسة الإكمال التلقائي التي تتضمّن أيًا مما يلي:
- Android: مكالمة إلى
fetchPlace()
- iOS: مكالمة إلى
fetchPlaceFromPlaceID:
- خدمة الويب: طلب "تفاصيل المكان"
يتوفّر طلب الإكمال التلقائي بدون أي رسوم، ويتم تحصيل الرسوم مقابل المكالمة "تفاصيل المكان" اللاحقة بناءً على أسعار "تفاصيل المكان" العادية.
ينشئ طلب "تفاصيل المكان" رموز تخزين تعريفية للبيانات (أساسي و/أو جهة الاتصال و/أو الغلاف الجوي) استنادًا إلى الحقول التي يتم تحديدها في الطلب.
إذا لم تحدّد حقولاً في طلب "تفاصيل المكان"، سيتم تشغيل جميع رموز التخزين التعريفية للبيانات (الأساسية وجِهة الاتصال والغلاف الجوي).
يتم إصدار فواتير لطلبات تحديث معرّف تفاصيل المكان (الطلبات التي تحدّد الحقل place_id
فقط) أثناء جلسة الإكمال التلقائي على أنّها رمز التخزين التعريفي: الإكمال التلقائي
بدون تفاصيل المكان - لكل جلسة.
النطاق الزمني الشهري (السعر لكل جلسة) |
||
---|---|---|
0.00 USD | 0.00 USD | 0.00 USD |
مثال
إذا أصدر تطبيقك المكالمات الثلاث التالية في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (باستخدام
FetchPlaceRequest
بما في ذلك رقم تعريف المكان والحقل ADDRESS)
iOS
- PlacesClient?.findAutocompleteReplies(fromQuery: "par" ...
- PlacesClient?.findAutocompleteReplies(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.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم إنشاء رمز التخزين التعريفي لتفاصيل المكان من واجهات برمجة التطبيقات التالية:
- Android: حزمة تطوير برامج الأماكن لأجهزة Android
(
fetchPlace()
) - iOS: حزمة SDK لتطبيق "الأماكن" لنظام التشغيل iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
خدمة "تفاصيل المكان" في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (
getDetails
) - JavaScript:
أداة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (
getPlace
) - JavaScript:
أداة Place SearchBox API في "خرائط Google": طريقة
getPlaces()
بعد أن يختار المستخدم نتيجة المكان (رمز: تثبيت)، *وليس* طلب بحث (رمز: مكبّر)، كما هو موضّح هنا: - خدمة الويب: خدمة Places API Place
باستخدام واجهة برمجة التطبيقات على الويب والخدمات، يتم تحصيل الرسوم من رمز التخزين التعريفي لتفاصيل المكان سواء تم توفير رمز مميز للجلسة أم لا.
يؤدي طلب أو طلب تفاصيل المكان أيضًا إلى إنشاء رموز تخزين تعريفية للبيانات (أساسي، و/أو جهة الاتصال، و/أو الغلاف الجوي)، بناءً على الحقول التي تم تحديدها في المكالمة أو الطلب. إذا تم تحديد لا من الحقول في استدعاء "تفاصيل المكان" أو الطلب، يتم تشغيل جميع رموز التخزين التعريفية للبيانات، ويتم تحصيل رسوم منك مقابل مكالمة أو طلب "تفاصيل الأماكن" بالإضافة إلى تكلفة جميع البيانات.
أمثلة
- يُرجى إجراء أحد المكالمات أو الطلبات التالية:
- الأجهزة الجوّالة: يمكنك استدعاء
fetchPlace()
على Android أوfetchPlaceFromPlaceID:
على iOS، وتحديد الحقلADDRESS
فقط. - خدمة أو واجهة برمجة تطبيقات الويب: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل العنوان فقط:
getPlaceDetails(fields: formatted_address)
- تفاصيل المكان (السعر الذي يبدأ من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (فواتير بقيمة 0.00 دولار أمريكي)
- الأجهزة الجوّالة: يمكنك استدعاء
- يُرجى إجراء أحد المكالمات أو الطلبات التالية:
- الأجهزة الجوّالة: يمكنك استدعاء
fetchPlace()
على Android أوfetchPlaceFromPlaceID:
على iOS، وتحديد الحقلPHONE_NUMBER
فقط. - خدمة أو واجهة برمجة تطبيقات الويب: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل رقم الهاتف:
getPlaceDetails(fields: formatted_phone_number)
- تفاصيل المكان (السعر الذي يبدأ من 0.017 دولار أمريكي لكل جلسة)
- بيانات الاتصال (يبدأ السعر من 0.003 SAR لكل طلب)
- الأجهزة الجوّالة: يمكنك استدعاء
- يُرجى إجراء أحد المكالمات أو الطلبات التالية:
- الجهاز الجوّال: يمكنك استدعاء "
fetchPlace()
" على نظام التشغيل Android أو "fetchPlaceFromPlaceID:
" على نظام التشغيل iOS، وتحديد جميع الحقول. - خدمة أو واجهة برمجة تطبيقات الويب: يمكنك تقديم طلب "تفاصيل المكان" وتحديد جميع الحقول (هذا النوع من
الطلبات هو الإعداد التلقائي إذا لم تحدّد أي حقول):
getPlaceDetails()
.
- تفاصيل المكان (السعر الذي يبدأ من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (فواتير بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 SAR لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 SAR لكل طلب)
- الجهاز الجوّال: يمكنك استدعاء "
رمز التخزين التعريفي: البحث عن المكان الحالي
يتم تحصيل رسوم مقابل المكالمات إلى
findCurrentPlace()
(نظام التشغيل Android)
أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(نظام التشغيل iOS).
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.030 دولار أمريكي لكل (30.00 دولار أمريكي لكل 1,000) |
0.024 دولار أمريكي لكل (24.00 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
تؤدي الطلبات إلى findCurrentPlace()
(Android) أو
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)
أيضًا إلى إنشاء رموز تخزين تعريفية للبيانات (أساسي، و/أو جهة الاتصال، و/أو
Atmo العاملين)، استنادًا إلى الحقول التي يتم تحديدها في المكالمة.
يمكنك تحديد حقول البيانات لحصر الاستجابة بتلك الحقول فقط. يتم تحصيل رسوم منك مقابل استدعاء "العثور على المكان الحالي"
بالإضافة إلى البيانات المطلوبة.
أمثلة
- يمكنك استدعاء
findCurrentPlace()
(Android) أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) وتحديد الحقلADDRESS
فقط. ستظهر في فاتورتك رموز التخزين التعريفية التالية (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):- العثور على المكان الحالي (السعر الذي يبدأ من 0.030 دولار أمريكي لكل طلب)
- البيانات الأساسية (فواتير بقيمة 0.00 دولار أمريكي)
- عليك استدعاء
findCurrentPlace()
(Android) أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) وتحديد الحقلPHONE_NUMBER
. ستظهر في فاتورتك رموز التخزين التعريفية التالية (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):- العثور على المكان الحالي (السعر الذي يبدأ من 0.030 دولار أمريكي لكل طلب)
- بيانات الاتصال (يبدأ السعر من 0.003 SAR لكل طلب)
- يمكنك استدعاء
findCurrentPlace()
(Android) أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) وتحديد الحقول من جميع مجموعات أنواع البيانات الثلاث. ستظهر في فاتورتك رموز التخزين التعريفية التالية (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):- العثور على المكان الحالي (السعر الذي يبدأ من 0.030 دولار أمريكي لكل طلب)
- البيانات الأساسية (فواتير بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 SAR لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 SAR لكل طلب)
رمز التخزين التعريفي: صورة المكان
يتم تحصيل رسوم رمز التخزين التعريفي لصورة المكان مقابل:
- Android: مكالمات إلى
fetchPhoto()
- iOS: من المكالمات إلى
loadPlacePhoto:
- JavaScript: إلى مكتبة الأماكن، وخدمة "صور الأماكن" في "واجهة برمجة تطبيقات JavaScript" عند طلب بيانات من عناوين URL التي يعرضها
PlacePhoto.getUrl()
لتحميل بيانات بكسل الصور. - خدمة الويب: طلبات إلى خدمة صور المكان في واجهة برمجة تطبيقات الأماكن
بالنسبة إلى خدمة JavaScript، لا يؤدي استدعاء طريقة PlacePhoto.getUrl()
إلى الفوترة إلى أن يتم استخدام عنوان URL للحصول على بيانات البكسل.
النطاق الزمني الشهري (السعر لكل مكالمة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد. |
قيود بنود الاستخدام
للحصول على معلومات عن بنود الاستخدام، اطّلِع على قسم "قيود الترخيص" في "بنود خدمة منصة خرائط Google".
إدارة تكلفة الاستخدام
لإدارة تكاليف استخدامك لحزمة تطوير برامج الأماكن لنظام التشغيل Android أو لتلبية متطلبات زيارات الإنتاج، يمكنك تعيين حدود للحصة اليومية على جميع الطلبات الواردة إلى أي واجهة برمجة تطبيقات. تتم إعادة تعيين الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.
لعرض أو تغيير حدود الحصة المسموح بها لحزمة تطوير برامج الأماكن لأجهزة Android:
- في Cloud Console، افتح صفحة حصص الحصص في "منصة خرائط Google".
- انقر على القائمة المنسدلة لواجهات برمجة التطبيقات وحدد حزمة SDK للأماكن لنظام التشغيل Android.
- للاطّلاع على حدود الحصة، انتقِل للأسفل وصولاً إلى بطاقة الطلبات.
جدول يسرد أسماء الحصص وحدودها. - لتغيير حد حصة معيّنة، انقر على رمز التعديل لهذا الحدّ.
في مربّع الحوار الذي يظهر، في الحقل حدّ الحصّة المسموح بها، أدخِل الحدّ الأقصى للحصّة اليومية القابلة للفوترة (حتى حدّ الحصّة التي تحدّدها Google، في حال توفّرها) واختَر حفظ.
فإذا وصل استخدام واجهة برمجة التطبيقات إلى الحد الأقصى للحصة القابلة للفوترة في أي يوم من الأيام، لن يتمكّن تطبيقك من الوصول إليها خلال الفترة المتبقية من ذلك اليوم.
موارد إدارة التكاليف ذات الصلة
-
على المستخدمين في الهند إنشاء حساب فوترة على Google Cloud Platform قبل إنشاء حساب فوترة على "منصة خرائط Google" لتلقّي رصيد "منصة خرائط Google".↩