يسرد هذا القسم رموز التخزين التعريفية المحددة لمنتجات "منصة خرائط Google" الأساسية على "خرائط Google" و"المسارات" و"الأماكن". يتم تحصيل الرسوم مقابل المنتجات الأساسية، ولن تدفع إلا مقابل رموز التخزين التعريفية التي تستخدمها.
لكل رمز تخزين تعريفي مدرَج، سترى:
- اسم رمز التخزين التعريفي كما يظهر في تقرير الفوترة.
- تفاصيل توضّح نوع الاستخدام الذي يؤدي إلى تشغيل رمز التخزين التعريفي
- تمثّل هذه السمة السعر لكلّ استخدام للفئات الثلاث المستندة إلى العدد.
- أي ملاحظات أسعار إضافية خاصة برمز التخزين التعريفي
ابحث عن رموز التخزين التعريفي للمنتجات الفردية هنا، أو استخدِم الآلة الحاسبة للأسعار والاستخدام لتقييم استخدامك مقارنةً بالتكلفة الإجمالية لواجهة برمجة التطبيقات.
جدول رمز المنتج / رمز التخزين التعريفي في "منصة Google للتسويق"
رموز التخزين التعريفية لمنتجات "خرائط Google"
تتضمّن واجهات برمجة التطبيقات في "خرائط Google" ما يلي: حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS وMaps JavaScript API وMaps Static API وStreet Static API و واجهة برمجة التطبيقات لتضمين الخرائط.
رمز التخزين التعريفي: الخرائط الثابتة الأصلية للأجهزة الجوّالة
تتضمن عنصر "خرائط Google" في الوضع البسيط، بدون تحميل باستخدام رقم تعريف خريطة، في تطبيق SDK للخرائط على أجهزة Android.
نطاق الحجم الشهري (السعر لكلّ دالة للخريطة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
يتم تحميل تحميل خريطة واحد لكل مثيل من عنصر خريطة Google في الوضع البسيط،
في حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لتطبيق Android المتوافق مع الأجهزة الجوّالة. يتم إنشاء الخرائط باستخدام مثيلات
MapFragment
أو
SupportMapFragment
أو MapView
. يتم احتساب تحميل الخريطة في كل مرة يتم فيها استدعاء طريقة onCreate()
ذات الصلة.
رمز التخزين التعريفي: الخرائط الديناميكية المدمجة مع المحتوى للأجهزة الجوّالة
عنصر خريطة من Google، لم يتم تحميله مع رقم تعريف خريطة، في تطبيق خرائط Google لنظام التشغيل Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS
نطاق الحجم الشهري (السعر لكلّ قرض محدّد من الخريطة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
يتم تحميل تحميل خريطة واحد لكل مثيل من عنصر خريطة Google في تطبيق خرائط Google لنظام التشغيل Android أو تطبيق "خرائط Google" المتوافق مع الأجهزة الجوّالة لنظام التشغيل iOS:
- أحد صفوف
MapFragment
أوSupportMapFragment
أوMapView
على Android. يتم احتساب تحميل الخريطة في كل مرة يتم فيها استدعاء طريقةonCreate()
ذات الصلة. - عنصر
GMSMapView
على نظام التشغيل iOS.
لا تؤدي تفاعلات المستخدم مع الخريطة، مثل التحريك أو التصغير أو التكبير/التصغير أو تبديل طبقات الخريطة، إلى تحميل أحمال إضافية على الخريطة. من خلال نموذج تسعير "الدفع حسب الاستخدام"، لم يعد يتم إنشاء إنشاء بانوراما في "التجوّل الافتراضي" كتحميل للخريطة الأصلية على الأجهزة الجوّالة. ويتم تحصيل رسومها على أنها التجوّل الافتراضي الديناميكي.
رمز التخزين التعريفي: تضمين ورمز تخزين تعريفي: تضمين متقدّم
تتوفّر جميع طلبات البيانات من واجهة برمجة التطبيقات لتضمين "خرائط Google" مجانًا مع استخدام غير محدود.
رمز التخزين التعريفي: "خرائط Google" الثابتة
طلب واجهة برمجة تطبيقات الخرائط الثابتة.
نطاق الحجم الشهري (السعر لكلّ قرض محدّد للخريطة) |
||
---|---|---|
0.002 دولار أمريكي لكل (2.00 دولار أمريكي لكل 1000) |
0.0016 دولار أمريكي لكل (1.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الخرائط الديناميكية
تطبيق يعرض إما خريطة تم تحميلها باستخدام رقم تعريف الخريطة أو بدونه باستخدام واجهة برمجة تطبيقات JavaScript للخرائط، أو خريطة تم تحميلها باستخدام رقم تعريف خريطة وتستخدم إما حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لأجهزة iOS.
نطاق الحجم الشهري (السعر لكلّ قرض محدّد للخريطة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
لا تؤدي تفاعلات المستخدمين مع الخريطة، مثل التحريك أو تكبير/تصغير أو تبديل طبقات الخريطة، إلى إنشاء أحمال إضافية على الخريطة.
رمز التخزين التعريفي: ميزة "التجوّل الافتراضي" الثابتة
يتم الآن تحصيل رسوم صور البورتريه وتحميلات الخريطة بشكل منفصل. يتم فرض رسوم بانورامية على التجوّل الافتراضي لكل طلب على واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" لتضمين بانوراما ثابتة (غير تفاعلية) في ميزة "التجوّل الافتراضي". ولا يتم تحصيل رسوم استخدام نقطة نهاية البيانات الوصفية لصور "التجوّل الافتراضي".
نطاق الحجم الشهري (السعر لكلٍّ من PANORAMA) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: التجوّل الافتراضي الديناميكي
يتم الآن تحصيل رسوم صور البورتريه وتحميلات الخريطة بشكل منفصل. يتم تحصيل رسوم عرض بانورامي ديناميكي لميزة "التجوّل الافتراضي" لكل مثيل من عنصر بانوراما في واجهة برمجة تطبيقات JavaScript للخرائط، وحزمة تطوير برامج "خرائط Google" لأجهزة Android، وتطبيق "خرائط Google" لحزمة تطوير البرامج (SDK) لنظام التشغيل iOS.
نطاق الحجم الشهري (السعر لكلٍّ من PANORAMA) |
||
---|---|---|
0.014 دولار أمريكي لكل (14.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0112 دولار أمريكي لكل (11.20 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم إنشاء مثيل لكائن بانورامي:
- في JavaScript، باستخدام فئة
google.maps.StreetViewPanorama()
أو طريقةMap.getStreetView()
لا يتم تحصيل رسوم من تجربة "التجوّل الافتراضي" المضمّنة استنادًا إلى تحكّم الدليل في "التجوّل الافتراضي" أو استخدام فئةStreetViewService()
. - على جهاز Android، مع أحد صفوف
StreetViewPanoramaFragment
أوSupportStreetViewPanoramaFragment
أوStreetViewPanoramaView
يتم احتساب صورة بانورامية كل مرة يتم فيها طلب طريقةonCreate()
ذات الصلة. - على نظام التشغيل iOS، مع العنصر
GMSPanoramaView
.
رمز التخزين التعريفي: عرض جوي
وأثناء المعاينة، لن يتم تحصيل أي رسوم مقابل استخدام واجهة برمجة التطبيقات Airer View API.
طلب إلى Aerial View API يعرض عنوان URL جوّيًا للفيديو.
نطاق الحجم الشهري (السعر لكل عنوان URL معروض) |
||
---|---|---|
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1000) |
0.0128 دولار أمريكي لكل (12.80 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
ويتم فقط إرسال فواتير إلى المكالمات الواردة إلى
getVideo
التي تعرض عناوين URL المعروضة. وقد تعرض استجابة getVideo
ناجحة واحدة عناوين URL متعددة، لكل منها درجة دقة
أو اتجاه مختلف، ولكنها تشكّل حدثًا واحدًا قابلاً للفوترة. تجدر الإشارة إلى أن الأسعار لا تعتمد على
المشاهدات الفعلية لعناوين URL هذه من المستخدمين النهائيين.
إخلاء المسؤولية القانونية: تخضع الأسعار للتغيير، ما لم تقرّر Google خلاف ذلك.
يوجِّه رموز التخزين التعريفية للمنتجات.
تتضمن واجهات برمجة التطبيقات في "المسارات": Directions API و Speed Matrix API وRoads API.
رمز التخزين التعريفي: الاتجاهات
طلب إلى خدمة الاتجاهات المستندة إلى JavaScript في "خرائط Google" (باستثناء الطلبات التي تؤدي إلى تشغيل رمز التخزين التعريفي للفوترة الخاص بـ الاتجاهات المتقدّمة) أو واجهة برمجة التطبيقات الاتجاهات
نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: اتجاهات متقدمة
طلب إلى خدمة الاتجاهات في واجهة برمجة تطبيقات JavaScript أو واجهة برمجة تطبيقات الاتجاهات التي تستخدم معلومات عن حركة المرور و/أو أكثر من 10 نقاط في المسار و/أو تحسين نقاط الطريق و/أو معدِّلات المواقع الجغرافية
نطاق الحجم الشهري (السعر حسب طلب البحث) |
||
---|---|---|
0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم تحصيل رسوم رمز التخزين التعريفي لميزة "الاتجاهات" مقابل خدمة اتجاهات واجهة برمجة تطبيقات JavaScript في "خرائط Google" أو طلب توجيهات واجهة برمجة التطبيقات الذي يستخدم واحدًا أو أكثر من ما يلي:
- معلومات عن كثافة حركة المرور: تُستخدم معلومات حركة المرور عند تطبيق جميع ما يلي
(هذه الشروط مطلوبة لتلقّي الحقل
duration_in_traffic
في استجابة الاتجاهات):- مَعلمة
السفر
mode
هيdriving
، أو لم يتم تحديدها (driving
هي وضع السفر التلقائي). - يتضمّن الطلب معلَمة
departure_time
صالحة. يمكن ضبط السمةdeparture_time
على الوقت الحالي أو على وقت لاحق. لا يمكن أن يقع في الماضي. - ولا يتضمّن الطلب
نقاط توقف. إذا كان الطلب
يتضمّن نقاط طريق، أضِف
via:
إلى كل نقطة بداية للتأثير في المسار ولكن تجنَّب محطات التوقف. مثلاً،&waypoints=via:San Francisco|via:Mountain View|...
- مَعلمة
السفر
- أكثر من 10 نقاط للطرق (بين 11 و25).
- تحسين نقاط الطريق: تم ضبط
المعلَمة
optimize
علىtrue
لنقاط الطريق. مثلاً،&waypoints=optimize:true|San Francisco|Mountain View|...
- أدوات تعديل الموقع الجغرافي: عند استخدام أدوات تعديل
الموقع الجغرافي التالية للإشارة إلى كيفية تعامل السائقين مع موقع جغرافي معيّن:
side_of_road
heading
رمز التخزين التعريفي: مصفوفة المسافة
طلب إلى Sitemap Matrix API أو خدمة مصفوفة المسافة في JavaScript API في "خرائط Google" (باستثناء الطلبات التي تؤدي إلى رمز تخزين تعريفي للفوترة الخاص بـ مصفوفة المصفوفة المتقدّمة)
نطاق الحجم الشهري (السعر حسب كل عنصر) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
ينشئ كل طلب بحث يتم إرساله إلى واجهة برمجة تطبيقات شبكة Matrix عناصر، حيث يكون عدد
origins
مضروبًا في عدد destinations
تساوي عدد العناصر.
رمز التخزين التعريفي: مصفوفة المسافة المتقدمة
طلب إلى Speed Matrix API أو Maps JavaScript API DISTANCE Matrix Service يستخدم معلومات عن حركة المرور و/أو معدِّلات المواقع الجغرافية
نطاق الحجم الشهري (السعر حسب كل عنصر) |
||
---|---|---|
0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يؤدي كل طلب بحث يتم إرساله إلى واجهة برمجة تطبيقات مسافة المصفوفة إلى إنشاء عناصر، حيث يكون عدد origins
مضروبًا في عدد destinations
يساوي عدد العناصر.
يتم تحصيل رسوم رمز التخزين التعريفي المتقدم لمصفوفة المسافة لواجهة برمجة تطبيقات المسافة المقطوعة أو <br class API Maps Matrix Service التي تستخدم واحدًا أو أكثر من الخدمات التالية:
- معلومات عن كثافة حركة المرور: تُستخدم معلومات حركة المرور عندما تنطبق جميع ما يلي (هذه الشروط مطلوبة لتلقّي الحقل
duration_in_traffic
في استجابة مصفوفة المسافة):- مَعلمة
السفر
mode
هيdriving
، أو لم يتم تحديدها (driving
هي وضع السفر التلقائي). - يتضمّن الطلب معلَمة
departure_time
صالحة. يمكن ضبط السمةdeparture_time
على الوقت الحالي أو على وقت لاحق. لا يمكن أن يقع في الماضي.
- مَعلمة
السفر
- أدوات تعديل الموقع الجغرافي: عند استخدام أدوات تعديل
الموقع الجغرافي التالية للإشارة إلى كيفية تعامل السائقين مع موقع جغرافي معيّن:
side_of_road
heading
رمز التخزين التعريفي: الطرق – الطريق التي تم قطعها
طلب إلى خدمة Snap to Roads الخاصة بـ Roads API.
نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
---|---|---|
0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الطرق – أقرب طريق
طلب إلى خدمة Nisest Roads في واجهة برمجة التطبيقات للطرق
نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
---|---|---|
0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الطرق، حدود السرعة
طلب إلى خدمة الحد الأقصى للسرعة في Roads API.نطاق الحجم الشهري (السعر لكل عنصر) |
||
---|---|---|
0.02 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1000) |
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم إرسال فواتير طلبات الحد الأقصى للسرعة لكل عنصر الحد الأقصى للسرعة المعروض في استجابة واجهة برمجة التطبيقات. وسيكون هذا المبلغ مساويًا دائمًا أو أقل من عدد النقاط التي يتم تمريرها في الطلب الأصلي.
رمز التخزين التعريفي: المسارات: مسارات الحوسبة - أساسية
طلب احتساب المسارات
نطاق الحجم الشهري السعر لكل طلب بحث |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: المسارات: مسارات الحوسبة - الإعدادات المتقدمة
طلب حوسبة المسارات الذي يستخدم ميزات متقدمة
نطاق الحجم الشهري السعر لكل طلب بحث |
||
---|---|---|
0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم مقابل طلب مسارات الحوسبة الذي يستخدم ميزة واحدة أو أكثر من الميزات التالية:
- بين 11 و25 نقطة متوسطة
- التوجيه الأمثل لحركة البيانات أو حركة المرور حسب حركة المرور. تتطابق خيارات التوجيه هذه مع ضبط السمة
routingPreference
في الطلب علىTRAFFIC_AWARE
أوTRAFFIC_AWARE_OPTIMAL
. - أدوات تعديل الموقع الجغرافي: عند استخدام الخيارات التالية للإشارة إلى كيفية تعامل السائقين مع موقع جغرافي معيّن:
رمز التخزين التعريفي: المسارات: مسارات الحوسبة - المفضّلة
طلب احتساب المسارات الذي يستخدم الميزات المفضّلة
نطاق الحجم الشهري السعر لكل طلب بحث |
||
---|---|---|
0.015 دولار أمريكي لكل (15,00 دولار أمريكي لكل 1,000) |
0.012 دولار أمريكي لكل (12.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم تحصيل رسوم رمز التخزين التعريفي المفضّل مقابل طلب مسارات الحوسبة الذي يستخدم ميزة واحدة أو أكثر من الميزات التالية:
رمز التخزين التعريفي: المسارات: مصفوفة طريق الحوسبة - أساسية
نطاق الحجم الشهري السعر لكل عنصر |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: المسارات: مصفوفة مسار الحوسبة - الإعدادات المتقدمة
طلب احتساب مصفوفة المسار التي تستخدم ميزات متقدّمة
نطاق الحجم الشهري السعر لكل عنصر |
||
---|---|---|
0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم مقابل طلب مصفوفة الحوسبة الذي يستخدم ميزة واحدة أو أكثر من الميزات التالية:
- التوجيه الأمثل لحركة البيانات أو حركة المرور حسب حركة المرور. تتطابق خيارات التوجيه هذه مع ضبط السمة
routingPreference
في الطلب علىTRAFFIC_AWARE
أوTRAFFIC_AWARE_OPTIMAL
. - أدوات تعديل الموقع الجغرافي: عند استخدام الخيارات التالية للإشارة إلى كيفية تعامل السائقين مع موقع جغرافي معيّن:
رمز التخزين التعريفي: المسارات: مصفوفة مسار الحوسبة - الخيار المفضّل
طلب احتساب مصفوفة المسار التي تستخدم الميزات المفضّلة
نطاق الحجم الشهري السعر لكل عنصر |
||
---|---|---|
0.015 دولار أمريكي لكل (15,00 دولار أمريكي لكل 1,000) |
0.012 دولار أمريكي لكل (12.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم تحصيل رسوم رمز التخزين التعريفي المفضّل مقابل طلب مصفوفة الحوسبة الذي يستخدم ميزة واحدة أو أكثر من الميزات التالية:
رموز التخزين التعريفية للمنتجات
تشمل واجهات برمجة التطبيقات في الأماكن واجهة برمجة تطبيقات الأماكن وحزمة تطوير البرامج (SDK) للأماكن المخصّصة لنظام التشغيل Android وواجهة برمجة تطبيقات الأماكن في iOS لنظام التشغيل iOS وواجهة برمجة تطبيقات الأماكن في "خرائط Google" وواجهة برمجة تطبيقات ترميز المواقع الجغرافية وواجهة برمجة التطبيقات للمواقع الجغرافية وواجهة برمجة التطبيقات للمنطقة الزمنية وواجهة برمجة التطبيقات Elevation API.
لمحة عن جلسات الإكمال التلقائي
تتضمن جلسة الإكمال التلقائي بعض طلبات الإكمال التلقائي (لاسترداد الاقتراحات حول مكان معيّن كنوع مستخدمين)، وطلب واحد على الأكثر من تفاصيل المكان (لاسترداد تفاصيل حول المكان الذي اختاره المستخدم). يتم تمرير الرمز المميز للجلسة نفسه إلى الإكمال التلقائي وطلب تفاصيل المكان التالية. تبدأ الجلسة بطلب أول الإكمال التلقائي (الذي يحدث عادةً عندما يبدأ المستخدم الكتابة). يتم إجراء طلب تفاصيل الأماكن عندما يختار المستخدم أحد اقتراحات الإكمال التلقائي. وإذا لم يختار المستخدم اقتراحًا، لا يتم إجراء استدعاء لتفاصيل الأماكن.
بعد أن يختار المستخدم مكانًا (أي إجراء مكالمة بشأن تفاصيل الأماكن)، يجب بدء جلسة جديدة باستخدام رمز مميّز جديد للجلسة.
يمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:
- خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات الأماكن أو خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript عليك تصميم تطبيقك لتوفير رموز مميّزة للجلسة (قد تحتاج إلى تغيير الرمز الحالي).
- أداة الإكمال التلقائي من Maps JavaScript: ويتم تفعيل الفوترة المستندة إلى الجلسة تلقائيًا على هذه الأدوات، بدون الحاجة إلى تغيير أي رمز.
يُعد الرمز المميز للجلسة جيدًا لجلسة مستخدم واحدة ويجب عدم استخدامه لأكثر من جلسة مستخدم واحدة. إذا أعدت استخدام رمز مميّز للجلسة، تُعتبَر الجلسة غير صالحة ويتم تحصيل الرسوم من الطلبات كما لو أنّه لم يتم تقديم أي رمز مميّز للجلسة.
تتم فوترة طلبات الإكمال التلقائي وطلبات تفاصيل الأماكن باستخدام الجلسات في رموز تخزين تعريفية مختلفة.
لمحة عن رموز التخزين التعريفي لبيانات الأماكن
رموز التخزين التعريفية لبيانات الأماكن الثلاثة هي: البيانات الأساسية، وبيانات الاتصال، وبيانات الغلاف الجوي.يتم تشغيل رمز تخزين تعريفي واحد أو أكثر لـ:
- Android: كل طلب إلى
fetchPlace()
أوfindCurrentPlace()
- iOS: كل مكالمة إلى
fetchPlaceFromPlaceID:
أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
- خدمة الويب: كل طلب في "الأماكن" استنادًا إلى الحقول المحدّدة في الطلب
يتم تحصيل رسوم رموز التخزين التعريفية للبيانات دائمًا بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي يشغّلها. على سبيل المثال، سيتم تحصيل رسوم من طلب تفاصيل المكان الذي يتضمّن حقول البيانات الأساسية ضمن رمز التخزين التعريفي للبيانات الأساسية ورمز التخزين التعريفي لتفاصيل المكان.
بالنسبة إلى خدمة الويب، تطلب واجهات برمجة تطبيقات الأماكن هذه دعم تحديد حقول البيانات التي يتم عرضها:
بالنسبة إلى خدمة الويب، تطلب واجهات برمجة تطبيقات الأماكن هذه عدم تحديد الحقول المعروضة. تعرض هذه المكالمات دائمًا جميع بيانات الأماكن، وتحصّل رموز التخزين التعريفي الثلاثة لبيانات الأماكن، بالإضافة إلى رسوم كل طلب بيانات من واجهة برمجة التطبيقات:
رمز التخزين التعريفي: البيانات الأساسية
باستخدام معلَمة الحقول في تفاصيل المكان أو طلب "البحث عن مكان"، يمكنك قصر الاستجابة على هذه الحقول المحدّدة فقط. يتم تضمين الحقول من فئة أساسية في التكلفة الأساسية لطلب الأماكن ولا تؤدي إلى أي رسوم إضافية. يتم تفعيل رمز التخزين التعريفي للبيانات الأساسية عند طلب أي من الحقول التالية:
-
Android:
Place.Field.ADDRESS
أوPlace.Field.ADDRESS_COMPONENTS
أوPlace.Field.BUSINESS_STATUS
أوPlace.Field.ICON_BACKGROUND_COLOR
أوPlace.Field.ICON_URL
أوPlace.Field.ID
أوPlace.Field.LAT_LNG
أوPlace.Field.NAME
أوPlace.Field.PHOTO_METADATAS
أوPlace.Field.PLUS_CODE
أوPlace.Field.TYPES
أوPlace.Field.VIEWPORT
أوPlace.Field.UTC_OFFSET
أوPlace.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
iOS:
GMSPlaceFieldFormattedAddress
أو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.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.003 دولار أمريكي لكل مبلغ (+ 3.00 دولار أمريكي لكل 1,000) |
تكلفة طلب الأماكن + 0.0024 دولار أمريكي لكل مبلغ (+ 2.40 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: بيانات الغلاف الجوي
باستخدام معلّمة الحقول في تفاصيل المكان أو طلب البحث عن مكان، يمكنك حصر الاستجابة على هذه الحقول المحدّدة فقط. تؤدي الحقول في فئة الأجواء إلى تحصيل رسوم إضافية. يتم تشغيل رمز التخزين التعريفي لبيانات الغلاف الجوي عند طلب أي من الحقول التالية:
- 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
. - 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.005 دولار أمريكي لكل عنصر (+ 5.00 دولار أمريكي لكل 1,000) |
تكلفة طلب الأماكن + 0.004 دولار أمريكي لكل مبلغ (+ 4.00 دولار أمريكي لكل 1,000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الإكمال التلقائي – لكل طلب
يتم تحصيل رسوم رمز التخزين التعريفي للإكمال التلقائي لكل طلب مقابل أي من هذه المكالمات أو الطلبات التي لا تتضمّن رمزًا مميَّزًا للجلسة:
- نظام التشغيل Android:
findAutocompletePredictions()
- iOS:
findAutocompletePredictionsFromQuery:
- JavaScript: خدمة الإكمال التلقائي للأماكن في JavaScript من Maps
- خدمة الويب: خدمة الإكمال التلقائي للأماكن في واجهة برمجة التطبيقات للأماكن
يتم أيضًا تحصيل الرسوم من المكالمات التي يتم إجراؤها من جلسة غير مكتملة ضمن ميزة "الإكمال التلقائي" (على سبيل المثال، جلسة تعيد استخدام الرمز المميّز للجلسة)
قد يتم تحصيل رسوم طلبات الإكمال التلقائي من أداة الإكمال التلقائي للأماكن في "واجهة برمجة تطبيقات JavaScript" في "خرائط Google" باستخدام ميزة "الإكمال التلقائي" لكل طلب في حال توفّر طلبات من جلسة إكمال تلقائي غير صالحة. قد يحدث ذلك عندما يكتب المستخدم عدة عناوين مختلفة أو ينسخ/لصق العناوين المختلفة في الأداة ولا يختار دائمًا عبارة بحث مقترحة.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000 دولار أمريكي) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي لميزة الإكمال التلقائي بدون تفاصيل المكان – لكل جلسة مقابل جلسة الإكمال التلقائي التي لا تتضمّن طلب تفاصيل المكان (خلال بضع دقائق من بداية الجلسة).
نطاق الحجم الشهري (السعر لكل جلسة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
مثال
إذا أصدر تطبيقك هاتين المكالمتين في جلسة واحدة:
Android
- findAutocompletePrediction() (.setQuery(”par), .setSessionToken(XYZ))
- findAutocompletePrediction() (.setQuery(”paris), .setSessionToken(XYZ))
iOS
- PLACESClient??findAutocompletePrediction(fromQuery: "par" ...)
- PLACESClient??findإجمالي التوقعات(fromQuery: "paris" ...
خدمة الويب
- تقديم طلب الإكمال التلقائي (input=”par”, session_token: XYZ)
- تقديم طلب الإكمال التلقائي (input=”paris”, session_token: XYZ)
في فاتورتك، سيظهر رمز التخزين التعريفي هذا (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- الإكمال التلقائي بدون تفاصيل عن المكان - لكل جلسة (السعر يبدأ من 0.017 دولار أمريكي لكل جلسة)
رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) – لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي للإكمال التلقائي (مُضمَّن مع تفاصيل المكان) – لكل جلسة لجلسة الإكمال التلقائي التي تشمل أيًا مما يلي:
- Android: مكالمة مع
fetchPlace()
- iOS: مكالمة مع
fetchPlaceFromPlaceID:
- خدمة الويب: طلب تفاصيل المكان
يتوفّر طلب الإكمال التلقائي بدون أي رسوم، ويتم تحصيل رسوم المكالمة اللاحقة للحصول على تفاصيل المكان استنادًا إلى أسعار تفاصيل المكان العادية.
ينشئ طلب تفاصيل المكان رموز التخزين التعريفية (الأساسية و/أو جهة الاتصال و/أو الأجواء)، بناءً على الحقول المحددة في الطلب.
إذا لم تحدِّد حقولاً في طلب تفاصيل المكان، سيتم تشغيل كل رموز التخزين التعريفية للبيانات (الأساسية، وجهة الاتصال، والأجواء).
طلبات إعادة تحميل معرّف تفاصيل المكان (الطلبات التي تحدد الحقل place_id
فقط)
أثناء جلسة الإكمال التلقائي يتم إصدار فواتيرها باسم رمز التخزين التعريفي: الإكمال التلقائي
بدون تفاصيل المكان – لكل جلسة.
نطاق الحجم الشهري (السعر لكل جلسة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
مثال
إذا أصدر تطبيقك المكالمات الثلاث التالية في جلسة واحدة:
Android
- findAutocompletePrediction() (.setQuery(”par), .setSessionToken(XYZ))
- findAutocompletePrediction() (.setQuery(”paris), .setSessionToken(XYZ))
- FetchPlace() (باستخدام
FetchPlaceRequest
بما في ذلك رقم تعريف المكان وحقل ADDRESS)
iOS
- PLACESClient??findAutocompletePrediction(fromQuery: "par" ...)
- PLACESClient??findإجمالي التوقعات(fromQuery: "paris" ...
- FetchPlaceFromPlaceID:
(بما في ذلك معرّف المكان والحقل
GMSPlaceFieldFormattedAddress
)
خدمة الويب
- طلب الإكمال التلقائي للأماكن (input=”par”, session_token: XYZ)
- طلب الإكمال التلقائي للأماكن (input=”paris”, session_token: XYZ)
- تفاصيل الأماكن (place_id، session_token: XYZ، الحقول:format_address)
في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- الإكمال التلقائي (مضمّن في تفاصيل المكان) لكل جلسة (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- تفاصيل المكان (بدءًا من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
رمز التخزين التعريفي: الإكمال التلقائي لطلب البحث – لكل طلب
يتم تحصيل رسوم رمز التخزين التعريفي لإكمال طلب البحث – لكل طلب مقابل كل طلب إلى:
- JavaScript:
خدمة الإكمال التلقائي للأماكن في واجهة برمجة تطبيقات JavaScript (
getQueryPredictions()
) واستخدام أداة Search Console المصغّرة في Maps API (يتم إنشاء طلبات الإكمال التلقائي لطلبات البحث كأنواع مستخدمين). - خدمة الويب: خدمة الإكمال التلقائي لطلب البحث في واجهة برمجة التطبيقات للأماكن
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1000 دولار أمريكي) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
التسعير حسب جلسة الإكمال التلقائي غير متاح باستخدام الإكمال التلقائي لطلبات البحث. يتم تحصيل رسوم من "تفاصيل الأماكن" اللاحقة استنادًا إلى الأسعار الخاصة بتفاصيل الأماكن العادية.
رمز التخزين التعريفي: تفاصيل المكان
يتم تحصيل رسوم مكالمات تفاصيل المكان على النحو التالي:
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
يتم إنشاء رمز التخزين التعريفي لـ تفاصيل المكان من واجهات برمجة التطبيقات التالية:
- نظام التشغيل Android: إضافة حزمة تطوير البرامج (SDK) للتطبيقات المتوافقة مع Android
(
fetchPlace()
) - iOS: وضع حزمة تطوير برامج (SDK) لنظام التشغيل iOS
(
fetchPlaceFromPlaceID:
) - JavaScript:
خدمة تفاصيل المكان في واجهة برمجة تطبيقات JavaScript (
getDetails
) - JavaScript:
أداة "الإكمال التلقائي" الخاصة بواجهة برمجة تطبيقات JavaScript في "خرائط Google" (
getPlace
) - JavaScript:
تطبيق Search Console المصغّر في واجهة برمجة تطبيقات JavaScript:
getPlaces()
بعد أن يختار المستخدم نتيجة المكان (الرمز: تثبيت)، *وليس* طلب بحث (الرمز: مكبّر)، كما هو موضّح هنا:في نتائج تطبيق البحث المصغّر، بعد كتابة "بيتزا" في مربّع البحث، يُرجى ملاحظة أن البيتزا الآلية تحتوي على رمز يعني أنّ رمز{/1 نتيجة يشير إليه يشير إلى أنّ نص الرمز يشير إلى ذلك. - خدمة الويب: خدمة تفاصيل واجهة برمجة تطبيقات الأماكن
عند استخدام واجهة برمجة تطبيقات الويب والخدمات، يتم تحصيل رمز التخزين التعريفي لتفاصيل المكان سواء تم تقديم رمز مميّز للجلسة أم لا.
تؤدي أيضًا استدعاء أو طلب تفاصيل المكان إلى رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو أجواء)، وفقًا للحقول المحدّدة في المكالمة أو الطلب. في حال تحديد حقول لا في طلب أو طلب تفاصيل المكان، يتم تشغيل جميع رموز التخزين التعريفية للبيانات، ويتم تحصيل رسوم منك مقابل مكالمة أو طلب تفاصيل الأماكن، بالإضافة إلى تكلفة جميع البيانات.
أمثلة
- نفِّذ إحدى المكالمات أو الطلبات التالية:
- الأجهزة الجوّالة: يمكنك الاتصال بالرقم
fetchPlace()
على جهاز Android أوfetchPlaceFromPlaceID:
على جهاز iOS، وتحديد الحقلADDRESS
فقط. - واجهة برمجة تطبيقات الويب أو الخدمة: يمكنك تقديم طلب بشأن تفاصيل المكان وتحديد حقل العنوان فقط:
getPlaceDetails(fields: formatted_address)
- تفاصيل المكان (بدءًا من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- الأجهزة الجوّالة: يمكنك الاتصال بالرقم
- نفِّذ إحدى المكالمات أو الطلبات التالية:
- الأجهزة الجوّالة: يمكنك الاتصال بالرقم
fetchPlace()
على جهاز Android أوfetchPlaceFromPlaceID:
على جهاز iOS، وتحديد الحقلPHONE_NUMBER
فقط. - خدمة الويب أو الخدمة على الويب: يمكنك تقديم طلب بشأن تفاصيل المكان وتحديد حقل رقم الهاتف:
getPlaceDetails(fields: formatted_phone_number)
- تفاصيل المكان (بدءًا من 0.017 دولار أمريكي لكل جلسة)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- الأجهزة الجوّالة: يمكنك الاتصال بالرقم
- نفِّذ إحدى المكالمات أو الطلبات التالية:
- الأجهزة الجوّالة: يمكنك الاتصال بالرقم
fetchPlace()
على جهاز Android أوfetchPlaceFromPlaceID:
على جهاز iOS، وتحديد كل الحقول. - واجهة برمجة تطبيقات أو خدمة الويب: يمكنك تقديم طلب بشأن تفاصيل المكان وتحديد جميع الحقول (هذا النوع من الطلبات هو الإعداد التلقائي في حال عدم تحديد أي حقول):
getPlaceDetails()
.
- تفاصيل المكان (بدءًا من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (بدءًا من 0.005 دولار أمريكي لكل طلب)
- الأجهزة الجوّالة: يمكنك الاتصال بالرقم
رمز التخزين التعريفي: تفاصيل المكان – إعادة تحميل رقم التعريف
استخدِم طلب تفاصيل المكان من أجل إعادة تحميل أرقام تعريف الأماكن القديمة. وتتوفّر هذه الأنواع من الطلبات بدون أي رسوم.
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
مثال
يمكنك تقديم طلب عن تفاصيل المكان مع تحديد حقل معرّف المكان فقط:
getPlaceDetails(fields: place_id)
.
في فاتورتك، سيظهر رمز التخزين التعريفي هذا (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- تفاصيل المكان – إعادة تحميل المعرّف (يتم تحصيل الرسوم في 0.00 دولار أمريكي)
رمز التخزين التعريفي: البحث عن مكان
يتم تحصيل رسوم من خدمة البحث عن المكان مقابل طلب "العثور على المكان".
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
تؤدي أيضًا طلبات البحث عن الأماكن إلى إنشاء رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو الأجواء)، اعتمادًا على الحقول المحدّدة في الطلب. مثل طلبات تفاصيل المكان، يمكنك استخدام معلمة الحقول في طلب "العثور على المكان" لقصر الاستجابة على هذه الحقول المحددة فقط. يتم تحصيل رسوم منك مقابل طلب "العثور على المكان" بالإضافة إلى البيانات التي يتم طلبها. بشكل تلقائي، إذا تم طلب حقول لا، يتم عرض معرّف المكان فقط، لذلك لا يتم تحصيل أي رسوم إضافية مقابل البيانات.
أمثلة
- عليك تقديم طلب "البحث عن مكان" وتحديد حقل العنوان فقط:
FindPlace(fields: formatted_address)
. في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (السعر يبدأ من 0.017 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- إذا قدّمت طلبًا في "العثور على المكان" وحدّدت حقل رقم الهاتف:
FindPlace(fields: formatted_phone_number)
. ستظهر في فاتورتك رموز التخزين التعريفية التالية (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (السعر يبدأ من 0.017 دولار أمريكي لكل مكالمة)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- إذا أجريت طلبًا للعثور على مكان، حدِّد الحقول من جميع مجموعات البيانات الثلاثة في نوع البيانات:
FindPlace(fields: formatted_address, opening_hours, price_level)
. في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن مكان (السعر يبدأ من 0.017 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (بدءًا من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: البحث عن مكان – رقم التعريف فقط
يتم تحصيل رسوم من أجل العثور على المكان – رقم التعريف فقط مقابل طلبات البحث عن الأماكن التي تحدّد فقط رقم تعريف المكان الذي سيتم عرضه. بشكل تلقائي، إذا لم يتم تحديد أي حقول في طلب "العثور على المكان"، يتم عرض معرّف المكان فقط.
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.00 SAR | 0.00 SAR | 0.00 SAR |
مثال
عليك تقديم طلب "تحديد مكان" وتحديد الحقل place_id
فقط: FindPlace(fields: place_id)
.
في فاتورتك، سيظهر رمز التخزين التعريفي هذا (عند الاطّلاع على فاتورتك حسب رمز التخزين التعريفي):
- العثور على المكان – رقم التعريف فقط (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
رمز التخزين التعريفي: البحث عن المكان الحالي
يتم تحصيل رسوم من خدمة العثور على المكان الحالي مقابل المكالمات الواردة إلى
findCurrentPlace()
(Android)
أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS).
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.030 دولار أمريكي لكل (30.00 دولار أمريكي لكل 1000) |
0.024 دولار أمريكي لكل (24.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
تؤدي أيضًا المكالمات إلى findCurrentPlace()
(Android) أو
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)
إلى إنشاء رموز تخزين تعريفية للبيانات (أساسي و/أو جهة اتصال و/أو
الأجواء)، اعتمادًا على الحقول المحدّدة في المكالمة.
حدِّد حقول البيانات لقصر الاستجابة على هذه الحقول فقط. يتم تحصيل الرسوم منك مقابل مكالمة "العثور على المكان الحالي" بالإضافة إلى البيانات المطلوبة.
أمثلة
- عليك استدعاء
findCurrentPlace()
(Android) أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) وتحديد الحقلADDRESS
فقط. في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- عليك استدعاء
findCurrentPlace()
(Android) أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS) وتحديد الحقلPHONE_NUMBER
. في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- ويجب استدعاء السمة
findCurrentPlace()
(لنظام التشغيل Android) أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(لنظام التشغيل iOS) وتحديد الحقول من خلال مجموعات البيانات الثلاثة الخاصة بنوع البيانات. في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):- البحث عن المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (بدءًا من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: المكان – البحث عن الأجهزة المجاورة
تُحصّل رسوم المكان – البحث عن الأماكن المجاورة مقابل الطلبات إلى
خدمة البحث عن الأماكن المجاورة لواجهة برمجة التطبيقات JavaScript API في "خرائط Google"
(nearbySearch()
) أو إلى
خدمة البحث عن الأماكن المجاورة لواجهة برمجة التطبيقات الأماكن.
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0256 دولار أمريكي لكل (25.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
تعرض طلبات البحث عن الأجهزة المجاورة قائمة بالأماكن، ولكن لا تتيح إمكانية تحديد الحقول التي يتم عرضها. وتعرض طلبات البحث القريبة مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث القريب بدءًا من 0.032 دولارًا أمريكيًا لكل رمز، بالإضافة إلى جميع رموز التخزين التعريفي لنوع البيانات (البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي).
مثال
إذا أجريت طلب "بحث عن قرب"، مثل "NearbySearch (San Francisco, 100 meters)
".
في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- المكان - بحث قريب (سعر يبدأ من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (بدءًا من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: المكان - بحث نصي
يتم تحصيل رسوم Place – Text Search مقابل الطلبات المقدّمة إلى
خدمة "البحث عن نص" في واجهة برمجة تطبيقات JavaScript
(textSearch()
) أو إلى
خدمة "البحث في النص" باستخدام واجهة برمجة تطبيقات الأماكن.
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1000 دولار أمريكي) |
0.0256 دولار أمريكي لكل (25.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
تعرض طلبات البحث النصي قائمة بالأماكن، ولكن لا تتيح إمكانية تحديد الحقول التي يتم عرضها. تعرض طلبات البحث النصي مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث النصي بدءًا من 0.032 دولار أمريكي لكل رقم، بالإضافة إلى جميع رموز التخزين التعريفية من نوع البيانات (البيانات الأساسية وبيانات جهة الاتصال وبيانات الغلاف الجوي).
يتم أيضًا إنشاء رمز التخزين التعريفي للمكان - البحث في رمز التخزين التعريفي من خلال
أداة Search Console المصغّرة لواجهة برمجة التطبيقات JavaScript API: getPlaces()
بعد أن يختار المستخدم طلب البحث (الرمز: مكبّر)، وليس
نتيجة (رمز: تثبيت)، كما هو موضّح في ما يلي:

مثال
عند تقديم طلب بحث نصي، مثل TextSearch(123 Main Street)
. في فاتورتك، ستظهر رموز التخزين التعريفية هذه (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- المكان - بحث نصي (بدءًا من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل الرسوم بقيمة 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (بدءًا من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: صورة مكان
يتم تحصيل رسوم رمز التخزين التعريفي لصورة المكان مقابل:
- Android: مكالمات إلى
fetchPhoto()
- iOS: مكالمات صادرة إلى
loadPlacePhoto:
- JavaScript: للوصول إلى مكتبة الأماكن، والخدمة التي تقدّمها ميزة "الصور في المكان" من Maps API عند طلب البيانات من عناوين URL التي تعرضها
PlacePhoto.getUrl()
لتحميل بيانات بكسل الصورة - خدمة الويب: هي طلبات من أجل خدمة Place API للأماكن في "صور Google"
بالنسبة إلى خدمة JavaScript، لا يؤدي استدعاء الطريقة PlacePhoto.getUrl()
إلى
الفوترة إلى أن يتم استخدام عنوان URL للحصول على بيانات البكسل.
نطاق الحجم الشهري (سعر المكالمة) |
||
---|---|---|
0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: ترميز جغرافي
يتم تحصيل رسوم رمز التخزين التعريفي للترميز الجغرافي مقابل الطلبات إلى خدمة ترميز المواقع الجغرافية في JavaScript API في "خرائط Google" أو إلى واجهة برمجة التطبيقات للترميز الجغرافي.
في JavaScript، تبدأ الطريقة
Geocoder.geocode()
الطلب في خدمة ترميز المواقع الجغرافية.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: رصد الموقع الجغرافي
يتم تحصيل رسوم رمز التخزين التعريفي لخدمة locationlocation مقابل الطلبات إلى واجهة برمجة تطبيقات رصد الموقع الجغرافي.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: المنطقة الزمنية
يتم تحصيل رسوم رمز التخزين التعريفي للمنطقة الزمنية مقابل الطلبات إلى Time Zone API.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: الارتفاع
يتم تحصيل رسوم من رمز التخزين التعريفي Elevation مقابل الطلبات إلى Evvation API في "خرائط Google" أو إلى Elevation API.
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1000) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |
رمز التخزين التعريفي: التحقق من العنوان
طلب إلى طريقة التحقّق من الصحة (REST) وطريقة التحقّق من الصحة (gRPC) لواجهة برمجة تطبيقات التحقق من العنوان
نطاق الحجم الشهري (السعر لكل طلب) |
||
---|---|---|
0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1000) |
0.0136 دولار أمريكي لكل (13.60 دولارًا أمريكيًا لكل 1000 دولار أمريكي) |
يمكنك التواصل مع فريق المبيعات لمعرفة سعر العدد. |