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

تذكير: لاستخدام Places API، عليك تفعيل الفوترة في كل مشروع من المشاريع وتضمين مفتاح واجهة برمجة التطبيقات أو رمز OAuth المميز مع كل طلبات واجهة برمجة التطبيقات أو حزمة تطوير البرامج (SDK).

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

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

خدمة الويب: accessibilityOptions، addressComponents، adrFormatAddress، businessStatus، displayName، formattedAddress، googleMapsUri، iconBackgroundColor، iconMaskBaseUri، location، primaryType، primaryTypeDisplayName، plusCode، shortFormattedAddress، subDestinations، types، utcOffsetMinutes، {19/viewport

نطاق الحجم الشهري (السعر لكل مكالمة)
من 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^{*/}، {17/0/}، outdoorSeating،}، outdoorSeating،}paymentOptionsreservablerestroomreviewsservesBeerservesBreakfastservesBrunchservesCocktailsservesCoffeeservesDessertsservesDinnerservesLunchservesVegetarianFoodservesWinetakeout

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

نطاق الحجم الشهري (السعر لكل مكالمة)
من 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.primaryType، places.primaryTypeDisplayName، places.primaryTypeDisplayName، ، / /places.nameplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport

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

نطاق الحجم الشهري (السعر لكل مكالمة)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000)	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 دولار أمريكي لكل 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^{*/}، {17/0/}، places.outdoorSeating،}، places.outdoorSeating،}places.paymentOptionsplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

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

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

---

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

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

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

خدمة الويب: 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 دولار أمريكي لكل 1,000)	0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1000)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

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

ملاحظة: في حال اختيار أي حقول من رمز التخزين التعريفي لخدمة Text Search (الخيار المفضَّل)، سيتم تحصيل الرسوم منك وفقًا لذلك المعدّل.

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

خدمة الويب: 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 دولار أمريكي لكل 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^{*/}، {17/0/}، places.outdoorSeating،}، places.outdoorSeating،}places.paymentOptionsplaces.reservableplaces.restroomplaces.reviewsplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

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

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

---

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

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

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

---

تحديد أسعار واجهة Places API

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

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

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

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

• خدمة الإكمال التلقائي لأماكن "واجهة برمجة التطبيقات للأماكن" أو خدمة الإكمال التلقائي للأماكن في "واجهة برمجة تطبيقات الأماكن" في "خرائط Google". يجب تصميم تطبيقك لتوفير الرموز المميّزة للجلسة (قد تحتاج إلى تغيير الرمز الحالي).
• أداة الإكمال التلقائي في Maps JavaScript API. ويتم تفعيل الفوترة المستندة إلى الجلسة تلقائيًا على هذه التطبيقات المصغّرة، بدون الحاجة إلى تغيير الرمز.

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

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

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

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

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

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

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

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

• تفاصيل الأماكن
• البحث عن مكان

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

• الأماكن – البحث القريب
• الأماكن – البحث النصي

---

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

ملاحظة: رمز التخزين التعريفي هذا هو رمز تخزين تعريفي للبيانات يتم تحصيل الرسوم منه بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي أدى إلى تشغيله.

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

• أجهزة 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 أو GMSPlaceFieldBusinesssStatus أو 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 دولار أمريكي (أو ما يعادله بالعملة المحلية) لكل إقامة (+ 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_VEGETARIAN_FOOD أو Place.Field.SERVES_WINE أوPlace.Field.TAKEOUT أو Place.Field.USER_RATINGS_TOTALPlace.Field.SERVES_LUNCH
• 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)	يُرجى التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة.

---

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

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

• على أجهزة Android: findAutocompletePredictions()
• على أجهزة iOS: findAutocompletePredictionsFromQuery:
• JavaScript: خدمة الإكمال التلقائي للأماكن من خلال واجهة برمجة التطبيقات JavaScript API
• خدمة الويب: خدمة الإكمال التلقائي لمكان المكان

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

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

نطاق الحجم الشهري (السعر لكل طلب)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000)	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

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))

iOS

