استخدام واجهة برمجة التطبيقات Maps JavaScript API والفوترة

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

الفوترة والأسعار في Maps JavaScript API

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

رمز التخزين التعريفي: الخرائط الديناميكية

تفرض وحدة الاحتفاظ بالمخزون هذه رسومًا مقابل عمليات تحميل الخرائط عندما يعرض أحد التطبيقات خريطة.

  Category (الفئة) Essentials
  الحدث القابل للفوترة تحميل الخريطة
  عوامل التفعيل

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

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

  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي

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

  Category (الفئة) Pro
  الحدث القابل للفوترة بانوراما
  عوامل التفعيل

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

  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

أسعار Places Library وMaps JavaScript API

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا في الحالات التالية:

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

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب
  عوامل التفعيل

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

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

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

  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات الحصول على تفاصيل الأماكن التي لا تعرض سوى معرّف المكان.

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

  • Places Library، وMaps JavaScript API:
    id
    photos

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل الطلبات التي يتم إرسالها إلى Place Details API لاسترداد الحقول الواردة في رمز التخزين التعريفي هذا.
  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند طلب حقول الموقع الجغرافي التالية:

  • Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google":
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    types
    viewport

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Place Details Pro

تُحصّل رمز التخزين التعريفي هذا رسومًا مقابل الحقول التي تحدّدها في طلب Place Details Pro.

  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط أو الحقول ذات معدّل السعر الأدنى:
  • Places Library، واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google":
    accessibilityOptions
    businessStatus
    displayName
    googleMapsUri
    iconBackgroundColor
    primaryTypeDisplayName
    svgIconMaskURI
    types
    utcOffsetMinutes

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Place Details Enterprise

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلب "الأماكن" الذي يتضمّن حقول Enterprise.

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:
  • Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google": internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

إذا أنهيت جلسة "الإكمال التلقائي" من خلال طلب أي حقل من رمز التخزين التعريفي: Place Details Essentials أو Pro أو Enterprise أو Enterprise + Atmosphere، يتم تحصيل رسوم المكالمة وفقًا لرمز التخزين التعريفي: Place Details Enterprise + Atmosphere. لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: واجهة برمجة التطبيقات Places API لعرض تفاصيل الأماكن في Enterprise + Atmosphere

تفرض فئة التخزين التعريفي هذه رسومًا على طلبات البيانات من واجهة برمجة التطبيقات Place Details API التي تطلب حقول الغلاف الجوي المحدّدة.

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

  • Places Library، واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google":
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

إذا تم إنهاء جلسة الإكمال التلقائي من خلال طلب أي حقل من رمز التخزين التعريفي: Place Details Essentials أو Pro أو Enterprise أو Enterprise + Atmosphere، يتم تحصيل رسوم المكالمة وفقًا رمز التخزين التعريفي: Place Details Enterprise + Atmosphere. لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Nearby Search Pro

تُحصّل فئة التخزين التعريفية هذه رسومًا مقابل الحقول التي تحدّدها في طلب Nearby Search Pro.

  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط أو الحقول ذات معدّل السعر الأدنى:
  • Places Library، وMaps JavaScript API:
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    id
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    viewport

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Nearby Search Enterprise

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات "البحث عن الأنشطة التجارية القريبة" التي تتضمّن أي حقول Enterprise.

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

  • Places Library، واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google":
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Nearby Search Enterprise + Atmosphere

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

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:

  • Places Library، واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google":
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

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

يتم تحصيل رسوم رمز التخزين التعريفي هذا مقابل الطلبات التي يتم إرسالها إلى Text Search API والتي تعرض أرقام تعريف فقط.
  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند طلب فقط الحقول التالية:

  • Places Library، وMaps JavaScript API:
    id

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Text Search Pro

رمز التخزين التعريفي هذا هو رمز تخزين تعريفي للبيانات يتم تحصيل رسومه مقابل الحقول التي تحدّدها في طلب Text Search Pro.
  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند طلب فقط الحقول التالية أو حقول الأسعار الأقل:
  • Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
    accessibilityOptions
    addressComponents
    adrFormatAddress
    businessStatus
    displayName
    formattedAddress
    googleMapsUri
    iconBackgroundColor
    location
    photos
    plusCode
    svgIconMaskURI
    types
    utcOffsetMinutes
    viewport

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: Places API Text Search Enterprise

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات "البحث النصي" التي تتضمّن أي حقول في Enterprise.

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:
  • Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google":
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    rating
    regularOpeningHours
    userRatingCount
    websiteUri

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

