كيفية تحصيل الرسوم من Places API
تستخدم واجهة Places API (الجديدة) و Places API نموذج تسعير الدفع حسب الاستخدام. واجهات برمجة التطبيقات في Google Maps Platform وتتم فوترة حِزم تطوير البرامج (SDK) من خلال رمز التخزين التعريفي. يتم تتبُّع الاستخدام لكل رمز تخزين تعريفي، وقد تحتوي أي واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) على أكثر من رمز تخزين تعريفي واحد. رمز التخزين التعريفي للمنتج. يتم احتساب التكلفة من خلال:
استخدِم حاسبة الأسعار والحِزم لتقدير تكلفة الاستخدام لكل واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK). بالنسبة إلى رموز التخزين التعريفية المؤهَّلة في "منصة خرائط Google"، يتوفّر رصيد بقيمة 200 دولار أمريكي في "منصة خرائط Google" كل شهر لكل حساب فوترة. تتم إضافة هذا الرصيد تلقائيًا سيتم تطبيقها على رموز التخزين التعريفية المؤهّلة.
تحديد أسعار Places API (جديدة)
لمحة عن أقنعة الحقول
بالنسبة إلى تفاصيل الأماكن (جديد)،
البحث عن قرب (جديد)
البحث النصي (جديد)، استخدم العنوان FieldMask في
طلبات البيانات من واجهة برمجة التطبيقات لتحديد قائمة الحقول المطلوب عرضها في الردّ أنت
ثم تتم الفوترة وفقًا لأعلى رمز تخزين تعريفي (SKU) ينطبق على طلبك. هذا يعني أنك إذا استخدمت
الحقول المحددة في كل من رمز التخزين التعريفي (الأساسي) ورمز التخزين التعريفي (المتقدّم)، ستتم الفوترة
استنادًا إلى رمز التخزين التعريفي (المتقدّم)
يعد استخدام قناع المجال ممارسة جيدة على التصميم للتأكد من أنك لا تطلب بيانات غير ضرورية، مما يساعد على تجنب وقت المعالجة والفوترة غير الضروريين الرسوم.
لمحة عن جلسات الإكمال التلقائي (الجديدة)
تتضمّن جلسة "الإكمال التلقائي (جديد)" طلبًا واحدًا أو أكثر من طلبات "الإكمال التلقائي (جديد)"، وأحد طلبَي "تفاصيل المكان (جديد)" أو "التحقّق من العنوان". يتم تمرير نفس الرمز المميز للجلسة إلى طلب الإكمال التلقائي (جديد) وإلى طلب تفاصيل المكان (الجديد) اللاحق أو التحقق من العنوان طلبك.
تبدأ الجلسة بطلب الإكمال التلقائي (جديد). طلب تفاصيل مكان (جديد) أو يتم بعد ذلك تقديم طلب "التحقق من العنوان" عندما يختار المستخدم إحدى عمليات الإكمال التلقائي (جديدة) الاقتراحات. إذا تمّت مغادرة جلسة، أي عدم تقديم طلب "تفاصيل المكان (جديد)" أو طلب "التحقّق من العنوان"، يتم تحصيل رسوم طلبات "الإكمال التلقائي (جديد)" كما لو لم يتم تقديم رمز مميّز للجلسة .
بعد أن يختار المستخدم مكانًا (ما يعني طلب تفاصيل مكان (جديد) أو التحقُّق من العنوان طلب الاشتراك)، يجب بدء جلسة جديدة باستخدام رمز مميز جديد للجلسة.
الرمز المميز للجلسة صالح لجلسة واحدة ولا يمكن استخدامه لأكثر من جلسة واحدة جلسة المراجعة. في حال إعادة استخدام رمز مميّز للجلسة، سيتم اعتبار الجلسة غير صالحة وأنّ الطلبات يتم تحصيل الرسوم كما لو لم يتم تقديم رمز مميز للجلسة.
رمز التخزين التعريفي: طلبات الإكمال التلقائي
يتم تحصيل رسوم رمز التخزين التعريفي طلبات الإكمال التلقائي مقابل كل طلب إلى واجهة برمجة التطبيقات Autocomplete (New) API الذي لا يتضمّن رمز جلسة.
يتم أيضًا تحصيل الرسوم في حال استخدام الرموز المميّزة للجلسات وتنفيذ أيّ مما يلي:
- إنهاء الجلسات بطلب واحد لوضع التفاصيل (جديد) الذي
أي حقول محدّدة في رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
- يتم تحصيل رسوم كل طلب من طلبات "الإكمال التلقائي (جديد)"، بما يصل إلى 12 طلبًا، باستخدامرمز التخزين التعريفي: طلبات الإكمال التلقائي.
- يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
- إلغاء الجلسة أو إنهاؤها من خلال إجراء اتصال رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط) بعد ذلك، يتمّ تحصيل رسوم منك مقابل كلّ طلبات "الإكمال التلقائي (جديد)" باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي
يتم تحصيل رسوم رمز تخزين تعريفي لاستخدام جلسة الإكمال التلقائي لكل طلب مُرسَل إلى واجهة برمجة تطبيقات الإكمال التلقائي (الجديدة) التي تتضمّن رمزًا مميّزًا للجلسة
يتم تحصيل رسوم رمز التخزين التعريفي هذا في السيناريوهات التالية:
تم إنهاء جلسة الإكمال التلقائي من خلال مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط):
- يتم تحصيل رسوم كل طلب من طلبات "الإكمال التلقائي (جديد)"، بما يصل إلى 12 طلبًا، باستخدامرمز التخزين التعريفي: طلبات الإكمال التلقائي.
- يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
تم إنهاء جلسة الإكمال التلقائي بمكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة).
استدعاء "تفاصيل مكان" يطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة) يتم تحصيل الرسوم وفقًا لها رمز التخزين التعريفي: تفاصيل المكان (المفضَّل)
تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى SKU: Address Validation Preferred.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الميزة التلقائية (الجديدة) وأسعار الجلسات.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
خدمة الويب:
attributions،
id،
name*،
photos
* يحتوي الحقل name على اسم المورد
للمكان على النحو التالي: places/PLACE_ID. استخدِم displayName
للوصول إلى الاسم النصي للمكان.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
خدمة الويب:
addressComponents،
adrFormatAddress,
formattedAddress،
location،
plusCode،
shortFormattedAddress,
types,
viewport
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: تفاصيل المكان (أساسية)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
accessibilityOptions،
businessStatus,
displayName،
googleMapsUri،
iconBackgroundColor،
iconMaskBaseUri,
primaryType,
primaryTypeDisplayName,
subDestinations,
utcOffsetMinutes
إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.0170 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
SKU: تفاصيل المكان (متقدمة)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
currentOpeningHours،
currentSecondaryOpeningHours,
internationalPhoneNumber،
nationalPhoneNumber،
priceLevel،
rating,
regularOpeningHours,
regularSecondaryOpeningHours,
userRatingCount,
websiteUri
إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: تفاصيل المكان (المفضَّل)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
allowsDogs،
curbsidePickup,
delivery،
dineIn،
editorialSummary،
evChargeOptions,
fuelOptions,
goodForChildren,
goodForGroups,
goodForWatchingSports,
liveMusic,
menuForChildren,
parkingOptions,
paymentOptions,
outdoorSeating,
reservable,
restroom,
reviews,
routingSummaries,*
servesBeer,
servesBreakfast,
servesBrunch,
servesCocktails,
servesCoffee,
servesDessert,
servesDinner,
servesLunch,
servesVegetarianFood,
servesWine,
takeout
* البحث النصي والبحث عن الأماكن القريبة فقط
إذا تم إنهاء جلسة الإكمال التلقائي من خلال مكالمة تفاصيل المكان التي تطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة)، ثم يتم تحصيل رسوم المكالمة على رمز التخزين التعريفي: تفاصيل المكان (المفضَّل) لمزيد من المعلومات، يُرجى مراجعة رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1,000) |
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: ميزة "البحث في الأماكن القريبة" (أساسية)
باستخدام قناع حقل أو قائمة حقول في طلب البحث عن قرب (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
places.accessibilityOptions،
places.addressComponents,
places.adrFormatAddress،
places.attributions،
places.businessStatus،
places.displayName,
places.formattedAddress,
places.googleMapsUri,
places.iconBackgroundColor,
places.iconMaskBaseUri,
places.id,
places.location,
places.name*,
places.photos,
places.plusCode,
places.primaryType,
places.primaryTypeDisplayName,
places.shortFormattedAddress,
places.subDestinations,
places.types,
places.utcOffsetMinutes,
places.viewport
* يحتوي الحقل places.name على المكان اسم المورد
بالصيغة: places/PLACE_ID. استخدِم places.displayName
للوصول إلى الاسم النصي للمكان.
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: البحث عن قرب (متقدم)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث عن الأماكن القريبة" (جديد)، يمكنك حصر الجواب في الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
خدمة الويب:
places.currentOpeningHours،
places.currentSecondaryOpeningHours،
places.internationalPhoneNumber،
places.nationalPhoneNumber،
places.priceLevel،
places.rating،
places.regularOpeningHours،
places.regularSecondaryOpeningHours،
places.userRatingCount،
places.websiteUri
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: البحث في الأماكن القريبة (الخيار المفضّل)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث عن الأماكن القريبة" (جديد)، يمكنك حصر الجواب في الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
خدمة الويب:
places.allowsDogs،
places.curbsidePickup،
places.delivery،
places.dineIn،
places.editorialSummary،
places.evChargeOptions،
places.fuelOptions،
places.goodForChildren،
places.goodForGroups،
places.goodForWatchingSports،
places.liveMusic،
places.menuForChildren،
places.parkingOptions،
places.paymentOptions،
places.outdoorSeating،
places.reservable،
places.restroom،
places.reviews،
places.routingSummaries،*
places.servesBeer،
places.servesBreakfast،
places.servesBrunch،
places.servesCocktails،
places.servesCoffee،
places.servesDessert،
places.servesDinner،
places.servesLunch،
places.servesVegetarianFood،
places.servesWine،
places.takeout
* البحث النصي والبحث عن الأماكن المجاورة فقط
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: البحث النصي (المعرّف فقط)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
places.attributions،
places.id،
places.name*،
nextPageToken
* يحتوي الحقل places.name على اسم المورد
للمكان على النحو التالي: places/PLACE_ID. استخدِم places.displayName
للوصول إلى الاسم النصي للمكان.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
SKU: البحث النصي (أساسي)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
خدمة الويب:
places.accessibilityOptions،
places.addressComponents،
places.adrFormatAddress،
places.businessStatus،
places.displayName،
places.formattedAddress،
places.googleMapsUri،
places.iconBackgroundColor،
places.iconMaskBaseUri،
places.location،
places.photos،
places.plusCode،
places.primaryType،
places.primaryTypeDisplayName،
places.shortFormattedAddress،
places.subDestinations،
places.types،
places.utcOffsetMinutes،
places.viewport
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
SKU: البحث النصي (متقدم)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
places.currentOpeningHours،
places.currentSecondaryOpeningHours،
places.internationalPhoneNumber،
places.nationalPhoneNumber،
places.priceLevel،
places.rating،
places.regularOpeningHours،
places.regularSecondaryOpeningHours،
places.userRatingCount،
places.websiteUri
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
SKU: البحث النصي (مفضل)
باستخدام قناع حقل أو قائمة حقول في طلب البحث النصي (جديد)، يمكنك تقييد استجابة لتلك الحقول المحددة فقط. هذا النمط يتم تشغيل رمز التخزين التعريفي عندما تطلب فقط الحقول التالية:
خدمة الويب:
places.allowsDogs،
places.curbsidePickup،
places.delivery،
places.dineIn،
places.editorialSummary،
places.evChargeOptions،
places.fuelOptions،
places.goodForChildren،
places.goodForGroups،
places.goodForWatchingSports،
places.liveMusic،
places.menuForChildren،
places.parkingOptions،
places.paymentOptions،
places.outdoorSeating،
places.reservable،
places.restroom،
places.reviews،
places.routingSummaries،*
places.servesBeer،
places.servesBreakfast،
places.servesBrunch،
places.servesCocktails،
places.servesCoffee،
places.servesDessert،
places.servesDinner،
places.servesLunch،
places.servesVegetarianFood،
places.servesWine،
places.takeout
* البحث النصي والبحث عن الأماكن المجاورة فقط
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
رمز التخزين التعريفي: صورة مكان
يتم تحصيل رسوم رمز التخزين التعريفي Place Photo مقابل كل طلب يتم إرساله إلى واجهة برمجة التطبيقات.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
أسعار واجهة برمجة التطبيقات Places API
لمحة عن جلسات "الإكمال التلقائي"
تتضمن جلسة الإكمال التلقائي بعض طلبات الإكمال التلقائي (لاسترداد الاقتراحات على مكان كأنواع المستخدمين)، وطلب تفاصيل الأماكن واحد على الأكثر (لاسترداد تفاصيل عن المكان الذي يختاره المستخدم). يتم تمرير نفس الرمز المميز للجلسة إلى الإكمال التلقائي طلب تفاصيل المكان اللاحق. تبدأ الجلسة بأول طلب إكمال تلقائي (الذي يحدث عادةً عندما يبدأ المستخدم الكتابة). يتم إجراء مكالمة إلى Places Details عندما يختار المستخدِم أحد اقتراحات الإكمال التلقائي. إذا لم يختار المستخدم اقتراحًا، لم يتم إجراء اتصال بتفاصيل الأماكن.
بعد أن يحدد المستخدم مكانًا (أي، يتم إجراء مكالمة تفاصيل الأماكن)، يجب بدء مكان جديد جلسة واحدة باستخدام رمز جلسة جديد.
يمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:
- خدمة "الإكمال التلقائي للأماكن" في واجهة برمجة التطبيقات Places API أو خدمة "الإكمال التلقائي للأماكن" في واجهة برمجة التطبيقات JavaScript للخرائط تحتاج إلى تصميم التطبيق لتقديم رموز الجلسة (قد تحتاج إلى تغيير الرمز الحالي).
- صفحة أداة الإكمال التلقائي في Maps JavaScript API. يتم تفعيل ميزة الفوترة المستندة إلى الجلسة تلقائيًا في هذه التطبيقات المصغّرة، بدون الحاجة إلى تغيير أي رمز.
يكون الرمز المميّز للجلسة صالحًا لجلسة مستخدم واحدة، ويجب عدم استخدامه لأكثر من جلسة مستخدم واحدة. في حال إعادة استخدام رمز مميّز للجلسة، سيتم اعتبار الجلسة غير صالحة وأنّ الطلبات يتم تحصيل الرسوم كما لو لم يتم تقديم رمز مميز للجلسة.
تتم فوترة طلبات الإكمال التلقائي وطلبات "تفاصيل الأماكن" باستخدام الجلسات في لرموز التخزين التعريفية المختلفة.
لمحة عن رموز التخزين التعريفية لبيانات الأماكن
رموز التخزين التعريفية لبيانات الأماكن الثلاثة هي: البيانات الأساسية، وبيانات الاتصال وبيانات الغلاف.يتم تشغيل رمز تخزين تعريفي واحد (SKU) للبيانات أو أكثر لما يلي:
- Android: كل طلب إلى
fetchPlace()أوfindCurrentPlace() - iOS: كل مكالمة إلى
fetchPlaceFromPlaceID:أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields: - خدمة الويب: كل طلب من طلبات "الأماكن" استنادًا إلى الحقول المحدّدة في الطلب
يتم دائمًا تحصيل رسوم رموز التخزين التعريفية للبيانات بالإضافة إلى رمز التخزين التعريفي الأساسي لعملية تشغيل الطلب. معهم. على سبيل المثال، سيتم تحصيل رسوم طلب "تفاصيل المكان" الذي يتضمّن حقول "البيانات الأساسية" ضمن كلاً من رمز التخزين التعريفي "البيانات الأساسية" ورمز التخزين التعريفي "تفاصيل المكان".
بالنسبة إلى خدمة الويب، تتيح طلبات البيانات هذه من Places APIs تحديد حقول البيانات التي سيتم عرضها:
بالنسبة إلى خدمة الويب، لا تسمح طلبات بيانات Places API هذه بتحديد الحقول المعروضة. تعرض هذه المكالمات دائمًا جميع بيانات الأماكن، ويتم شحن رموز التخزين التعريفية لبيانات الأماكن الثلاثة فيها بالإضافة إلى رسوم كل طلب بيانات من واجهة برمجة التطبيقات:
رمز التخزين التعريفي: البيانات الأساسية
باستخدام مَعلمة الحقول في "تفاصيل المكان" أو "طلب البحث عن مكان"، يمكنك تحديد استجابة لتلك الحقول المحددة فقط. يتم تضمين الحقول في الفئة أساسي في التكلفة الأساسية لطلب "الأماكن" ولا تؤدي إلى تحصيل أي رسوم إضافية. يتم تشغيل رمز التخزين التعريفي للبيانات الأساسية عند يتم طلب أي من هذه الحقول:
-
على أجهزة Android:
Place.Field.ACCESSIBILITY_OPTIONS،Place.Field.ADDRESS_COMPONENTS,Place.Field.BUSINESS_STATUS،Place.Field.DISPLAY_NAME،Place.Field.FORMATTED_ADDRESS،Place.Field.ICON_BACKGROUND_COLOR,Place.Field.ICON_MASK_URL,Place.Field.ID,Place.Field.LOCATION,Place.Field.PHOTO_METADATAS,Place.Field.PLUS_CODE،Place.Field.TYPES،Place.Field.VIEWPORT، أوPlace.Field.UTC_OFFSET. -
نظام التشغيل 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 دولار أمريكي |
SKU: بيانات الاتصال
استخدام مَعلمة الحقول في "تفاصيل المكان" أو "طلب البحث عن مكان" لخدمات الويب
مصفوفة من Place.Field لنظام التشغيل Android أو iOS، يمكنك
الرد على هذه الحقول المحددة فقط. تؤدي الحقول في فئة جهة الاتصال
إلى تحصيل رسوم إضافية. تم تشغيل رمز التخزين التعريفي لبيانات الاتصال
عند طلب أيّ من هذه الحقول:
-
نظام التشغيل Android:
Place.Field.CURRENT_OPENING_HOURS،Place.Field.INTERNATIONAL_PHONE_NUMBER,Place.Field.OPENING_HOURS،Place.Field.SECONDARY_OPENING_HOURSأوPlace.Field.WEBSITE_URI -
نظام التشغيل iOS:
GMSPlaceFieldOpeningHours،GMSPlaceFieldPhoneNumberأوGMSPlaceFieldWebsite -
خدمة ويب:
formatted_phone_numberinternational_phone_numberأوopening_hourscurrent_opening_hoursأوsecondary_opening_hourswebsite
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| تكلفة طلب أماكن + 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_RATING_COUNT
- أجهزة iOS:
GMSPlaceFieldPriceLevelوGMSPlaceFieldRatingGMSPlaceFieldUserRatingsTotalوGMSPlaceFieldTakeoutوGMSPlaceFieldDeliveryوGMSPlaceFieldDineInوGMSPlaceFieldCurbsidePickupGMSPlaceFieldReservableوGMSPlaceFieldServesBreakfastوGMSPlaceFieldServesLunchوGMSPlaceFieldServesDinnerوGMSPlaceFieldServesBeerGMSPlaceFieldServesWineأو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
المكالمات التي تم إجراؤها من جلسة إكمال تلقائي غير صالحة (على سبيل المثال، جلسة تُعيد استخدام رمز مميّز للجلسة) يتم أيضًا تحصيل رسوم من خدمة الإكمال التلقائي لرمز التخزين التعريفي لكل طلب.
قد يتم تحصيل رسوم SKU الخاصة بميزة "الإكمال التلقائي" لكل طلب من طلبات الإكمال التلقائي الواردة من شريحة برمجة التطبيقات JavaScript API في "خرائط Google" لوحدة تحكّم ميزة "الإكمال التلقائي للأماكن" في حال إجراء طلبات من جلسة إكمال تلقائي غير صالحة. قد يحدث ذلك عندما يكتب مستخدم عدّة عناوين مختلفة. أو نسخ/لصق عناوين مختلفة في الأداة ولا تحدد دائمًا عبارة بحث مقترحة للإكمال التلقائي.
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
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?.findAutocompletePredictions(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 دولار أمريكي | 0.00 SAR | 0.00 دولار أمريكي |
مثال
إذا أصدر طلبك المكالمات الثلاثة التالية في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (مع
FetchPlaceRequest) بما في ذلك رقم تعريف المكان والحقل ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(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 في Maps JavaScript API (يتم توليد طلبات الإكمال التلقائي للطلبات أثناء كتابة المستخدم). - خدمة الويب: خدمة الإكمال التلقائي لطلبات البحث في Places API
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
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:
أداة "مربّع البحث عن الأماكن" في Maps JavaScript API:
getPlaces()بعد أن يختار المستخدم نتيجة مكان (الرمز: دبوس)، *وليس* طلب بحث (الرمز: مكبّر)، كما هو موضّح هنا:
في نتائج أداة مربّع البحث، بعد كتابة "بيتزا" في مربّع بحث، يُرجى ملاحظة أنّ Pizza Autentico يظهر بجانبه رمز دبوس، ما يشير إلى أنّه هو نتيجة مكان (وليس طلب بحث). - خدمة الويب: خدمة تفاصيل الأماكن في Places API
باستخدام واجهة برمجة التطبيقات والخدمات على الويب، يتم تحصيل رسوم رمز التخزين التعريفي لتفاصيل المكان سواء تم تقديم رمز تعريف جلسة أم لا.
تؤدي المكالمة أو طلب "تفاصيل المكان" أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات (أساسي، التواصل و/أو الغلاف)، وفقًا في الحقول المحددة في الاتصال أو الطلب. في حال تحديد حقول لا في طلب أو مكالمة "تفاصيل الأماكن"، يتم تنشيط جميع رموز التخزين التعريفية للبيانات، ويُحصَّل منك رسوم طلب أو مكالمة "تفاصيل الأماكن" بالإضافة إلى تكلفة جميع البيانات.
أمثلة
- يمكنك إجراء أحد هذه المكالمات أو الطلبات:
- الأجهزة الجوّالة: اتصل بالرقم
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، وحدِّد جميع الحقول. - Web API أو خدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد جميع الحقول (هذا النوع من
الطلبات هو الإعداد التلقائي في حال عدم تحديد أي حقول):
getPlaceDetails().
- تفاصيل المكان (سعر يبدأ من 0.017 دولار أمريكي للجلسة)
- البيانات الأساسية (يتم تحصيل فواتيرها بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)
- الأجهزة الجوّالة: اتصل على
رمز التخزين التعريفي: تفاصيل المكان - إعادة تحميل المعرّف
يمكنك استخدام طلب "تفاصيل المكان" من أجل إعادة تحميل أرقام تعريف الأماكن القديمة تتوفّر هذه الأنواع من الطلبات بدون أي رسوم.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.00 دولار أمريكي | 0.00 SAR | 0.00 دولار أمريكي |
مثال
قدِّم طلب تفاصيل مكان مع تحديد حقل معرّف المكان فقط:
getPlaceDetails(fields: place_id)
سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند
الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- تفاصيل المكان - إعادة تحميل مستندات التعريف (تحصيل الفواتير بقيمة 0.00 دولار أمريكي)
رمز التخزين التعريفي: العثور على مكان
يتم تحصيل رسوم من البحث عن مكان مقابل طلب البحث عن مكان.
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تُنشئ طلبات "العثور على مكان" أيضًا رموز التخزين التعريفية للبيانات (أساسية و/أو جهة اتصال و/أو جو)، استنادًا إلى الحقول المحدّدة في الطلب. إبداء الإعجاب بتفاصيل المكان يمكنك استخدام معلمة الحقول في طلب "العثور على مكان" لتقييد الاستجابة على تلك الحقول المحددة فقط. يتم تحصيل الرسوم منك مقابل طلب "العثور على مكان" بالإضافة إلى البيانات طلبنا. تلقائيًا، إذا تم طلب حقول NO، يتم عرض رقم تعريف المكان فقط، وبالتالي لا يتم تحصيل أي رسوم إضافية مقابل البيانات.
أمثلة
- يمكنك تقديم طلب "العثور على مكان" وتحديد حقل العنوان فقط:
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 دولار أمريكي | 0.00 SAR | 0.00 دولار أمريكي |
مثال
تقدم طلب "العثور على مكان" وتحدد فقط حقل 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 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: المكان – البحث النصي
يتم تحصيل رسوم البحث النصي عن الأماكن مقابل الطلبات المرسَلة إلى
خدمة البحث النصي عن الأماكن في Maps JavaScript API
(textSearch())، أو إلى
خدمة البحث النصي في Places API.
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تعرِض طلبات البحث النصي قائمة بالأماكن، ولكن لا تتيح تحديد الحقول التي يتم عرضها. تعرض طلبات "البحث النصي" مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث النصي بدءًا من 0.032 دولار أمريكي لكل طلب، بالإضافة إلى جميع رموز التخزين التعريفية لنوع البيانات (البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي).
يتم أيضًا إنشاء رمز التخزين التعريفي الخاص بـ "الأماكن – البحث النصي" بواسطة
أداة Place SearchBox في "واجهة برمجة تطبيقات JavaScript للخرائط": getPlaces()
بعد أن يختار المستخدم طلب بحث مكان (الرمز: المكبِّر)، وليس
النتيجة (الرمز: تثبيت)، كما هو موضح هنا:
مثال
إذا أرسلت طلب بحث نصي، مثلاً TextSearch(123 Main Street). في فاتورتك،
سترى رموز التخزين التعريفية هذه مُدرجة (عند
الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- المكان: البحث النصي (يبدأ السعر من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: صورة المكان
يتم تحصيل رسوم رمز التخزين التعريفي صورة مكان مقابل ما يلي:
- جهاز Android: المكالمات إلى
fetchPhoto() - iOS: المكالمات إلى
loadPlacePhoto: - JavaScript: إلى Places Library،
خدمة "صور الأماكن" في واجهة برمجة تطبيقات JavaScript لخرائط Google عند طلب البيانات من عناوين URL التي يعرضها
PlacePhoto.getUrl()لتحميل بيانات وحدات البكسل للصورة - خدمة الويب: طلبات إلى Places API Place خدمة Photos API
بالنسبة إلى خدمة JavaScript، لا يمكن استدعاء طريقة PlacePhoto.getUrl()
في الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات البكسل.
| النطاق الشهري للحجم (سعر المكالمة) |
||
|---|---|---|
| 0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000) |
يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة. |
حدود استخدام أخرى
على الرغم من عدم وجود حدّ أقصى لعدد الطلبات في اليوم، تظلّ حدود الاستخدام التالية سارية:
Places API (الإصدار الجديد): الحدّ الأقصى للمعدل هو 600 طلب كل دقيقة (طلبات في الدقيقة) لكل طريقة لواجهة برمجة التطبيقات لكل مشروع. معنى كل طريقة من طرق واجهة برمجة التطبيقات لها حصة منفصلة.
Places API: حد المعدل هو 6,000 QPM (الطلبات لكل دقيقة). ويتم احتسابه عن طريق جمع الطلبات من جهة العميل والخادم لجميع التطبيقات باستخدام بيانات اعتماد المشروع نفسه.
قيود بنود الاستخدام
للحصول على معلومات عن بنود الاستخدام، يُرجى الاطّلاع على سياسات Places API و قسم "قيود الترخيص" في بنود خدمة "منصّة خرائط Google".
إدارة تكلفة الاستخدام
لإدارة تكلفة استخدام Places API أو تلبية متطلبات الإنتاج يمكنك تعيين حدود للحصة اليومية على جميع الطلبات لأي واجهة برمجة تطبيقات. تتم إعادة ضبط الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.
لعرض حدود الحصص أو تغييرها لواجهة برمجة التطبيقات Places API:
- في Cloud Console، افتح صفحة حصص "منصة خرائط Google".
- انقر على القائمة المنسدلة واجهات برمجة التطبيقات وحدد Places API.
- للاطّلاع على حدود الحصة، انتقِل إلى بطاقة الطلبات
.
يسرد جدول أسماء الحصص وحدودها. - لتغيير حدّ الحصة، انقر على رمز تعديل لذلك الحدّ.
في مربّع الحوار الذي يظهر، أدخِل الحدّ الأقصى المفضّل للمساحة المتوفّرة يوميًا والمخصّصة للفوترة (حتى الحدّ الأقصى للمساحة المتوفّرة، إن وُجد، والذي تحدّده Google) وانقر على حفظ.
إذا وصل استخدام واجهة برمجة التطبيقات إلى الحد الأقصى للحصة القابلة للفوترة في أي يوم معيّن، لن يتمكّن تطبيقك من الوصول إلى واجهة برمجة التطبيقات خلال الفترة المتبقية من ذلك اليوم.