• placeClient?.findAutocompleteForecastions(fromQuery: "par" ...
• placeClient?.findAutocompleteForecastions(fromQuery: "paris" ...

خدمة الويب

• طلب الإكمال التلقائي لمكان (input=”par”, session_token: XYZ)
• طلب الإكمال التلقائي لمكان (input=”paris”, session_token: XYZ)

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

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

---

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

ملاحظة: يظهر رمز التخزين التعريفي هذا في تقارير الفوترة، ولكن ليس في صفحة الفوترة > الأسعار في Google Cloud Console.

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

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

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

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

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

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

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

مثال

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

Android

• findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
• findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
• fetchPlace() (باستخدام FetchPlaceRequest بما في ذلك رقم تعريف المكان والحقل ADDRESS)

iOS

• placeClient?.findAutocompleteForecastions(fromQuery: "par" ...
• placeClient?.findAutocompleteForecastions(fromQuery: "paris" ...
• fetchPlaceFromPlaceID: (بما في ذلك رقم تعريف المكان والحقل GMSPlaceFieldFormattedAddress)

خدمة الويب

• طلب الإكمال التلقائي للأماكن (input=”par”, session_token: XYZ)
• طلب الإكمال التلقائي للأماكن (input=”paris”, session_token: XYZ)
• تفاصيل الأماكن (place_id وsession_token: XYZ، الحقول:Formatting_address)

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

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

---

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

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

• JavaScript: خدمة الإكمال التلقائي للأماكن في "واجهة برمجة تطبيقات JavaScript للخرائط" (getQueryPredictions()) واستخدام أداة SearchBox لواجهة برمجة تطبيقات JavaScript للخرائط (يتم إنشاء طلبات الإكمال التلقائي لطلب البحث كأنواع المستخدمين).
• خدمة الويب: خدمة الإكمال التلقائي لطلب بحث الأماكن

نطاق الحجم الشهري (السعر لكل طلب)
من 0 إلى 100,000	من 100,001 إلى 500,000	أكثر من 500,000
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000)	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: حزمة تطوير البرامج لأماكن Google لأجهزة Android (fetchPlace())
• iOS: Places SDK for iOS (fetchPlaceFromPlaceID:)
• JavaScript: خدمة "تفاصيل المكان" من واجهة برمجة تطبيقات JavaScript للخرائط (getDetails)
• JavaScript: أداة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (getPlace)
• JavaScript: أداة Place SearchBox في واجهة برمجة تطبيقات "خرائط Google": getPlaces() بعد أن يختار المستخدم نتيجة مكان (رمز: تثبيت)، *وليس* طلب بحث (رمز: المكبِّر)، كما هو موضّح هنا:

  

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

• خدمة الويب: خدمة Places API في Place

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

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

أمثلة

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 دولار أمريكي لكل طلب)
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 SAR	0.00 SAR	0.00 SAR

مثال

تقديم طلب تفاصيل المكان مع تحديد حقل معرّف المكان فقط: 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 دولار أمريكي لكل مكالمة)
   • البيانات الأساسية (تحصيل الفواتير بقيمة 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 SAR	0.00 SAR	0.00 SAR

مثال

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

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

---

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

يتم تحصيل رسوم مقابل المكان - البحث القريب مقابل الطلبات المرسَلة إلى خدمة "البحث عن الأماكن القريبة" في واجهة برمجة تطبيقات JavaScript للخرائط (nearbySearch())، أو إلى خدمة "البحث عن الأماكن القريبة" في واجهة برمجة التطبيقات للأماكن

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

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

مثال

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

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

---

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

يتم تحصيل رسوم من Places – Text Search مقابل الطلبات المرسَلة إلى خدمة البحث النصي عن المكان باستخدام واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" (textSearch())، أو خدمة البحث النصي لواجهة برمجة تطبيقات الأماكن.

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

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

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

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

مثال

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

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

---

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

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

• Android: مكالمات إلى الرقم fetchPhoto()
• iOS: المكالمات إلى loadPlacePhoto:
• JavaScript: في Places Library (مكتبة الأماكن)، خدمة Google Places Photos (صور الأماكن) في واجهة برمجة تطبيقات JavaScript API عند طلب البيانات من عناوين URL التي يعرضها PlacePhoto.getUrl() لتحميل بيانات بكسل الصور
• خدمة الويب: الطلبات إلى خدمة صور الأماكن من واجهة برمجة تطبيقات الأماكن

بالنسبة إلى خدمة 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، إن وجد) وانقر على حفظ.

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

موارد إدارة التكاليف ذات الصلة

• الفوترة وأسعار "منصة خرائط Google"
• إعداد التقارير والتتبُّع في "منصة خرائط Google"

---

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