تستخدم واجهة برمجة تطبيقات JavaScript للخرائط نموذج تسعير "الدفع حسب الاستخدام". تنشئ طلبات واجهة برمجة تطبيقات JavaScript للخرائط استدعاءات لرمزَي تخزين تعريفيَين مختلفَين استنادًا إلى نوع الطلب: عمليات تحميل الخريطة أو الصور البانورامية. المكالمات إلى مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط و يتم تسعير خدمات JavaScript الأخرى بشكل منفصل. من رموز التخزين التعريفية الأصلية لـ JavaScript. إلى جانب بنود استخدام Google العامة، هناك حدود استخدام الخاصة بواجهة برمجة تطبيقات JavaScript للخرائط. يمكنك إدارة التكاليف والاستخدام باستخدام الأدوات المتاحة في Google Cloud Console.
كيفية فوترة واجهة برمجة تطبيقات JavaScript للخرائط
تستخدم واجهة برمجة تطبيقات JavaScript للخرائط نموذج تسعير "الدفع حسب الاستخدام". واجهات برمجة التطبيقات في Google Maps Platform وتتم فوترة حِزم تطوير البرامج (SDK) من خلال رمز التخزين التعريفي. يتم تتبُّع الاستخدام لكل رمز تخزين تعريفي، وقد تحتوي أي واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) على أكثر من رمز تخزين تعريفي واحد. رمز التخزين التعريفي للمنتج. يتم حساب التكلفة على
استخدام التسعير الخاص بنا و"الآلة الحاسبة للاستخدام" لتقدير تكلفة الاستخدام لكل واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK). بالنسبة إلى الأهلية رموز التخزين التعريفية في Google Maps Platform، رصيد في Google Maps Platform بقيمة 200 دولار أمريكي كل شهر لكل حساب فوترة. تتم إضافة هذا الرصيد تلقائيًا سيتم تطبيقها على رموز التخزين التعريفية المؤهّلة.
التسعير لواجهة برمجة تطبيقات JavaScript للخرائط
رمز التخزين التعريفي: الخرائط الديناميكية
تطبيق يعرض خريطة محملة برقم تعريف الخريطة أو بدونها باستخدام Maps JavaScript API أو خريطة مع رقم تعريف الخريطة واستخدام أي مما يلي: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS
نطاق الحجم الشهري (السعر لكل تحميل خريطة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
لا تُعتبر تفاعلات المستخدم مع الخريطة، مثل العرض الشامل أو التكبير/التصغير أو تبديل طبقات الخريطة، إنشاء أحمال خريطة إضافية.
رمز التخزين التعريفي: التجوّل الافتراضي الديناميكي
يتم الآن تحصيل رسوم صور "التجوّل الافتراضي" البانورامية وتحميلات الخريطة بشكل منفصل. صورة بانورامية ديناميكية لميزة "التجوّل الافتراضي" مقابل كل مثيل لكائن بانوراما في Maps JavaScript API، حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android تطبيق حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS.
النطاق الشهري (السعر لكل PANORAMA) |
||
---|---|---|
0.014 دولار أمريكي لكل (14.00 دولار أمريكي لكل 1,000) |
0.0112 دولار أمريكي لكل (11.20 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
يحدث مثيل لكائن بانوراما:
- في JavaScript، مع
google.maps.StreetViewPanorama()
الصف أوMap.getStreetView()
. بالإضافة إلى ميزة "التجوّل الافتراضي" المدمجة القائمة على التحكم في دليل "التجوّل الافتراضي" أو استخدام يتم تحصيل رسوم الصفStreetViewService()
. - على Android، باستخدام أحد
StreetViewPanoramaFragment
،SupportStreetViewPanoramaFragment
، أوStreetViewPanoramaView
صفًا. ويتم حساب بانوراما في كل مرة ذات الصلةonCreate()
. - على iOS، باستخدام
GMSPanoramaView
.
أسعار مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط
رمز التخزين التعريفي: طلبات الإكمال التلقائي
يتم تحصيل رسوم رمز تخزين تعريفي لطلبات الإكمال التلقائي لكل طلب مُرسَل إلى واجهة برمجة تطبيقات الإكمال التلقائي (الجديدة) التي لا تتضمّن رمزًا مميّزًا للجلسة
ويتمّ تحصيل الرسوم أيضًا في حال استخدام رموز مميّزة للجلسة وإحدى الطريقتَين أدناه:
- إنهاء الجلسات بطلب واحد لوضع التفاصيل (جديد) الذي
أي حقول محدّدة في رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
- تتم فوترة كل طلب إكمال تلقائي (جديد)، وما يصل إلى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي
- تتم فوترة كل طلب إكمال تلقائي (جديد) لاحقًا باستخدام رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي
- إلغاء الجلسة أو إنهاؤها من خلال إجراء اتصال رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط) وبعد ذلك، تتم فوترة جميع طلبات الإكمال التلقائي (الجديدة) باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي
يتم تحصيل رسوم رمز تخزين تعريفي لاستخدام جلسة الإكمال التلقائي لكل طلب مُرسَل إلى واجهة برمجة تطبيقات الإكمال التلقائي (الجديدة) التي تتضمّن رمزًا مميّزًا للجلسة
يتم تحصيل رسوم رمز التخزين التعريفي هذا في الحالات التالية:
تم إنهاء جلسة الإكمال التلقائي من خلال مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط):
- تتم فوترة كل طلب إكمال تلقائي (جديد)، وما يصل إلى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي
- تتم فوترة كل طلب إكمال تلقائي (جديد) لاحقًا باستخدام رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي
تم إنهاء جلسة الإكمال التلقائي بمكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة).
استدعاء "تفاصيل مكان" يطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة) يتم تحصيل الرسوم وفقًا لها رمز التخزين التعريفي: تفاصيل المكان (المفضَّل)
تم إنهاء جلسة الإكمال التلقائي باستدعاء رمز التخزين التعريفي: التحقق من العنوان يُفضَّل توفيره.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك تحديد استجابة لتلك الحقول المحددة فقط. يتم تشغيل رمز التخزين التعريفي هذا فقط تطلب الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
id
,
photos
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك تحديد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
addressComponents
,
adrFormatAddress
,
formattedAddress
,
location
,
plusCode
,
types
,
viewport
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: تفاصيل المكان (أساسية)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك تحديد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
accessibilityOptions
,
businessStatus
,
displayName
,
googleMapsUri
,
iconBackgroundColor
,
primaryTypeDisplayName
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.0170 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
SKU: تفاصيل المكان (متقدمة)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك تحديد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: تفاصيل المكان (المفضَّل)
باستخدام قناع حقل أو قائمة حقول في طلب تفاصيل المكان (جديد)، يمكنك تحديد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
allowsDogs
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
hasCurbsidePickup
,
hasDelivery
,
hasDineIn
,
hasLiveMusic
,
hasMenuForChildren
,
hasOutdoorSeating
,
hasRestroom
,
hasTakeout
,
hasWifi
,
isGoodForChildren
,
isGoodForGroups
,
isGoodForWatchingSports
,
isReservable
,
parkingOptions
,
paymentOptions
,
priceLevel
,
reviews
,
servesBeer
,
servesBreakfast
,
servesBrunch
,
servesCocktails
,
servesCoffee
,
servesDessert
,
servesDinner
,
servesLunch
,
servesVegetarianFood
,
servesWine
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1,000) |
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: البحث عن قرب (أساسي)
باستخدام قناع حقل أو قائمة حقول في طلب البحث عن قرب (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
accessibilityOptions
,
addressComponents
,
adrFormatAddress
,
businessStatus
,
displayName
,
formattedAddress
,
googleMapsUri
,
iconBackgroundColor
,
id
,
location
,
photos
,
plusCode
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
,
viewport
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: البحث عن قرب (متقدم)
باستخدام قناع حقل أو قائمة حقول في طلب البحث عن قرب (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: البحث عن قرب (مفضل)
باستخدام قناع حقل أو قائمة حقول في طلب البحث عن قرب (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
allowsDogs
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
hasCurbsidePickup
,
hasDelivery
,
hasDineIn
,
hasLiveMusic
,
hasMenuForChildren
,
hasOutdoorSeating
,
hasRestroom
,
hasTakeout
,
hasWifi
,
isGoodForChildren
,
isGoodForGroups
,
isGoodForWatchingSports
,
isReservable
,
parkingOptions
,
paymentOptions
,
priceLevel
,
reviews
,
servesBeer
,
servesBreakfast
,
servesBrunch
,
servesCocktails
,
servesCoffee
,
servesDessert
,
servesDinner
,
servesLunch
,
servesVegetarianFood
,
servesWine
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: البحث النصي (المعرّف فقط)
باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
id
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
SKU: البحث النصي (أساسي)
باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
accessibilityOptions
,
addressComponents
,
adrFormatAddress
,
businessStatus
,
displayName
,
formattedAddress
,
googleMapsUri
,
iconBackgroundColor
,
location
,
photos
,
plusCode
,
svgIconMaskURI
,
types
,
utcOffsetMinutes
,
viewport
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
SKU: البحث النصي (متقدم)
باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
internationalPhoneNumber
,
nationalPhoneNumber
,
priceLevel
,
rating
,
regularOpeningHours
,
userRatingCount
,
websiteUri
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
SKU: البحث النصي (مفضل)
باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط:
allowsDogs
,
editorialSummary
,
evChargeOptions
,
fuelOptions
,
hasCurbsidePickup
,
hasDelivery
,
hasDineIn
,
hasLiveMusic
,
hasMenuForChildren
,
hasOutdoorSeating
,
hasRestroom
,
hasTakeout
,
hasWifi
,
isGoodForChildren
,
isGoodForGroups
,
isGoodForWatchingSports
,
isReservable
,
parkingOptions
,
paymentOptions
,
priceLevel
,
reviews
,
servesBeer
,
servesBreakfast
,
servesBrunch
,
servesCocktails
,
servesCoffee
,
servesDessert
,
servesDinner
,
servesLunch
,
servesVegetarianFood
,
servesWine
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: صورة المكان
يتم تحصيل رسوم رمز تخزين تعريفي لصورة المكان لكل طلب موجّه إلى واجهة برمجة التطبيقات.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
لمحة عن جلسات الإكمال التلقائي
تتضمن جلسة الإكمال التلقائي بعض طلبات الإكمال التلقائي (لاسترداد الاقتراحات على مكان كأنواع المستخدمين)، وطلب تفاصيل الأماكن واحد على الأكثر (لاسترداد تفاصيل عن المكان الذي يختاره المستخدم). يتم تمرير نفس الرمز المميز للجلسة إلى الإكمال التلقائي طلب تفاصيل المكان اللاحق. تبدأ الجلسة بطلب الإكمال التلقائي الأول (الذي يحدث عادةً عندما يبدأ المستخدم في الكتابة). يتم إجراء استدعاء "تفاصيل الأماكن" عندما يكون المستخدم اختار أحد اقتراحات الإكمال التلقائي. إذا لم يختار المستخدم اقتراحًا، لم يتم إجراء اتصال بتفاصيل الأماكن.
بعد أن يحدد المستخدم مكانًا (أي، يتم إجراء مكالمة تفاصيل الأماكن)، يجب بدء مكان جديد جلسة واحدة باستخدام رمز جلسة جديد.
يمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:
- صفحة خدمة الإكمال التلقائي للأماكن في Places API أو خدمة الإكمال التلقائي للأماكن في Maps JavaScript API. تحتاج إلى تصميم التطبيق لتقديم رموز الجلسة (قد تحتاج إلى تغيير الرمز الحالي).
- صفحة أداة الإكمال التلقائي في Maps JavaScript API. الفوترة المستندة إلى الجلسة هي يتم تفعيلها تلقائيًا على هذه الأدوات، بدون الحاجة إلى أي تغيير في الرمز.
الرمز المميّز للجلسة صالح لجلسة مستخدم واحدة ويجب عدم استخدامه لأكثر من مستخدم واحد جلسة المراجعة. في حال إعادة استخدام رمز مميّز للجلسة، سيتم اعتبار الجلسة غير صالحة وأنّ الطلبات يتم تحصيل الرسوم كما لو لم يتم تقديم رمز مميز للجلسة.
تتم فوترة طلبات الإكمال التلقائي وطلبات "تفاصيل الأماكن" باستخدام الجلسات في لرموز التخزين التعريفية المختلفة.
لمحة عن رموز التخزين التعريفية لبيانات الأماكن
رموز التخزين التعريفية لبيانات الأماكن الثلاثة هي: البيانات الأساسية، وبيانات الاتصال وبيانات الغلاف.يتم تشغيل رمز تخزين تعريفي واحد (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
،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 دولار أمريكي لكل مكان (+ 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_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 دولار أمريكي لكل مكان (+ 4.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: الإكمال التلقائي – لكل طلب
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي - لكل طلب مقابل أي من هذه المكالمات أو الطلبات التي لا تتضمّن رمزًا مميّزًا للجلسة:
- على أجهزة Android:
findAutocompletePredictions()
- أجهزة iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: خدمة الإكمال التلقائي للأماكن في Maps JavaScript API
- خدمة الويب: خدمة الإكمال التلقائي للأماكن في Places API
المكالمات التي تم إجراؤها من جلسة إكمال تلقائي غير صالحة (على سبيل المثال، جلسة تُعيد استخدام رمز مميّز للجلسة) يتم أيضًا تحصيل رسوم من خدمة الإكمال التلقائي لرمز التخزين التعريفي لكل طلب.
طلبات الإكمال التلقائي من واجهة برمجة تطبيقات JavaScript للخرائط قد يتم تحصيل رسوم من أداة الإكمال التلقائي للأماكن باستخدام رمز التخزين التعريفي لكل طلب في حال إجراء المكالمات من جلسة إكمال تلقائي غير صالحة. قد يحدث ذلك عندما يكتب مستخدم عدّة عناوين مختلفة. أو نسخ/لصق عناوين مختلفة في الأداة ولا تحدد دائمًا عبارة بحث مقترحة للإكمال التلقائي.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي بدون تفاصيل المكان - لكل جلسة مقابل جلسة الإكمال التلقائي التي لا يتضمن طلب تفاصيل المكان (خلال بضع دقائق من البداية من الجلسة).
النطاق الشهري (السعر لكل جلسة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
مثال
إذا تسبب تطبيقك في حدوث هاتين المكالمتين في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePromptions(fromQuery: "par" ...
- placesClient?.findAutocompletePromptions(fromQuery: "paris" ...
خدمة ويب
- طلب الإكمال التلقائي للمكان (input=”par”, session_token: XYZ)
- طلب الإكمال التلقائي للمكان (input=”paris”, session_token: XYZ)
سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- الإكمال التلقائي بدون تفاصيل المكان: لكلّ جلسة (يبدأ السعر من 0.017 دولار أمريكي لكلّ جلسة)
رمز التخزين التعريفي: الإكمال التلقائي (مشمول مع تفاصيل المكان) - لكلّ جلسة
الإكمال التلقائي (مضمّن مع تفاصيل المكان) – لكل جلسة يتم تحصيل رسوم رمز التخزين التعريفي مقابل جلسة الإكمال التلقائي يتضمّن أيًا مما يلي:
- Android: مكالمة إلى
fetchPlace()
- iOS: مكالمة إلى
fetchPlaceFromPlaceID:
- خدمة الويب: طلب "تفاصيل مكان"
يتوفّر طلب الإكمال التلقائي بدون أي رسوم، ويتم تحصيل الرسوم على مكالمة "تفاصيل المكان" التالية استنادًا إلى سعر تفاصيل المكان:
ينشئ طلب "تفاصيل المكان" رموز التخزين التعريفية للبيانات (أساسي، التواصل و/أو الغلاف) – بناءً على الحقول المحددة في الطلب.
في حال عدم تحديد حقول في طلب "تفاصيل المكان"، سيتم تشغيل جميع رموز التخزين التعريفية للبيانات. (الأساسي، والتواصل، والغلاف الجوي).
طلبات إعادة تحميل رقم تعريف تفاصيل المكان (الطلبات التي تحدّد الحقل place_id
فقط)
أثناء جلسة الإكمال التلقائي، تتم الفوترة على النحو التالي رمز التخزين التعريفي: الإكمال التلقائي
بدون تفاصيل المكان: لكل جلسة
النطاق الشهري (السعر لكل جلسة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
مثال
إذا أصدر طلبك المكالمات الثلاثة التالية في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (مع
FetchPlaceRequest
) بما في ذلك رقم تعريف المكان والحقل ADDRESS)
iOS
- placesClient?.findAutocompletePromptions(fromQuery: "par" ...
- placesClient?.findAutocompletePromptions(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 دولار أمريكي)
رمز التخزين التعريفي: الإكمال التلقائي لطلب البحث – لكل طلب
يتم تحصيل رسوم رمز تخزين تعريفي الإكمال التلقائي لطلبات البحث - لكل طلب مقابل كل طلب موجَّه إلى:
- JavaScript:
خدمة الإكمال التلقائي للأماكن في Maps JavaScript API (
getQueryPredictions()
) واستخدام تطبيق SearchBox المصغّر للخرائط (طلبات الإكمال التلقائي لطلبات البحث التي يتم إنشاؤها حسب أنواع المستخدم). - خدمة الويب: خدمة الإكمال التلقائي لطلبات البحث في واجهة برمجة تطبيقات الأماكن
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
لا تتوفّر إمكانية التسعير حسب جلسة الإكمال التلقائي باستخدام ميزة الإكمال التلقائي لطلبات البحث. التالي يتم تحصيل رسوم المكالمات الواردة إلى صفحة "تفاصيل الأماكن" وفقًا للمواعيد العادية أسعار تفاصيل الأماكن:
رمز التخزين التعريفي: تفاصيل المكان
يتم تحصيل رسوم مكالمات تفاصيل الأماكن على النحو التالي:
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
يتم إنشاء رمز التخزين التعريفي لتفاصيل المكان من واجهات برمجة التطبيقات التالية:
- Android: حزمة تطوير البرامج للأماكن لأجهزة Android
(
fetchPlace()
) - iOS: حزمة تطوير برامج الأماكن لأجهزة iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
خدمة تفاصيل المكان في Maps JavaScript API (
getDetails
) - JavaScript:
أداة الإكمال التلقائي للأماكن في "خرائط Google" (
getPlace
) - JavaScript:
أداة Place SearchBox في "واجهة برمجة تطبيقات JavaScript للخرائط":
getPlaces()
بعد أن يختار المستخدم نتيجة مكان (رمز: دبوس)، *وليس* طلب بحث (الرمز: المكبِّر)، كما هو موضّح هنا:في نتائج تطبيق مربّع البحث، بعد كتابة "بيتزا" في البحث المربّع، لاحظ أنّ تطبيق Pizza Autentico يظهر بجانبه رمز دبوس، للإشارة إلى هي نتيجة مكان (وليست طلب بحث). - خدمة الويب: خدمة تفاصيل الأماكن في Places API
باستخدام واجهة برمجة تطبيقات الويب والخدمات، يتم تحصيل رسوم رمز التخزين التعريفي لتفاصيل المكان سواء كان الرمز المميز للجلسة المقدمة أم لا.
تؤدي المكالمة أو طلب "تفاصيل المكان" أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات (أساسي، التواصل و/أو الغلاف)، وفقًا في الحقول المحددة في الاتصال أو الطلب. في حال تحديد حقول NO في مكالمة أو طلب "تفاصيل المكان"، يتم تشغيل جميع رموز التخزين التعريفية للبيانات سيتم تحصيل رسوم منك مقابل المكالمة أو الطلب ضمن "تفاصيل الأماكن" بالإضافة إلى تكلفة جميع البيانات.
أمثلة
- عليك إجراء أحد المكالمات أو الطلبات التالية:
- الهاتف الجوّال: يمكنك الاتصال بـ
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 دولار أمريكي لكل طلب)
- الهاتف الجوّال: يمكنك الاتصال بـ
- عليك إجراء أحد المكالمات أو الطلبات التالية:
- الهاتف الجوّال: يمكنك الاتصال بـ
fetchPlace()
على جهاز Android أوfetchPlaceFromPlaceID:
. في iOS، وتحديد جميع الحقول - واجهة برمجة تطبيقات أو خدمات على الويب: يمكنك تقديم طلب "تفاصيل مكان" وتحديد جميع الحقول (هذا النوع من
يكون request هو الإعداد التلقائي إذا لم تحدد أي حقول):
getPlaceDetails()
.
- تفاصيل المكان (سعر يبدأ من 0.017 دولار أمريكي للجلسة)
- البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
- الهاتف الجوّال: يمكنك الاتصال بـ
رمز التخزين التعريفي: تفاصيل المكان – إعادة تحميل المعرّف
يمكنك استخدام طلب "تفاصيل المكان" من أجل إعادة تحميل أرقام تعريف الأماكن القديمة تتوفر هذه الأنواع من الطلبات بدون أي رسوم.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
مثال
قدِّم طلب تفاصيل مكان مع تحديد حقل معرّف المكان فقط:
getPlaceDetails(fields: place_id)
سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند
الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- تفاصيل المكان - إعادة تحميل مستندات التعريف (تحصيل الفواتير بقيمة 0.00 دولار أمريكي)
SKU: البحث عن مكان
يتم تحصيل رسوم من العثور على المكان مقابل طلب "العثور على مكان".
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
تنشئ طلبات "العثور على الأماكن" أيضًا رموز التخزين التعريفية للبيانات (الأساسية، التواصل و/أو الغلاف الجوي، استنادًا إلى الحقول المحددة في الطلب. إبداء الإعجاب بتفاصيل المكان يمكنك استخدام معلمة الحقول في طلب "العثور على مكان" لتقييد الاستجابة على تلك الحقول المحددة فقط. يتم تحصيل الرسوم منك مقابل طلب "العثور على مكان" بالإضافة إلى البيانات طلبنا. بشكل تلقائي، إذا تم طلب حقول لا، سيتم عرض رقم تعريف المكان فقط، لذلك لا يتم تكبد أي رسوم إضافية للبيانات.
أمثلة
- تقدم طلب "العثور على مكان" وتحدد حقل العنوان فقط:
FindPlace(fields: formatted_address)
في فاتورتك، ستظهر رموز التخزين التعريفية هذه مُدرجة (عند الذين يطّلعون على فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
- البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
- تقدم طلب "العثور على مكان" وتحدد حقل رقم الهاتف:
FindPlace(fields: formatted_phone_number)
في فاتورتك، سيظهر لك وتم إدراج رموز التخزين التعريفية هذه (عند الذين يطّلعون على فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- يمكنك إجراء طلب "البحث عن مكان" وتحديد الحقول من مجموعات البيانات الثلاث جميعها:
FindPlace(fields: formatted_address, opening_hours, price_level)
في فاتورتك، سترى رموز التخزين التعريفية هذه مُدرجة (عند الذين يطّلعون على فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
- البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: البحث عن مكان - رقم التعريف فقط
يتم تحصيل رسوم من البحث عن مكان - رقم التعريف فقط مقابل طلبات "العثور على مكان" التي لا تحديد رقم تعريف المكان الذي سيتم عرضه. إذا لم يتم تحديد أي حقول في "البحث عن مكان" بشكل تلقائي سيتم عرض معرّف المكان فقط.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
مثال
تقدم طلب "العثور على مكان" وتحدد فقط حقل place_id
: FindPlace(fields: place_id)
.
سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند
الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- البحث عن مكان - رقم التعريف فقط (تحصيل الفواتير بسعر 0.00 دولار أمريكي)
رمز التخزين التعريفي: المكان – البحث عن أماكن قريبة
يتم تحصيل رسوم من المكان – البحث عن الأجهزة المجاورة مقابل الطلبات الموجّهة إلى
خدمة "البحث عن الأماكن المجاورة" في "واجهة برمجة تطبيقات JavaScript للخرائط"
(nearbySearch()
)، أو إلى
خدمة البحث عن الأماكن المجاورة في واجهة برمجة تطبيقات الأماكن
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
تعرض طلبات البحث عن الأجهزة المجاورة قائمة بالأماكن، ولكنها لا تتيح تحديد الحقول عاد. تعرض طلبات البحث عن الأماكن المجاورة مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب "البحث عن قرب" بدءًا من 0.032 دولار أمريكي. لكل منها، بالإضافة إلى كل رموز التخزين التعريفية لأنواع البيانات (البيانات الأساسية، بيانات الاتصال وبيانات الغلاف).
مثال
إذا أرسلت طلبًا من خلال ميزة "البحث عن قرب"، مثل NearbySearch (San Francisco, 100 meters)
.
في فاتورتك، ستظهر رموز التخزين التعريفية هذه مُدرجة (عند
الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- المكان - البحث عن قرب (يبدأ السعر من 0.032 دولار أمريكي للمكالمة)
- البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: المكان – البحث النصي
يتم تحصيل رسوم من المكان – البحث النصي مقابل الطلبات المرسلة إلى
خدمة "البحث النصي عن المكان" في "واجهة برمجة تطبيقات JavaScript للخرائط"
(textSearch()
)، أو إلى
خدمة البحث النصي في Places API.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
تعرض طلبات البحث النصي قائمة بالأماكن، ولكنها غير متوفرة لتحديد الحقول التي يتم إرجاعها. تعرض طلبات البحث النصي مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث النصي بدءًا من 0.032 دولار أمريكي لكل طلب، بالإضافة إلى جميع رموز التخزين التعريفية لنوع البيانات (البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي).
يتم أيضًا إنشاء رمز التخزين التعريفي الخاص بـ "الأماكن – البحث النصي" بواسطة
أداة Place SearchBox في "واجهة برمجة تطبيقات JavaScript للخرائط": getPlaces()
بعد أن يختار المستخدم طلب بحث مكان (الرمز: المكبِّر)، وليس
النتيجة (الرمز: تثبيت)، كما هو موضح هنا:
![تحديد طلب بحث أداة مربع البحث لتفاصيل الأماكن](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=19&hl=ar)
مثال
إذا أرسلت طلب بحث نصي، مثلاً TextSearch(123 Main Street)
. في فاتورتك،
سترى رموز التخزين التعريفية هذه مُدرجة (عند
الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- المكان - البحث النصي (يبدأ السعر من 0.032 دولار أمريكي للمكالمة)
- البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: صورة المكان
يتم تحصيل رسوم رمز التخزين التعريفي لصورة المكان مقابل:
- جهاز Android: المكالمات إلى
fetchPhoto()
- iOS: المكالمات إلى
loadPlacePhoto:
- JavaScript: للانتقال إلى مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط
خدمة "صور المكان" عند طلب بيانات من عناوين URL التي تم عرضها من خلال
PlacePhoto.getUrl()
لتحميل بيانات بكسل الصورة - خدمة الويب: الطلبات إلى مكان واجهة برمجة التطبيقات للأماكن خدمة "صور Google"
بالنسبة إلى خدمة JavaScript، لا يمكن استدعاء طريقة PlacePhoto.getUrl()
في الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات البكسل.
النطاق الشهري للحجم (سعر المكالمة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
تحديد أسعار خدمات JavaScript
ويتم تسعير خدمات JavaScript بشكل منفصل. الاطّلاع على استخدام الخدمة والفوترة للحصول على المزيد من المعلومات:
- خدمة الاتجاهات -- الاستخدام والفوترة في واجهة برمجة التطبيقات للاتجاهات
- خدمة مصفوفة المسافة -- استخدام واجهة برمجة التطبيقات لمصفوفة المسافات والفوترة
- خدمة تحديد الارتفاع -- الاستخدام والفوترة في واجهة برمجة التطبيقات Elevation API
- خدمة الترميز الجغرافي -- استخدام واجهة برمجة التطبيقات Geocoding API والفوترة
- خدمة "التجوّل الافتراضي" -- استخدام واجهة برمجة تطبيقات "التجوّل الافتراضي" والفوترة
حدود استخدام أخرى
على الرغم من عدم توفّر حدّ أقصى لعدد الطلبات في اليوم، يمكن استخدام ما يلي: يتم فرض حدود للاستخدام على واجهة برمجة تطبيقات JavaScript للخرائط:
- 30000 QPM (طلب في الدقيقة).
- 300 وحدة QPM (طلب في الدقيقة) لكل عنوان IP. في Google Cloud Console ويُشار إلى هذه الحصة باسم عمليات تحميل الخريطة في الدقيقة لكل مستخدم.
حدود استخدام JavaScript للخرائط الثلاثية الأبعاد ذات الصور الواقعية في "خرائط Google"
تم فرض حدود الاستخدام التالية للخرائط الثلاثية الأبعاد ذات الصور الواقعية في JavaScript في "خرائط Google"
- 100 QPM (طلب في الدقيقة) .
- 10 QPM (طلب في الدقيقة) لكل عنوان IP .
القيود المفروضة على بنود الاستخدام
للحصول على تفاصيل كاملة عن الاستخدام المسموح به، يمكنك الرجوع إلى قسم "قيود الترخيص" في بنود خدمة Google Maps Platform
إدارة تكلفة الاستخدام
لإدارة تكلفة استخدام Maps JavaScript API أو تلبية متطلبات الإنتاج يمكنك تعيين حدود للحصة اليومية على جميع الطلبات لأي واجهة برمجة تطبيقات. تتم إعادة ضبط الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.
لعرض حدود الحصص أو تغييرها في Maps JavaScript API:
- في Cloud Console، افتح صفحة حصص "خرائط Google".
- انقر على القائمة المنسدلة لواجهات برمجة التطبيقات واختَر Maps JavaScript API.
- للاطّلاع على حدود الحصص، انتقِل للأسفل وصولاً إلى الطلبات.
بنجاح.
يسرد جدول أسماء الحصص وحدودها. - لتغيير الحدّ الأقصى للحصة، انقر على رمز تعديل لهذا الحدّ.
في مربع الحوار الذي يظهر، وفي الحقل حد الحصة، أدخلي حدّ الحصة اليومية المفضّلة والقابلة للفوترة (ما يصل إلى الحدّ الأقصى للحصة المحدّدة من قِبل Google، إن توفّر) واختَر حفظ.
إذا بلغ استخدام واجهة برمجة التطبيقات الحد الأقصى للحصة القابلة للفوترة في أي يوم، فلن يكون تطبيقك من الوصول إلى واجهة برمجة التطبيقات خلال الوقت المتبقي من ذلك اليوم.