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

تستخدم ‫Places API (الجديدة) وPlaces API نموذج تسعير "الدفع حسب الاستخدام". تؤدي طلبات Places API (الجديدة) وPlaces API إلى إنشاء طلبات إلى أي من رموز التخزين التعريفية المتعددة. بالإضافة إلى بنود استخدام Google العامة، هناك حدود استخدام خاصة لواجهة Places API. إدارة التكاليف ومستوى الاستخدام باستخدام الأدوات المتاحة في Google Cloud Console

كيفية تحصيل الرسوم من Places API

تستخدم ‫Places API (الجديدة) وPlaces API نموذج الدفع حسب الاستخدام. يتم تحصيل فواتير واجهات برمجة التطبيقات وحزم تطوير البرامج (SDK) في منصة خرائط Google بواسطة رمز التخزين التعريفي. يتم تتبُّع الاستخدام لكل رمز تخزين تعريفي، وقد تحتوي أي واجهة برمجة تطبيقات أو حزمة تطوير برامج (SDK) على أكثر من رمز تخزين تعريفي للمنتج واحد. يتم احتساب التكلفة من خلال:

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

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

أسعار Places API (جديدة)

لمحة عن أقنعة الحقول

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

يعد استخدام إخفاء المجال ممارسة جيدة على التصميم لضمان عدم طلب بيانات غير ضرورية، مما يساعد على تجنب وقت المعالجة ورسوم الفوترة غير الضرورية.

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

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

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

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

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

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

يتم تحصيل رسوم رمز التخزين التعريفي طلبات الإكمال التلقائي مقابل كل طلب إلى واجهة برمجة التطبيقات Autocomplete (New) API لا يتضمّن رمز جلسة.

يتم أيضًا تحصيل الرسوم في حال استخدام الرموز المميّزة للجلسات وتنفيذ أيّ مما يلي:

  • يمكنك إنهاء الجلسات من خلال طلب واحد إلى "تفاصيل المكان" (جديد) الذي يطلب أي حقول محدّدة من خلال رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
    • يتم تحصيل رسوم كل طلب من طلبات الإكمال التلقائي (الجديدة) التي تصل إلى 12 طلبًا باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
    • يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
  • يمكنك التخلي عن الجلسة أو إنهائها من خلال إجراء مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط). وبعد ذلك، تتم فوترة جميع طلبات الإكمال التلقائي (الجديدة) باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي

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

يتم تحصيل رسوم رمز التخزين التعريفي هذا في السيناريوهات التالية:

  • تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط):

    • يتم تحصيل رسوم كل طلب من طلبات الإكمال التلقائي (الجديدة) التي تصل إلى 12 طلبًا باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
    • يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".

  • تم إنهاء جلسة الإكمال التلقائي بالاتصال بـ رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة).

    يتم تحصيل رسوم طلب بيانات عن مكان يطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة) وفقًا لرمز التخزين التعريفي: تفاصيل المكان (مفضّلة).

  • تم إنهاء جلسة الإكمال التلقائي باستدعاء رمز التخزين التعريفي: التحقق من صحة العنوان المفضَّل.

لمزيد من المعلومات، يُرجى الاطّلاع على الإكمال التلقائي (جديد) وتسعير الجلسات.