رمز التخزين التعريفي: البحث النصي في Places API لإصدار Enterprise + Atmosphere

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات البحث النصي التي تتضمّن أي حقول للجو.

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية:
  • Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
    allowsDogs
    editorialSummary
    evChargeOptions
    fuelOptions
    hasCurbsidePickup
    hasDelivery
    hasDineIn
    hasLiveMusic
    hasMenuForChildren
    hasOutdoorSeating
    hasRestroom
    hasTakeout
    hasWifi
    isGoodForChildren
    isGoodForGroups
    isGoodForWatchingSports
    isReservable
    parkingOptions
    paymentOptions
    priceLevel
    reviews
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine

  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

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

يُستخدَم رمز التخزين التعريفي هذا لفواتير طلبات "صور تفاصيل المكان".

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تفعيل الفوترة عند طلب صورة من Place Details API.
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي البيانات الأساسية عند طلب أيّ من الحقول التالية:
  • Android:
    Place.Field.ACCESSIBILITY_OPTIONS
    Place.Field.ADDRESS_COMPONENTS
    Place.Field.BUSINESS_STATUS
    Place.Field.DISPLAY_NAME
    Place.Field.FORMATTED_ADDRESS
    Place.Field.ICON_BACKGROUND_COLOR
    Place.Field.ICON_MASK_URL
    Place.Field.ID
    Place.Field.LOCATION
    Place.Field.PHOTO_METADATAS
    Place.Field.PLUS_CODE
    Place.Field.TYPES
    Place.Field.VIEWPORT
    Place.Field.UTC_OFFSET.
  • أجهزة iOS:
    GMSPlaceFieldFormattedAddress
    GMSPlaceFieldBusinessStatus
    GMSPlaceFieldID
    GMSPlaceFieldCoordinate
    GMSPlaceFieldName
    GMSPlaceFieldPhotos
    GMSPlaceFieldPlusCode
    GMSPlaceFieldTypes
    GMSPlaceFieldViewport
  • خدمة الويب:
    address_component
    adr_address
    business_status
    formatted_address
    geometry
    icon
    name
    permanently_closed
    photo
    place_id
    plus_code
    type
    url
    utc_offset
    vicinity
    wheelchair_accessible_entrance
  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

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

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

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

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي Contact Data عند طلب أيّ من الحقول التالية:
  • Android: Place.Field.CURRENT_OPENING_HOURS أو Place.Field.INTERNATIONAL_PHONE_NUMBER أو Place.Field.OPENING_HOURS أو Place.Field.SECONDARY_OPENING_HOURS أو Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHours أو GMSPlaceFieldPhoneNumber أو GMSPlaceFieldWebsite
  • خدمة ويب: formatted_phone_number international_phone_number أو opening_hours current_opening_hours أو secondary_opening_hours website
  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل الطلبات التي يتم إرسالها إلى واجهة برمجة التطبيقات Atmosphere Data API والتي تحدّد الحقول في رمز التخزين التعريفي هذا.

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب باستخدام أقنعة الحقول المحدّدة
  عوامل التفعيل يتم تفعيل الفوترة عند طلب أيّ من الحقول التالية:
AndroidiOSJavaScript
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.EDITORIAL_SUMMARY
Place.Field.DINE_IN
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.RESERVABLE
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT
Place.Field.USER_RATING_COUNT
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.
  أمثلة على الفوترة باستخدام قناع الحقل

في ما يلي أمثلة على كيفية فوترة الطلب استنادًا إلى الحقول التي تختارها في قناع الحقول.

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

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

تُستخدم رمز التخزين التعريفي هذا لفواتير الطلبات التي لا تتضمّن رمز أمان الجلسة.

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تفعيل الفوترة لما يلي:
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

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

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

  Category (الفئة) Pro
  الحدث القابل للفوترة الجلسة
  عوامل التفعيل يتم تفعيل الفوترة إذا أرسل تطبيقك الطلبَين التاليَين في جلسة واحدة:

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

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

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الجلسة
  عوامل التفعيل الإكمال التلقائي (مضمّن في تفاصيل الأماكن) - لكل جلسة: يتم تحصيل رسوم رمز التخزين التعريفي مقابل جلسة الإكمال التلقائي التي تتضمّن أيًا من الطلبات التالية:
  • Android: مكالمة إلى fetchPlace()
  • iOS: طلب إلى fetchPlaceFromPlaceID:
  • خدمة الويب: طلب تفاصيل مكان

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

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

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

  أمثلة

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

