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

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

كيفية فوترة Places API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • تتم فوترة كل طلب "إكمال تلقائي" (جديد)، بما يصل إلى 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)

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

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

خدمة الويب: id، name*، photos

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

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

رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)

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

خدمة الويب: addressComponents، adrFormatAddress، formattedAddress، location، plusCode، shortFormattedAddress، types، viewport

النطاق الزمني الشهري
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1000)
0.004 دولار أمريكي لكل
(4.00 دولارات أمريكية (أو ما يعادلها بالعملة المحلية) لكل 1000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد.

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

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

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

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

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

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

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

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

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

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

رمز التخزين التعريفي: تفاصيل المكان (يُفضَّل)

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

خدمة الويب: allowsDogs، curbsidePickup، delivery، dineIn، editorialSummary، evChargeOptions، fuelOptions، goodForChildren، goodForGroups، goodForWatchingSports، liveMusic، menuForChildren، parkingOptions، paymentOptions، outdoorSeating، allowsDogs, restroom, restroom، restroom، restroom, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, restroom, restroom, restroom, restroom،reservablereviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

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

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

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

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

خدمة الويب: places.accessibilityOptions، places.addressComponents، places.adrFormatAddress، places.businessStatus، places.displayName، places.formattedAddress، places.googleMapsUri، places.iconBackgroundColor، places.iconMaskBaseUri، places.id، places.location، places.name*، places.photos، places.plusCode، places.primaryTypeplaces.adrFormatAddress، places.primaryTypeDisplayName, places.primaryTypeDisplayName, places.iconMaskBaseUri, places.location, places.name*، places.photos، places.plusCode، places.primaryTypeplaces.adrFormatAddress، places.primaryTypeDisplayName, places.primaryTypeDisplayName, //}, places.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

places/PLACE_ID استخدِم places.displayName للوصول إلى الاسم النصي للمكان.

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

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

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

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

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

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

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

خدمة الويب: 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.allowsDogs، places.restroom, places.restroom، places.restroom،places.reservableplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

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

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

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

خدمة الويب: places.id، places.name*

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

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

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

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

خدمة الويب: 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.utcOffsetMinutesplaces.viewport

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

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

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

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

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

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

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

خدمة الويب: 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.allowsDogs، places.restroom, places.restroom، places.restroom،places.reservableplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

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

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

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

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

أسعار واجهة Places API

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

  • نظام التشغيل Android: Place.Field.ADDRESS أو Place.Field.ADDRESS_COMPONENTS أو Place.Field.BUSINESS_STATUS أو Place.Field.ICON_BACKGROUND_COLOR أو Place.Field.ICON_URL أو Place.Field.ID أو Place.Field.LAT_LNG أو Place.Field.NAME أو Place.Field.PHOTO_METADATAS أو Place.Field.PLUS_CODE أو Place.Field.TYPES أو Place.Field.VIEWPORT أو Place.Field.UTC_OFFSET أو Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
  • نظام التشغيل iOS: GMSPlaceFieldFormattedAddress أو GMSPlaceFieldBusinessStatus أو GMSPlaceFieldID أو GMSPlaceFieldCoordinate أو GMSPlaceFieldName أو GMSPlaceFieldPhotos أو GMSPlaceFieldPlusCode أوGMSPlaceFieldTypes أو GMSPlaceFieldViewport
  • خدمة الويب: address_component أو adr_address أو business_status أو formatted_address أو geometry أو icon أو name أو permanently_closed أو photo أو place_id أو plus_code أو type أو url أو utc_offset أو vicinity أو wheelchair_accessible_entrance
النطاق الزمني الشهري
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب الأماكن
أو أكثر من 0.00 دولار أمريكي
تكلفة طلب الأماكن
أو أكثر من 0.00 دولار أمريكي
تكلفة طلب الأماكن
أو أكثر من 0.00 دولار أمريكي

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

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

  • نظام التشغيل Android: Place.Field.CURRENT_OPENING_HOURS أو Place.Field.OPENING_HOURS أو Place.Field.PHONE_NUMBER أو Place.Field.SECONDARY_OPENING_HOURS أو Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours أو GMSPlaceFieldPhoneNumber أو GMSPlaceFieldWebsite
  • خدمة الويب: formatted_phone_number أو international_phone_number أو opening_hours أو current_opening_hours أو secondary_opening_hours أو website
النطاق الزمني الشهري
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب الأماكن
أو أكثر من 0.003 دولار أمريكي لكل 1,003 دولار أمريكي
(+ 3.00 دولار أمريكي لكل 1,000)
تكلفة طلب الأماكن
+ 0.0024 دولار أمريكي لكل منها
(+ 2.40 دولار أمريكي لكل 1,000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد.

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

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

  • أجهزة Android: Place.Field.CURBSIDE_PICKUP أو Place.Field.DELIVERY أو Place.Field.EDITORIAL_SUMMARY أو Place.Field.DINE_IN أو Place.Field.PRICE_LEVEL أو Place.Field.RATING أو Place.Field.RESERVABLE أو Place.Field.SERVES_BEER أو Place.Field.SERVES_BREAKFAST أو Place.Field.SERVES_BRUNCH أو Place.Field.SERVES_DINNER أو Place.Field.SERVES_LUNCH أو Place.Field.SERVES_VEGETARIAN_FOOD أو Place.Field.SERVES_WINE أوPlace.Field.TAKEOUT أو Place.Field.USER_RATINGS_TOTAL
  • نظام التشغيل iOS: GMSPlaceFieldPriceLevel أو GMSPlaceFieldRating أو GMSPlaceFieldUserRatingsTotal أو GMSPlaceFieldTakeout أو GMSPlaceFieldDelivery أو GMSPlaceFieldDineIn أو GMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable أوGMSPlaceFieldServesBreakfast أو GMSPlaceFieldServesLunch أو GMSPlaceFieldServesDinner أو GMSPlaceFieldServesBeer أو GMSPlaceFieldServesWine أو GMSPlaceFieldServesBrunch أو GMSPlaceFieldServesVegetarianFood.
  • JavaScript: راجِع الحقول (تفاصيل المكان)
  • خدمة الويب: curbside_pickup أو delivery أو dine_in أو editorial_summary أو price_level أو rating أو reservable أو reviews أو serves_beer أو serves_breakfast أو serves_brunch أو serves_dinner أو serves_lunch أو serves_vegetarian_food أو serves_wine أو takeout أو user_ratings_total.
النطاق الزمني الشهري
(السعر لكل مكالمة)
من 0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب الأماكن
+ 0.005 دولار أمريكي لكل منها
(+ 5.00 دولار أمريكي لكل 1,000)
تكلفة طلب الأماكن
+ 0.004 دولار أمريكي لكل 1,004 دولار أمريكي
(+ 4.00 دولار أمريكي لكل 1,000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد.

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة الويب

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

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

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة الويب

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

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

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

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

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

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


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

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

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

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

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

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

أمثلة

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

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

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

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

مثال

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

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

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

يتم تحصيل رسوم من خدمة العثور على مكان مقابل طلب "العثور على مكان".

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

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

أمثلة

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

رمز التخزين التعريفي: "البحث عن مكان" - المعرّف فقط

يتم تحصيل رسوم مقابل طلبات البحث عن مكان - رقم التعريف فقط التي تحدد فقط رقم تعريف المكان المطلوب عرضه. بشكل افتراضي، إذا لم يتم تحديد أي حقول في طلب البحث عن مكان، فسيتم عرض معرّف المكان فقط.

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

مثال

أنت تقدم طلب "بحث عن مكان" وتحدد فقط حقل 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 دولار أمريكي لكل 1000)
0.0256 دولار أمريكي لكل
(25.60 دولار أمريكي لكل 1000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر العدد.

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

مثال

أنت تُجري طلبًا باستخدام ميزة "البحث عن قرب"، مثل NearbySearch (San Francisco, 100 meters). ستظهر في فاتورتك رموز التخزين التعريفية التالية (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):

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

يتم تحصيل رسوم من Place - Text Search مقابل طلبات خدمة البحث النصي عن الأماكن في واجهة برمجة تطبيقات JavaScript (textSearch())، أو إلى خدمة البحث النصي في واجهة برمجة تطبيقات الأماكن.

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

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

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

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

مثال

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لعرض حدود الحصة لواجهة Places API أو تغييرها:

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

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


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