النطاق الشهري للحجم
(سعر المكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: تفاصيل المكان (أساسية)

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

خدمة الويب: accessibilityOptions، businessStatus، containingPlaces، displayName، googleMapsLinks*، googleMapsUri، iconBackgroundColor، iconMaskBaseUri، primaryType، primaryTypeDisplayName، pureServiceAreaBusiness، subDestinations، utcOffsetMinutes

* الحقل googleMapsLinks في مرحلة المعاينة قبل الإصدار العلني ولا يتم تحصيل رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.

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

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

رمز التخزين التعريفي: تفاصيل المكان (إعداد متقدّم)

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

خدمة الويب: currentOpeningHours، currentSecondaryOpeningHours، internationalPhoneNumber، nationalPhoneNumber، priceLevel، priceRange، rating، regularOpeningHours، regularSecondaryOpeningHours، userRatingCount، websiteUri

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

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
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

* البحث النصي والبحث عن الأماكن المجاورة فقط

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

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.025 دولار أمريكي لكل
(25.00 دولار أمريكي لكل 1,000)		 ‫0.020 دولار أمريكي لكل
(20.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث عن قرب (أساسي)

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

خدمة الويب: places.accessibilityOptions، places.addressComponents، places.adrFormatAddress، places.attributions، places.businessStatus، places.containingPlaces، places.displayName، places.formattedAddress، places.googleMapsLinks*، places.googleMapsUri، places.iconBackgroundColor، places.iconMaskBaseUri، places.id، places.location، places.name**، places.photos، places.plusCode، places.primaryType، places.primaryTypeDisplayName، places.pureServiceAreaBusiness، places.shortFormattedAddress، places.subDestinations، places.types، places.utcOffsetMinutes، places.viewport

* الحقل places.googleMapsLinks في مرحلة المعاينة قبل الإصدار العلني ولا يتم تحصيل رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.

** يحتوي الحقل places.name على اسم المورد للمكان على النحو التالي: places/PLACE_ID. استخدِم places.displayName للوصول إلى الاسم النصي للمكان.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.032 دولار أمريكي لكل
(32.00 دولار أمريكي لكل 1,000)		 ‫0.0256 دولار أمريكي لكل
(25.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث في الأماكن القريبة (متقدّم)

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

خدمة الويب: places.currentOpeningHours، places.currentSecondaryOpeningHours، places.internationalPhoneNumber، places.nationalPhoneNumber، places.priceLevel، places.priceRange، places.rating، places.regularOpeningHours، places.regularSecondaryOpeningHours، places.userRatingCount، places.websiteUri

النطاق الشهري للحجم
(سعر المكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.035 دولار أمريكي لكل
(35.00 دولار أمريكي لكل 1,000)		 ‫0.028 دولار أمريكي لكل
(28.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث عن قرب (مفضل)

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

, , places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.curbsidePickup, places.delivery, places.dineIn,places.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.routingSummariesplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.0 دولار أمريكي لكل
(0.00 دولار أمريكي لكل 1,000)		 0.0 دولار أمريكي لكل
(0.00 دولار أمريكي لكل 1,000)		 0.0 دولار أمريكي لكل
(0.00 دولار أمريكي لكل 1,000)

رمز التخزين التعريفي: البحث بالكتابة (أساسي)

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

خدمة الويب: places.accessibilityOptions، places.addressComponents، places.adrFormatAddress، places.businessStatus، places.containingPlaces، places.displayName، places.formattedAddress، places.googleMapsLinks*، places.googleMapsUri، places.iconBackgroundColor، places.iconMaskBaseUri، places.location، places.photos، places.plusCode، places.primaryType، places.primaryTypeDisplayName، places.pureServiceAreaBusiness، places.shortFormattedAddress، places.subDestinations، places.types، places.utcOffsetMinutes، places.viewport

* الحقل places.googleMapsLinks في مرحلة المعاينة قبل الإصدار العلني ولا يتم تحصيل رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.032 دولار أمريكي لكل
(32.00 دولار أمريكي لكل 1,000)		 ‫0.0256 دولار أمريكي لكل
(25.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث النصي (متقدّم)

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

خدمة الويب: places.currentOpeningHours، places.currentSecondaryOpeningHours، places.internationalPhoneNumber، places.nationalPhoneNumber، places.priceLevel، places.priceRange، places.rating، places.regularOpeningHours، places.regularSecondaryOpeningHours، places.userRatingCount، places.websiteUri

النطاق الشهري للحجم
(سعر المكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.035 دولار أمريكي لكل
(35.00 دولار أمريكي لكل 1,000)		 ‫0.028 دولار أمريكي لكل
(28.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: البحث النصي (الخيار المفضّل)

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

, , places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.curbsidePickup, places.delivery, places.dineIn,places.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.routingSummariesplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.040 دولار أمريكي لكل
(40.00 دولار أمريكي لكل 1,000)		 ‫0.032 دولار أمريكي لكل
(32.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

أسعار واجهة برمجة التطبيقات Places API

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

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

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

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

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

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

لمحة عن أرقام تعريف المنتجات في "بيانات الأماكن"

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

يتم تنشيط رمز تخزين تعريفي واحد أو أكثر للبيانات في الحالات التالية:

  • Android: كل طلب إلى fetchPlace() أو findCurrentPlace()
  • iOS: كل مكالمة إلى fetchPlaceFromPlaceID: أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
  • خدمة الويب: كل طلب من طلبات "الأماكن" استنادًا إلى الحقول المحدّدة في الطلب

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

بالنسبة إلى خدمة الويب، تتيح طلبات البيانات هذه من Places API تحديد حقول البيانات التي سيتم عرضها:

بالنسبة إلى خدمة الويب، لا تتيح استدعاءات Places API هذه تحديد الحقول التي تم عرضها. تُعرِض هذه الطلبات دائمًا جميع بيانات "الأماكن"، ما يؤدي إلى تحصيل رسوم رمزَي التخزين التعريفيَين "بيانات الأماكن" و"بيانات الأماكن في خرائط Google" و"بيانات الأماكن في خرائط Google للأماكن"، بالإضافة إلى رسوم كل طلب واجهة برمجة تطبيقات:

رمز التخزين التعريفي: البيانات الأساسية

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

  • 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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب الأماكن
+ 0.00 دولار أمريكي		 تكلفة طلب ميزة "الأماكن"
+ 0.00 دولار أمريكي		 تكلفة طلب الأماكن
+ 0.00 دولار أمريكي

رمز التخزين التعريفي: بيانات جهة الاتصال

باستخدام مَعلمة الحقول في طلب "تفاصيل المكان" أو "العثور على مكان" لخدمات الويب، أو صفيف من Place.Field لنظامَي التشغيل Android أو iOS، يمكنك حصر الاستجابة بالحقول المحدّدة فقط. تؤدي الحقول في فئة جهة الاتصال إلى تحصيل رسوم إضافية. يتم تنشيط رمز التخزين التعريفي Contact Data عند طلب أيّ من الحقول التالية:

  • 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_number أو international_phone_number أو opening_hours أو current_opening_hours أو secondary_opening_hours أو website
النطاق الشهري للحجم
(سعر المكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب أماكن
+ 0.003 دولار أمريكي لكل مكان
(+ 3.00 دولار أمريكي لكل 1,000 مكان)		 تكلفة طلب أماكن
+ 0.0024 دولار أمريكي لكل طلب
(+ 2.40 دولار أمريكي لكل 1,000 طلب)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان"، يمكنك حصر الاستجابة بالحقول المحدّدة فقط. تؤدي الحقول في فئة Atmosphere إلى تحصيل رسوم إضافية. يتم بدء رمز التخزين التعريفي Atmosphere Data عند طلب أيّ من الحقول التالية:

  • 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 وGMSPlaceFieldRating GMSPlaceFieldUserRatingsTotal وGMSPlaceFieldTakeout وGMSPlaceFieldDelivery وGMSPlaceFieldDineIn وGMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable وGMSPlaceFieldServesBreakfast وGMSPlaceFieldServesLunch وGMSPlaceFieldServesDinner وGMSPlaceFieldServesBeer GMSPlaceFieldServesWine أو GMSPlaceFieldServesBrunch أو GMSPlaceFieldServesVegetarianFood
  • JavaScript: اطّلِع على الحقول (تفاصيل المكان).
  • خدمة الويب: curbside_pickup أو delivery أو dine_in أو editorial_summary أو price_level أو rating أو reservable أو reviews أو serves_beer أو serves_breakfast أو serves_brunch أو serves_dinner أو serves_lunch أو serves_vegetarian_food أو serves_wine أو takeout أو user_ratings_total.
نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب أماكن
+ 0.005 دولار أمريكي لكل مكان
(+ 5.00 دولار أمريكي لكل 1,000 مكان)		 تكلفة طلب أماكن
+ 0.004 دولار أمريكي لكل طلب
(+ 4.00 دولار أمريكي لكل 1,000 طلب)		 يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

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

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

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

قد يتم تحصيل رسوم على طلبات الإكمال التلقائي من أداة الإكمال التلقائي للأماكن في Maps JavaScript API مقابل رمز التخزين التعريفي الخاص بالإكمال التلقائي - لكل طلب في حال إجراء الطلبات من جلسة إكمال تلقائي غير صالحة. قد يحدث ذلك عندما يكتب المستخدم عناوين مختلفة متعددة أو ينسخ عناوين مختلفة أو يلصقها في التطبيق المصغّر ولا يختار دائمًا اقتراحًا للإكمال التلقائي.

نطاق الحجم الشهري
(السعر لكل طلب)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة مقابل جلسة الإكمال التلقائي التي لا تتضمّن طلب "تفاصيل الأماكن" (خلال بضع دقائق من بدء الجلسة).

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

مثال

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

Android

iOS

خدمة ويب

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

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

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة ويب

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

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

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

يتم تحصيل رسوم رمز التخزين التعريفي إكمال طلبات البحث تلقائيًا - لكل طلب مقابل كل طلب من أجل:

نطاق الحجم الشهري
(السعر لكل طلب)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

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

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

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

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

أمثلة

  1. أجرِ أحد المكالمات أو الطلبات التالية:
    • الأجهزة الجوّالة: اتصل بالرقم fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد حقل ADDRESS فقط.
    • Web API أو الخدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address)
    ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
    • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
  2. يمكنك إجراء أحد هذه المكالمات أو الطلبات:
    • الجهاز الجوّال: يمكنك الاتصال بـ fetchPlace() على نظام التشغيل Android أو fetchPlaceFromPlaceID: على iOS، مع تحديد الحقل PHONE_NUMBER فقط.
    • Web API أو الخدمة: يمكنك تقديم طلب للحصول على تفاصيل المكان وتحديد حقل رقم الهاتف: getPlaceDetails(fields: formatted_phone_number)
    ستظهر رموز التخزين التعريفية هذه في فاتورتك (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
    • تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
  3. يمكنك إجراء أحد هذه المكالمات أو الطلبات:
    • الأجهزة الجوّالة: اتصل على fetchPlace() على Android أو fetchPlaceFromPlaceID: على iOS، وحدِّد جميع الحقول.
    • واجهة برمجة تطبيقات أو خدمات على الويب: يمكنك تقديم طلب "تفاصيل المكان" وتحديد جميع الحقول (يكون هذا النوع من الطلبات الإعداد التلقائي في حال عدم تحديد أي حقول): getPlaceDetails().
    ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
    • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
    • بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

رمز التخزين التعريفي: تفاصيل المكان – إعادة تحميل المعرّف

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

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

مثال

قدِّم طلبًا للحصول على تفاصيل المكان مع تحديد حقل رقم تعريف المكان فقط: getPlaceDetails(fields: place_id). سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

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

SKU: البحث عن مكان

يتم تحصيل رسوم من Find Place مقابل طلب البحث عن مكان.

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

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

أمثلة

  1. يمكنك تقديم طلب "العثور على مكان" وتحديد حقل العنوان فقط: FindPlace(fields: formatted_address). ستظهر في فاتورتك رموز التخزين التعريفية هذه مُدرَجة (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
    • العثور على مكان (يبدأ السعر من 0.017 دولار أمريكي لكل مكالمة)
    • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
  2. يمكنك تقديم طلب "العثور على مكان" وتحديد حقل رقم الهاتف: FindPlace(fields: formatted_phone_number). في فاتورتك، ستظهر لك رموز التخزين التعريفية هذه مُدرَجة (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
    • البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
  3. يمكنك تقديم طلب "العثور على مكان" وتحديد حقول من جميع حِزم أنواع البيانات الثلاثة: FindPlace(fields: formatted_address, opening_hours, price_level). في فاتورتك، ستظهر لك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • البحث عن مكان (يبدأ سعر المكالمة من 0.017 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية))
    • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
    • بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)

رمز التخزين التعريفي: العثور على مكان - رقم التعريف فقط

يتم تحصيل رسوم العثور على مكان: رقم التعريف فقط مقابل طلبات "العثور على مكان" التي تحديد فقط رقم تعريف المكان المطلوب عرضه. إذا لم يتم تحديد أي حقول في طلب البحث عن مكان، يتم تلقائيًا عرض رقم تعريف المكان فقط.

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

مثال

يمكنك تقديم طلب "العثور على مكان" وتحديد حقل place_id فقط: FindPlace(fields: place_id). سيظهر رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

  • البحث عن مكان - رقم التعريف فقط (تحصيل الفواتير بسعر 0.00 دولار أمريكي)

يتم تحصيل رسوم البحث عن الأماكن المجاورة مقابل الطلبات المرسَلة إلى خدمة البحث عن الأماكن المجاورة في Maps JavaScript API (nearbySearch())، أو إلى خدمة البحث عن الأماكن المجاورة في Places API.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.032 دولار أمريكي لكل
(32.00 دولار أمريكي لكل 1,000)		 ‫0.0256 دولار أمريكي لكل
(25.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم أيضًا إنشاء رمز التخزين التعريفي للبحث عن الأماكن باستخدام نص من خلال الرمز البرمجي لوحدة "مربّع البحث عن الأماكن" في واجهة برمجة التطبيقات JavaScript لخرائط Google: getPlaces() بعد أن يختار المستخدم طلب بحث عن مكان (الرمز: مكبّر)، وليس نتيجة (الرمز: دبوس)، كما هو موضّح هنا:

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

مثال

يمكنك تقديم طلب بحث نصي، مثل TextSearch(123 Main Street). في فاتورتك، ستظهر لك رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):

  • المكان: البحث النصي (يبدأ السعر من 0.032 دولار أمريكي لكل مكالمة)
  • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
  • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
  • بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

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

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

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

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

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

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

  • Places API (الإصدار الجديد): الحدّ الأقصى للمعدل هو 600 طلب كل دقيقة (طلبات في الدقيقة) لكل طريقة لواجهة برمجة التطبيقات في كل مشروع. بمعنى أن لكل طريقة من طرق واجهة برمجة التطبيقات حصة منفصلة

  • ‫Places API: الحدّ الأقصى للمعدل هو 6,000 طلب في الدقيقة (طلبات في الدقيقة). ويتم احتسابه على أنّه مجموع الطلبات من جهة العميل وتلك من جهة الخادم لجميع التطبيقات التي تستخدم بيانات اعتماد المشروع نفسه.

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

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

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

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

للاطّلاع على حدود الحصص أو تغييرها لواجهة برمجة التطبيقات Places API:

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

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