خدمة ويب

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

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

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب
  عوامل التفعيل

يتم تنشيط رمز التخزين التعريفي هذا عند تقديم طلب ميزة "الإكمال التلقائي للطلبات" باستخدام الخدمات التالية:

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

  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

رمز التخزين التعريفي: Place Details Pro

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

  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تفعيل الفوترة للطلبات الواردة من واجهات برمجة التطبيقات التالية:

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

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

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

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

تفرض رمز التخزين التعريفي هذا رسومًا على الطلبات التي يتم إرسالها إلى Place Details API من أجل إعادة تحميل أرقام تعريف الأماكن القديمة.

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تفعيل الفوترة عند تقديم طلب للحصول على تفاصيل عن مكان معيّن مع تحديد حقل رقم تعريف المكان فقط: getPlaceDetails(fields: place_id).
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

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

يحصّل رمز التخزين التعريفي هذا رسومًا مقابل طلبات البحث عن مكان تُعرِض حقولًا أكثر من معرّف المكان فقط.

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب
  عوامل التفعيل تُحصّل قيمة رمز التخزين التعريفي هذه رسومًا مقابل الطلبات التي يتم إجراؤها بالطرق التالية:
  • العثور على المكان الحالي

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

  أمثلة

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

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

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

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

  Category (الفئة) Essentials
  الحدث القابل للفوترة الطلب
  عوامل التفعيل إذا أرسلت طلبًا للعثور على مكان بدون تحديد أي حقول، أو إذا حدّدت حقل place_id فقط: FindPlace(fields: place_id)
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

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

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

  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تنشيط رمز التخزين التعريفي هذا عند تقديم طلب بحث عن المنتجات بالقرب منك باستخدام إحدى واجهات برمجة التطبيقات التالية:

لا يتيح هذا الطلب تحديد الحقول التي سيتم عرضها. يعرض الردّ قائمة بالمواقع الجغرافية ومجموعة فرعية من حقول البيانات المتوافقة.

يؤدي رمز التخزين التعريفي هذا أيضًا إلى تحصيل رسوم رموز التخزين التعريفية للبيانات: في حال تضمين حقول بيانات في طلبك، يمكن أن يؤدي ذلك إلى تحصيل رسوم إضافية مقابل رموز التخزين التعريفية للبيانات: Basic وContact و Atmosphere. حدِّد حقول البيانات التي تريدها فقط لتجنُّب التكاليف غير الضرورية. يتم تحصيل رسوم منك مقابل رمز التخزين التعريفي هذا بالإضافة إلى البيانات التي تطلبها.

  أمثلة

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

  • مكان
  • البيانات الأساسية
  • بيانات الاتصال
  • بيانات الغلاف الجوي
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

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

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

  Category (الفئة) Pro
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تفعيل الفوترة للطلبات المقدَّمة إلى الخدمات التالية:

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

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

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

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

  • مكان - البحث باستخدام نص
  • البيانات الأساسية
  • بيانات الاتصال
  • بيانات الغلاف الجوي
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

رمز التخزين التعريفي: صور تفاصيل الأماكن في Places API

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

  Category (الفئة) Enterprise
  الحدث القابل للفوترة الطلب
  عوامل التفعيل يتم تفعيل الفوترة لما يلي:
  التسعير جدول الأسعار الرئيسي
جدول الأسعار في الهند

أسعار خدمات JavaScript

يتم تحديد أسعار خدمات JavaScript بشكل منفصل. يُرجى الاطّلاع على صفحة استخدام الخدمة والفوترة لمزيد من المعلومات:

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

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

  • ‫30,000 طلب في الدقيقة
  • ‫300 طلب في الدقيقة لكل عنوان IP في وحدة تحكّم Google Cloud، يُشار إلى هذه الحصة باسم عمليات تحميل الخرائط في الدقيقة لكل مستخدم.

حدود استخدام الخرائط الثلاثية الأبعاد بالصور الواقعية في JavaScript في "خرائط Google"

تم وضع حدود الاستخدام التالية للخرائط الثلاثية الأبعاد ذات المظهر الواقعي في JavaScript في "خرائط Google".

  • ‫100 طلب في الدقيقة
  • 10 طلبات في الدقيقة لكل عنوان IP

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

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