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

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

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

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

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

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

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

حول جلسات الإكمال التلقائي

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

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

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

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

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

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

وحدات SKU لبيانات الأماكن الثلاثة هي: البيانات الأساسية، وبيانات جهة الاتصال، وبيانات الغلاف الجوي.

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

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

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

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

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


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

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

  • نظام التشغيل 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 دولارات أمريكية لكل 1000 دولار أمريكي)
تكلفة طلب الأماكن
+ 0.0024 دولار لكل منها
(+ 2.40 USD لكل 1000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد.

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

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

  • نظام التشغيل Android: Place.Field.CURBSIDE_PICKUP أو Place.Field.DELIVERY أو 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.
  • جافا سكريبت: راجع الحقول (تفاصيل المكان)
  • خدمة الويب: 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 USD لكل 1000)
تكلفة طلب الأماكن
زائد 0.004 دولار لكل منها
(+ 4.00 USD لكل 1000)
يُرجى التواصل مع فريق المبيعات لمعرفة سعر المجلّد.

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

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

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

قد يتم تحصيل رسوم من خدمة الإكمال التلقائي لطلبات من أداة الإكمال التلقائي لـ "واجهة برمجة تطبيقات 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

iOS

خدمة ويب

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

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

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة ويب

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

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

SKU: الإكمال التلقائي لطلبات البحث – لكل طلب

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

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

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

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

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

أمثلة

  1. نفِّذ أحد هذه المكالمات أو الطلبات:
    • الجوّال: يمكنك الاتصال بـ fetchPlace() على نظام التشغيل Android أو fetchPlaceFromPlaceID: على iOS، وتحديد الحقل ADDRESS فقط
    • واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب "تفاصيل المكان" وتحديد حقل العنوان فقط: getPlaceDetails(fields: formatted_address)
    على فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
    • البيانات الأساسية (تحصيل الفواتير بسعر 0.00 SAR)
  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 SAR)
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
    • بيانات الغلاف الجوي (سعر يبدأ من 0.005 دولار أمريكي لكل طلب)

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

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

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

مثال

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

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

أمثلة

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

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

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

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

مثال

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

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

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

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

يتم تحصيل رسوم من 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 دولارًا أمريكيًا لكل طلب، بالإضافة إلى جميع رموز التخزين التعريفية من نوع البيانات (البيانات الأساسية وبيانات جهات الاتصال وبيانات الغلاف الجوي).

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

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

مثال

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

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

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

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

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

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

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

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

  • يبلغ الحدّ الأقصى لمعدّل الزحف 100 طلب في الثانية. ويتم حسابها من خلال مجموع الطلبات من جهة العميل والطلبات من جانب الخادم لجميع التطبيقات باستخدام بيانات اعتماد المشروع نفسه.

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

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

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

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

لعرض حدود الحصة أو تغييرها لواجهة برمجة تطبيقات الأماكن:

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

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


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