يسرد هذا القسم رموز التخزين التعريفية المحدّدة لمنتجات "منصة خرائط Google" الأساسية. تتيح لك المنتجات الأساسية الدفع مقابل الاستخدام فقط، وبالتالي لن تدفع إلا مقابل رموز التخزين التعريفية التي تستخدمها.
لكل رمز تخزين تعريفي مُدرَج، ستظهر لك المعلومات التالية:
- اسم رمز التخزين التعريفي كما يظهر في تقرير الفوترة
- تفاصيل تصف نوع الاستخدام الذي يؤدي إلى تنشيط رمز التخزين التعريفي (الأحداث القابلة للفوترة)
- السعر لكل عملية استخدام للفئات المستندة إلى الحجم
- أي ملاحظات إضافية حول الأسعار الخاصة برمز التخزين التعريفي
يمكنك البحث عن رموز التخزين التعريفية للمنتجات الفردية هنا، أو استخدام حاسبة الأسعار والاستخدام لتقدير معدّل الاستخدام مقارنةً بالتكلفة الإجمالية لكل واجهة برمجة تطبيقات.
جدول المنتجات أو رموز التخزين التعريفية في "منصة Google للتسويق"
رموز التخزين التعريفية للمنتجات في "خرائط Google"
تشمل واجهات برمجة التطبيقات في "خرائط Google": حزمة SDK لتطبيق "خرائط Google" لنظام التشغيل Android، حزمة SDK لتطبيق "خرائط Google" لنظام التشغيل iOS، واجهة برمجة التطبيقات JavaScript للخرائط، واجهة برمجة التطبيقات Maps Static API، واجهة برمجة التطبيقات Street View Static API، واجهة برمجة التطبيقات Maps Embed API.
رمز التخزين التعريفي: خرائط ثابتة أصلية للأجهزة الجوّالة
يتضمّن عنصرًا من "خرائط Google" في الوضع البسيط، ولم يتم تحميله باستخدام معرّف خريطة، في تطبيق جوّال يستخدم حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android.
| نطاق الحجم الشهري (السعر لكل تحميل خريطة) |
||
|---|---|---|
| 0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
يتم تحميل خريطة واحدة لكل عملية إنشاء لعنصر خريطة Google في الوضع البسيط،
في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android. يتم إنشاء الخرائط باستخدام مثيلات من فئات
MapFragment أو
SupportMapFragment أو MapView. يتم احتساب عملية تحميل خريطة
في كل مرة يتم فيها استدعاء طريقة onCreate() ذات الصلة.
رمز التخزين التعريفي: خرائط ديناميكية مدمجة مع المحتوى للأجهزة الجوّالة
عنصر من "خرائط Google" لم يتم تحميله باستخدام معرّف خريطة، في تطبيق متوافق مع حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS
| نطاق الحجم الشهري (السعر لكل تحميل خريطة) |
||
|---|---|---|
| 0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
يتم تحميل خريطة واحدة لكل عملية إنشاء لعنصر خريطة Google في تطبيق برمجي متوافق مع الأجهزة الجوّالة يستخدم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS:
- إحدى فئات
MapFragmentأوSupportMapFragmentأوMapViewعلى Android يتم احتساب عملية تحميل خريطة في كل مرة يتم فيها استدعاء طريقةonCreate()ذات الصلة. - عنصر
GMSMapViewعلى أجهزة iOS
لا تؤدي تفاعلات المستخدم مع الخريطة، مثل التمرير أو التكبير أو التصغير أو تبديل تضاريس الخرائط، إلى تحميل خرائط إضافية. في ظل نموذج الدفع عند الاستخدام، لن يتم تحصيل رسوم منك مقابل إنشاء صورة بانورامية في "التجوّل الافتراضي" كتحميل خريطة أساسية في تطبيق متوافق مع الأجهزة الجوّالة. ويتم تحصيل رسومها كرسوم لميزة "التجوّل الافتراضي" الديناميكية.
SKU: تضمين وSKU: تضمين متقدّم
تتوفّر جميع طلبات البيانات من واجهة برمجة التطبيقات لميزة "إدراج خرائط Google" بدون أي رسوم مع إمكانية الاستخدام غير المحدود.
رمز التخزين التعريفي: الخرائط الثابتة
طلب موجَّه إلى Maps Static API
| نطاق الحجم الشهري (السعر لكل تحميل خريطة) |
||
|---|---|---|
| 0.002 دولار أمريكي لكل (2.00 دولار أمريكي لكل 1,000) |
0.0016 دولار أمريكي لكل (1.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الخرائط الديناميكية
تطبيق يعرض خريطة تم تحميلها باستخدام معرّف خريطة أو بدونه باستخدام واجهة برمجة تطبيقات JavaScript للخرائط، أو خريطة تم تحميلها باستخدام معرّف خريطة وباستخدام إما حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS
| نطاق الحجم الشهري (السعر لكل تحميل خريطة) |
||
|---|---|---|
| 0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
لا تؤدي تفاعلات المستخدم مع الخريطة، مثل التمرير أو التصغير أو التكبير أو تبديل طبقات الخريطة، إلى توليد عمليات تحميل إضافية للخريطة.
رمز التخزين التعريفي: "التجوّل الافتراضي" الثابت
يتم الآن تحصيل رسوم منفصلة مقابل تحميل الخرائط والصور البانورامية في "التجوّل الافتراضي". يتم تحصيل رسوم مقابل كل طلب يتم إرساله إلى Street View Static API بهدف تضمين بانوراما ثابتة (غير تفاعلية) في "التجوّل الافتراضي". لا يتم تحصيل رسوم مقابل استخدام نقطة نهاية البيانات الوصفية لصورة "التجوّل الافتراضي".
| نطاق الحجم الشهري (السعر لكل بانوراما) |
||
|---|---|---|
| 0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي
يتم الآن تحصيل رسوم منفصلة مقابل تحميل الخرائط والصور البانورامية في "التجوّل الافتراضي". يتم تحصيل رسوم منك مقابل كلّ إنشاء لعنصر بانوراما في تطبيق Maps JavaScript API أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.
| نطاق الحجم الشهري (السعر لكل بانوراما) |
||
|---|---|---|
| 0.014 دولار أمريكي لكل (14.00 دولار أمريكي لكل 1,000) |
0.0112 دولار أمريكي لكل (11.20 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تحدث عملية إنشاء مثيل لكائن بانوراما:
- في JavaScript، باستخدام فئة
google.maps.StreetViewPanorama()أو الطريقةMap.getStreetView()لا يتم تحصيل رسوم مقابل استخدام تجربة "التجوّل الافتراضي" المضمّنة استنادًا إلى عنصر التحكّم في "الدليل" في "التجوّل الافتراضي" أو استخدام فئةStreetViewService(). - على Android، باستخدام إحدى فئات
StreetViewPanoramaFragmentأوSupportStreetViewPanoramaFragmentأوStreetViewPanoramaViewيتم احتساب صورة بانورامية في كل مرة يتم فيها استدعاء الطريقةonCreate()ذات الصلة. - على iOS، باستخدام العنصر
GMSPanoramaView
رمز التخزين التعريفي: عرض جوي
طلب موجَّه إلى Aerial View API يعرض عنوان URL لفيديو من الجو
| نطاق الحجم الشهري (السعر لكل طلب lookupVideo ناجح) |
||
|---|---|---|
| 0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000) |
0.0128 دولار أمريكي لكل (12.80 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
لا يتم تحصيل رسوم إلا مقابل المكالمات التي تؤدي إلى
lookupVideo وتعرض عناوين URL. قد يؤدي lookupVideo استجابة واحدة ناجحة إلى عرض عناوين URL متعددة، كلّ عنوان منها يعرض درجة دقة أو اتجاهًا مختلفًا، ولكنّه يشكّل حدثًا واحدًا فقط خاضعًا للفوترة. يُرجى العِلم أنّ الأسعار لا تعتمد على
عدد المشاهدات الفعلية لعناوين URL هذه من قِبل المستخدمين النهائيين.
إعادة توجيه رموز التخزين التعريفية للمنتجات
تشمل واجهات برمجة التطبيقات في Routes ما يلي: Directions API، Distance Matrix API، Roads API.
رمز التخزين التعريفي: الاتجاهات
طلب موجَّه إلى "خدمة الاتجاهات" في واجهة برمجة التطبيقات JavaScript لخرائط Google (يستبعد الطلبات التي تؤدي إلى تنشيط رمز التخزين التعريفي للفوترة Directions Advanced) أو واجهة برمجة التطبيقات Directions API
| نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: مسار الاتجاهات المتقدّم
طلب موجَّه إلى خدمة "الاتجاهات" في واجهة برمجة التطبيقات JavaScript API لخرائط Google أو Directions API يستخدم معلومات عدد الزيارات وأكثر من 10 نقاط اتّجاه و/أو تحسين نقاط الالتفاف و/أو عوامل تعديل الموقع الجغرافي
| نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يتم تحصيل رسوم SKU "الاتجاهات المتقدّمة" مقابل طلبات Directions Service من واجهة برمجة التطبيقات JavaScript لخرائط Google أو Directions API التي تستخدم واحدًا أو أكثر مما يلي:
- معلومات عن عدد الزيارات: تُستخدَم معلومات حركة المرور عند استيفاء جميع الشروط التالية
(هذه هي الشروط المطلوبة لتلقّي الحقل
duration_in_trafficفي ردّ "الاتجاهات"):- قيمة مَعلمة
travel
modeهيdrivingأو لم يتم تحديدها (drivingهي وضع السفر التلقائي). - يتضمّن الطلب معلَمة válida
departure_time. يمكن ضبطdeparture_timeعلى الوقت الحالي أو وقت في المستقبل. لا يمكن أن يكون في الماضي. - لا يتضمّن الطلب نقاط توقف
نقاط الطريق. إذا كان الطلب
يتضمّن نقاط طريق، أضِف البادئة
via:إلى كل نقطة طريق للتأثير في المسار ولكن تجنَّب التوقفات. على سبيل المثال،&waypoints=via:San Francisco|via:Mountain View|...
- قيمة مَعلمة
travel
- أكثر من 10 نقاط طريق (بين 11 و25)
- تحسين نقاط التوقف يتم ضبط المَعلمة
optimizeعلىtrueلنقاط التوقف. على سبيل المثال،&waypoints=optimize:true|San Francisco|Mountain View|...
- معدّلات المواقع الجغرافية: عند استخدام
مُعدِّلات
الموقع الجغرافي التالية للإشارة إلى كيفية اقتراب السائقين من موقع جغرافي معيّن:
side_of_roadheading
رمز التخزين التعريفي: مصفوفة المسافات
طلب موجَّه إلى Distance Matrix API أو خدمة Distance Matrix في واجهة برمجة التطبيقات JavaScript لخرائط Google (يستبعد الطلبات التي تؤدي إلى رمز التخزين التعريفي للفوترة المتقدّمة في Distance Matrix)
| نطاق الحجم الشهري (السعر لكل عنصر) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يُنشئ كل طلب بحث يتم إرساله إلى Distance Matrix API عناصر، حيث يكون عدد
origins مضروبًا في عدد destinations يساوي عدد
العناصر.
رمز التخزين التعريفي: Distance Matrix Advanced
طلب موجَّه إلى Distance Matrix API أو خدمة Distance Matrix في Maps JavaScript API التي تستخدِم معلومات حركة المرور و/أو مُعدِّلات الموقع الجغرافي
| نطاق الحجم الشهري (السعر لكل عنصر) |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يُنشئ كل طلب بحث يتم إرساله إلى Distance Matrix API عناصر، حيث يساوي عدد
origins مضروبًا في عدد destinations عدد العناصر.
يتم تحصيل رسوم SKU "Distance Matrix Advanced" مقابل Distance Matrix API أو Distance Matrix Service من Maps JavaScript API التي تستخدم واحدًا أو أكثر مما يلي:
- معلومات عن عدد الزيارات: تُستخدَم معلومات حركة المرور عند استيفاء جميع الشروط التالية (هذه هي الشروط المطلوبة
لتلقّي الحقل
duration_in_trafficفي استجابة "مصفوفة المسافات"):- قيمة مَعلمة
travel
modeهيdrivingأو لم يتم تحديدها (drivingهي وضع السفر التلقائي). - يتضمّن الطلب مَعلمة
departure_timeصالحة. يمكن ضبطdeparture_timeعلى الوقت الحالي أو وقت في المستقبل. لا يمكن أن يكون في الماضي.
- قيمة مَعلمة
travel
- معدّلات المواقع الجغرافية: عند استخدام مُعدِّلات
الموقع الجغرافي التالية للإشارة إلى كيفية اقتراب السائقين من موقع جغرافي معيّن:
side_of_roadheading
رمز التخزين التعريفي: الطرق - المسار الذي تمّ قطعه
طلب إلى خدمة المحاذاة إلى الطرق في Roads API
| نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الطرق - أقرب طريق
طلب إلى خدمة Nearest Roads في Roads API
| نطاق الحجم الشهري (السعر لكل طلب بحث) |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الطرق - حدود السرعة
طلب إلى خدمة Speed Limits في Roads API| نطاق الحجم الشهري (السعر لكل عنصر) |
||
|---|---|---|
| 0.02 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
وتتم فوترة طلبات حد السرعة لكل عنصر حد سرعة يتم عرضه في استجابة واجهة برمجة التطبيقات. سيكون هذا العدد دائمًا مساويًا لعدد النقاط التي تم تمريرها في الطلب الأصلي أو أقل منه.
رمز التخزين التعريفي: المسارات: مسارات الحوسبة - أساسية
طلب حساب المسارات
| نطاق الحجم الشهري السعر لكل طلب بحث |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: المسارات: احتساب المسارات - متقدم
طلب للحصول على مسارات حسابية تستخدم ميزات متقدّمة
| نطاق الحجم الشهري السعر لكل طلب بحث |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم مقابل طلب Compute Routes الذي يستخدم واحدة أو أكثر من الميزات التالية:
- من 11 إلى 25 نقطة مسار وسيطة
- المسار الأمثل المراعي لحركة المرور تتوافق خيارات التوجيه هذه مع ضبط سمة
routingPreferenceفي الطلب علىTRAFFIC_AWAREأوTRAFFIC_AWARE_OPTIMAL. - معدّلات المواقع الجغرافية: عند استخدام الخيارات التالية للإشارة إلى كيفية اقترارب السائقين من موقع جغرافي معيّن:
رمز التخزين التعريفي: المسارات: مسارات الحوسبة - المفضّلة
طلب لتحديد مسارات التنقّل باستخدام الميزات المفضّلة
| نطاق الحجم الشهري السعر لكل طلب بحث |
||
|---|---|---|
| 0.015 دولار أمريكي لكل (15.00 دولار أمريكي لكل 1,000) |
0.012 دولار أمريكي لكل (12.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يتم تحصيل رسوم رمز التخزين التعريفي المفضّل مقابل طلب Compute Routes الذي يستخدم واحدة أو أكثر من الميزات التالية:
رمز التخزين التعريفي: المسارات: مصفوفة مسارات الحوسبة - أساسية
طلب للقيام بحساب مصفوفة المسارات
| نطاق الحجم الشهري السعر لكل عنصر |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: المسارات: احتساب مصفوفة المسارات - متقدم
طلب لحساب مصفوفة المسارات باستخدام ميزات متقدّمة
| نطاق الحجم الشهري السعر لكل عنصر |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم مقابل طلب Compute Route Matrix يستخدم واحدة أو أكثر من الميزات التالية:
- المسار الأمثل المراعي لحركة المرور تتوافق خيارات التوجيه هذه مع ضبط سمة
routingPreferenceفي الطلب علىTRAFFIC_AWAREأوTRAFFIC_AWARE_OPTIMAL. - معدّلات المواقع الجغرافية: عند استخدام الخيارات التالية للإشارة إلى كيفية اقترارب السائقين من موقع جغرافي معيّن:
رمز التخزين التعريفي: المسارات: احتساب مصفوفة المسارات - المفضّلة
طلب لحساب مصفوفة المسارات يستخدِم الميزات المفضّلة
| نطاق الحجم الشهري السعر لكل عنصر |
||
|---|---|---|
| 0.015 دولار أمريكي لكل (15.00 دولار أمريكي لكل 1,000) |
0.012 دولار أمريكي لكل (12.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يتم تحصيل رسوم رمز التخزين التعريفي المفضّل مقابل طلب Compute Route Matrix يستخدم واحدة أو أكثر من الميزات التالية:
رمز التخزين التعريفي: تحسين المسار: توجيه مركبة واحدة
طلب موجَّه إلى Route Optimization API يحدِّد مركبة واحدة بالضبط
| نطاق الحجم الشهري (السعر لكل شحنة) |
||
|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: تحسين المسار: توجيه الأسطول
طلب موجَّه إلى Route Optimization API يحدِّد أكثر من مركبة واحدة
| نطاق الحجم الشهري (السعر لكل شحنة) |
||
|---|---|---|
| 0.03 دولار أمريكي لكل (30.00 دولار أمريكي لكل 1,000) |
0.014 دولار أمريكي لكل (14.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رموز التخزين التعريفية للمنتجات في "الأماكن" (الإصدار الجديد)
لمحة عن أقنعة الحقول
استخدِم أقنعة الحقول، التي تُعرف أيضًا باسم قوائم الحقول، في طلباتك لتحديد قائمة الحقول التي سيتم عرضها في الاستجابة. ويتم بعد ذلك تحصيل الرسوم منك وفقًا لأعلى رقم تعريف منتج ينطبق على طلبك. وهذا يعني أنّه في حال اختيار حقول في كلّ من رمز التخزين التعريفي (الأساسي) ورمز التخزين التعريفي (المتقدّم)، يتمّ تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي (المتقدّم).
يُعدّ استخدام قناع حقل من أفضل ممارسات التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة والرسوم غير الضرورية للفوترة.
لمحة عن جلسات "الإكمال التلقائي (جديد)"
تتضمّن جلسة "الإكمال التلقائي (جديد)" طلبًا واحدًا أو أكثر من طلبات "الإكمال التلقائي (جديد)"، وأحد طلبَي "تفاصيل المكان (جديد)" أو "التحقّق من العنوان". يتم تمرير رمز الجلسة نفسه إلى طلب الإكمال التلقائي (جديد) وإلى طلب "تفاصيل المكان (جديد)" أو طلب "إثبات صحة العنوان" العميق التاليين.
تبدأ الجلسة بأول طلب من ميزة "الإكمال التلقائي (جديد)". بعد ذلك، يتم إرسال طلب "تفاصيل المكان (جديد)" أو طلب "إثبات صحة العنوان" عندما يختار المستخدم أحد اقتراحات "الإكمال التلقائي (جديد)". في حال إلغاء جلسة، أي عدم تقديم طلب "تفاصيل المكان (جديد)" أو طلب "التحقّق من العنوان"، يتم تحصيل رسوم طلبات "الإكمال التلقائي (جديد)" كما لو لم يتم تقديم رمز مميّز للجلسة.
بعد اختيار المستخدم مكانًا (أي تقديم طلب "تفاصيل المكان (جديد)" أو طلب "إثبات صحة العنوان")، عليك بدء جلسة جديدة باستخدام رمز ترويجي جديد للجلسة.
يُستخدم الرمز المميّز للجلسة لجلسة واحدة ولا يمكن استخدامه لأكثر من جلسة واحدة. في حال إعادة استخدام رمز مميّز للجلسة، تُعتبر الجلسة غير صالحة ويتم تحصيل رسوم من الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.
رمز التخزين التعريفي: طلبات الإكمال التلقائي
يتم تحصيل رسوم رمز التخزين التعريفي طلبات الإكمال التلقائي مقابل كل طلب إلى واجهة برمجة التطبيقات Autocomplete (New) API التي لا تتضمّن رمز جلسة.
يتم تحصيل الرسوم أيضًا في حال استخدام الرموز المميّزة للجلسات وتنفيذ أيّ مما يلي:
- يمكنك إنهاء الجلسات من خلال طلب واحد إلى "تفاصيل المكان" (جديد) الذي
يطلب أي حقول محدّدة من خلال رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
- يتم تحصيل رسوم كل طلب إكمال تلقائي (جديد) يصل إلى 12 طلبًا باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
- يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
- يمكنك التخلي عن الجلسة أو إنهائها من خلال إجراء مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط). بعد ذلك، يتمّ تحصيل رسوم منك مقابل كلّ طلبات "الإكمال التلقائي (جديد)" باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي
يتم تحصيل رسوم رمز التخزين التعريفي استخدام جلسة الإكمال التلقائي مقابل كل طلب إلى واجهة برمجة التطبيقات Autocomplete (New) API التي تتضمّن رمز جلسة.
يتم تحصيل رسوم رمز التخزين التعريفي هذا في السيناريوهات التالية:
تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط):
- يتم تحصيل رسوم كل طلب إكمال تلقائي (جديد) يصل إلى 12 طلبًا باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
- يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى رمز التخزين التعريفي: تفاصيل المنتج (أساسي أو متقدّم أو مفضّل).
يتم تحصيل رسوم طلب بيانات عن مكان يطلب أي حقل من رمز التخزين التعريفي: تفاصيل المكان (أساسية أو متقدّمة أو مفضّلة) وفقًا لرمز التخزين التعريفي: تفاصيل المكان (مفضّلة).
تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى SKU: Address Validation Preferred.
لمزيد من المعلومات، يُرجى الاطّلاع على الميزة التلقائية (الجديدة) وأسعار الجلسات.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.00 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: تفاصيل المكان (المعرّفات فقط)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.DISPLAY_NAME،
Place.Field.ID،
Place.Field.PHOTO_METADATAS،
Place.Field.RESOURCE_NAME
Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google":
id،
photos
iOS:
GMSPlacePropertyPlaceID،
GMSPlacePropertyName،
GMSPlacePropertyPhotos
خدمة الويب:
attributions،
id،
name*،
photos
* يحتوي الحقل name على اسم المورد
للمكان على النحو التالي: places/PLACE_ID. استخدِم displayName
للوصول إلى الاسم النصي للمكان.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ADDRESS_COMPONENTS،
ADR_FORMAT_ADDRESS،
Place.Field.FORMATTED_ADDRESS،
Place.Field.LOCATION،
Place.Field.PLUS_CODE،
Place.Field.SHORT_FORMATTED_ADDRESS،
Place.Field.TYPES،
Place.Field.VIEWPORT
Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
addressComponents،
adrFormatAddress،
formattedAddress،
location،
plusCode،
types،
viewport
iOS:
GMSPlacePropertyAddressComponents،
GMSPlacePropertyFormattedAddress،
GMSPlacePropertyCoordinate،
GMSPlacePropertyPlusCode،
GMSPlacePropertyTypes،
GMSPlacePropertyViewport
خدمة الويب:
addressComponents،
adrFormatAddress،
formattedAddress،
location،
plusCode،
shortFormattedAddress،
types،
viewport
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: تفاصيل المكان (أساسية)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ACCESSIBILITY_OPTIONS،
Place.Field.BUSINESS_STATUS،
Place.Field.GOOGLE_MAPS_URI،
Place.Field.ICON_BACKGROUND_COLOR،
Place.Field.ICON_MASK_URL،
Place.Field.PRIMARY_TYPE،
Place.Field.PRIMARY_TYPE_DISPLAY_NAME،
Place.Field.SUB_DESTINATIONS،
Place.Field.UTC_OFFSET
Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
accessibilityOptions،
businessStatus،
displayName،
googleMapsUri،
iconBackgroundColor،
primaryTypeDisplayName،
svgIconMaskURI،
types،
utcOffsetMinutes
iOS:
GMSPlacePropertyBusinessStatus،
GMSPlacePropertyIconBackgroundColor،
GMSPlacePropertyIconImageURL،
GMSPlacePropertyUTCOffsetMinutes،
GMSPlacePropertyWheelchairAccessibleEntrance
خدمة الويب:
accessibilityOptions،
businessStatus،
containingPlaces،
displayName،
googleMapsLinks*،
googleMapsUri،
iconBackgroundColor،
iconMaskBaseUri،
primaryType،
primaryTypeDisplayName،
pureServiceAreaBusiness،
subDestinations،
utcOffsetMinutes
* الحقل googleMapsLinks في مرحلة المعاينة قبل الإصدار العلني
ولا يتم تحصيل أي رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.
إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.0170 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: تفاصيل المكان (إعداد متقدّم)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.CURRENT_OPENING_HOURS،
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER،
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS،
Place.Field.PRICE_LEVEL،
Place.Field.RATING،
Place.Field.SECONDARY_OPENING_HOURS،
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
internationalPhoneNumber،
nationalPhoneNumber،
priceLevel،
rating،
regularOpeningHours،
userRatingCount،
websiteUri
iOS:
GMSPlacePropertyCurrentOpeningHours،
GMSPlacePropertySecondaryOpeningHours،
GMSPlacePropertyPhoneNumber،
GMSPlacePropertyPriceLevel،
GMSPlacePropertyRating،
GMSPlacePropertyOpeningHours،
GMSPlacePropertyUserRatingsTotal،
GMSPlacePropertyWebsite
خدمة الويب:
currentOpeningHours،
currentSecondaryOpeningHours،
internationalPhoneNumber،
nationalPhoneNumber،
priceLevel،
priceRange،
rating،
regularOpeningHours،
regularSecondaryOpeningHours،
userRatingCount،
websiteUri
إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
0.016 دولار أمريكي لكل (16.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: تفاصيل المكان (الخيار المفضّل)
باستخدام قناع حقل أو قائمة حقول في طلب "تفاصيل المكان (جديد)"، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ALLOWS_DOGS،
Place.Field.CURBSIDE_PICKUP،
Place.Field.DELIVERY،
Place.Field.DINE_IN،
Place.Field.EDITORIAL_SUMMARY،
Place.Field.EV_CHARGE_OPTIONS،
Place.Field.FUEL_OPTIONS،
Place.Field.GOOD_FOR_CHILDREN،
Place.Field.GOOD_FOR_GROUPS،
Place.Field.GOOD_FOR_WATCHING_SPORTS،
Place.Field.LIVE_MUSIC،
Place.Field.MENU_FOR_CHILDREN،
Place.Field.OUTDOOR_SEATING،
Place.Field.PARKING_OPTIONS،
Place.Field.PAYMENT_OPTIONS،
Place.Field.RESERVABLE،
Place.Field.RESTROOM،
Place.Field.REVIEWS،
Place.Field.SERVES_BEER،
Place.Field.SERVES_BREAKFAST،
Place.Field.SERVES_BRUNCH،
Place.Field.SERVES_COCKTAILS،
Place.Field.SERVES_COFFEE،
Place.Field.SERVES_DESSERT،
Place.Field.SERVES_DINNER،
Place.Field.SERVES_LUNCH،
Place.Field.SERVES_VEGETARIAN_FOOD،
Place.Field.SERVES_WINE،
Place.Field.TAKEOUT
Places Library، واجهة برمجة التطبيقات JavaScript في "خرائط 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
iOS:
GMSPlacePropertyCurbsidePickup،
GMSPlacePropertyDelivery،
GMSPlacePropertyDineIn،
GMSPlacePropertyEditorialSummary،
GMSPlacePropertyReservable،
GMSPlacePropertyReviews،
GMSPlacePropertyServesBeer،
GMSPlacePropertyServesBreakfast،
GMSPlacePropertyServesBrunch،
GMSPlacePropertyServesDinner،
GMSPlacePropertyServesLunch،
GMSPlacePropertyServesVegetarianFood،
GMSPlacePropertyServesWine،
GMSPlacePropertyTakeout
خدمة الويب:
allowsDogs،
curbsidePickup،
delivery،
dineIn،
editorialSummary،
evChargeOptions،
fuelOptions،
goodForChildren،
goodForGroups،
goodForWatchingSports،
liveMusic،
menuForChildren،
parkingOptions،
paymentOptions،
outdoorSeating،
reservable،
restroom،
reviews،
routingSummaries،*
servesBeer،
servesBreakfast،
servesBrunch،
servesCocktails،
servesCoffee،
servesDessert،
servesDinner،
servesLunch،
servesVegetarianFood،
servesWine،
takeout
* البحث النصي والبحث عن الأماكن المجاورة فقط
إذا تم إنهاء جلسة "الإكمال التلقائي" من خلال طلب "تفاصيل الأماكن" الذي يطلب أي حقل من SKU: تفاصيل الأماكن (أساسية أو متقدّمة أو مفضّلة)، يتم تحصيل رسوم الطلب من العميل وفقًا لSKU: تفاصيل الأماكن (المفضّلة). لمزيد من المعلومات، يُرجى الاطّلاع على رمز التخزين التعريفي: استخدام جلسة الإكمال التلقائي.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1,000) |
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: ميزة "البحث في الأماكن القريبة" (أساسية)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث عن الأماكن القريبة" (جديد)، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ADDRESS_COMPONENTS،
Place.Field.BUSINESS_STATUS،
Place.Field.ADDRESS،
Place.Field.ICON_BACKGROUND_COLOR،
Place.Field.ICON_URL،
Place.Field.LAT_LNG،
Place.Field.PHOTO_METADATAS،
Place.Field.PLUS_CODE،
Place.Field.PRIMARY_TYPE،
Place.Field.PRIMARY_TYPE_DISPLAY_NAME،
Place.Field.ID،
Place.Field.NAME،
Place.Field.TYPES،
Place.Field.UTC_OFFSET،
Place.Field.VIEWPORT،
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google":
accessibilityOptions،
addressComponents،
adrFormatAddress،
businessStatus،
displayName،
formattedAddress،
googleMapsUri،
iconBackgroundColor،
id،
location،
photos،
plusCode،
svgIconMaskURI،
types،
utcOffsetMinutes،
viewport
iOS:
GMSPlacePropertyAddressComponents،
GMSPlacePropertyBusinessStatus،
GMSPlacePropertyCoordinate،
GMSPlacePropertyFormattedAddress،
GMSPlacePropertyName،
GMSPlacePropertyIconBackgroundColor،
GMSPlacePropertyIconImageURL،
GMSPlacePropertyPhotos،
GMSPlacePropertyPlaceID،
GMSPlacePropertyPlusCode،
GMSPlacePropertyTypes،
GMSPlacePropertyUTCOffsetMinutes،
GMSPlacePropertyViewport،
GMSPlacePropertyWheelchairAccessibleEntrance
خدمة الويب:
places.accessibilityOptions،
places.addressComponents،
places.adrFormatAddress،
places.attributions،
places.businessStatus،
places.containingPlaces،
places.displayName،
places.formattedAddress،
places.googleMapsLinks*،
places.googleMapsUri،
places.iconBackgroundColor،
places.iconMaskBaseUri،
places.id،
places.location،
places.name**،
places.photos،
places.plusCode،
places.primaryType،
places.primaryTypeDisplayName،
places.pureServiceAreaBusiness،
places.shortFormattedAddress،
places.subDestinations،
places.types،
places.utcOffsetMinutes،
places.viewport
* الحقل places.googleMapsLinks في مرحلة المعاينة قبل الإصدار العلني
ولا يتم تحصيل رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.
** يحتوي الحقل places.name على اسم المورد
للمكان على النحو التالي: places/PLACE_ID. استخدِم places.displayName
للوصول إلى الاسم النصي للمكان.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: البحث في الأماكن القريبة (متقدّم)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث عن الأماكن القريبة" (جديد)، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.CURRENT_OPENING_HOURS،
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER،
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS،
Place.Field.PRICE_LEVEL،
Place.Field.RATING،
Place.Field.SECONDARY_OPENING_HOURS،
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
internationalPhoneNumber،
nationalPhoneNumber،
priceLevel،
rating،
regularOpeningHours،
userRatingCount،
websiteUri
iOS:
GMSPlacePropertyCurrentOpeningHours،
GMSPlacePropertySecondaryOpeningHours،
GMSPlacePropertyPhoneNumber،
GMSPlacePropertyPriceLevel،
GMSPlacePropertyRating،
GMSPlacePropertyOpeningHours،
GMSPlacePropertyUserRatingsTotal،
GMSPlacePropertyWebsite
خدمة الويب:
places.currentOpeningHours،
places.currentSecondaryOpeningHours،
places.internationalPhoneNumber،
places.nationalPhoneNumber،
places.priceLevel،
places.priceRange،
places.rating،
places.regularOpeningHours،
places.regularSecondaryOpeningHours،
places.userRatingCount،
places.websiteUri
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: البحث في الأماكن القريبة (الخيار المفضّل)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث عن الأماكن القريبة" (جديد)، يمكنك حصر الردّ على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ALLOWS_DOGS،
Place.Field.CURBSIDE_PICKUP،
Place.Field.DELIVERY،
Place.Field.DINE_IN،
Place.Field.EDITORIAL_SUMMARY،
Place.Field.EV_CHARGE_OPTIONS،
Place.Field.FUEL_OPTIONS،
Place.Field.GOOD_FOR_CHILDREN،
Place.Field.GOOD_FOR_GROUPS،
Place.Field.GOOD_FOR_WATCHING_SPORTS،
Place.Field.LIVE_MUSIC،
Place.Field.MENU_FOR_CHILDREN،
Place.Field.OUTDOOR_SEATING،
Place.Field.PARKING_OPTIONS،
Place.Field.PAYMENT_OPTIONS،
Place.Field.RESERVABLE،
Place.Field.RESTROOM،
Place.Field.REVIEWS،
Place.Field.SERVES_BEER،
Place.Field.SERVES_BREAKFAST،
Place.Field.SERVES_BRUNCH،
Place.Field.SERVES_COCKTAILS،
Place.Field.SERVES_COFFEE،
Place.Field.SERVES_DESSERT،
Place.Field.SERVES_DINNER،
Place.Field.SERVES_LUNCH،
Place.Field.SERVES_VEGETARIAN_FOOD،
Place.Field.SERVES_WINE،
Place.Field.TAKEOUT
Places Library، واجهة برمجة التطبيقات JavaScript في "خرائط 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
iOS:
GMSPlacePropertyCurbsidePickup،
GMSPlacePropertyDelivery،
GMSPlacePropertyDineIn،
GMSPlacePropertyEditorialSummary،
GMSPlacePropertyReservable،
GMSPlacePropertyReviews،
GMSPlacePropertyServesBeer،
GMSPlacePropertyServesBreakfast،
GMSPlacePropertyServesBrunch،
GMSPlacePropertyServesDinner،
GMSPlacePropertyServesLunch،
GMSPlacePropertyServesVegetarianFood،
GMSPlacePropertyServesWine،
GMSPlacePropertyTakeout
خدمة الويب:
places.allowsDogs،
places.curbsidePickup،
places.delivery،
places.dineIn،
places.editorialSummary،
places.evChargeOptions،
places.fuelOptions،
places.goodForChildren،
places.goodForGroups،
places.goodForWatchingSports،
places.liveMusic،
places.menuForChildren،
places.parkingOptions،
places.paymentOptions،
places.outdoorSeating،
places.reservable،
places.restroom،
places.reviews،
places.routingSummaries،*
places.servesBeer،
places.servesBreakfast،
places.servesBrunch،
places.servesCocktails،
places.servesCoffee،
places.servesDessert،
places.servesDinner،
places.servesLunch،
places.servesVegetarianFood،
places.servesWine،
places.takeout
* البحث النصي والبحث عن الأماكن المجاورة فقط
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: البحث النصي (المعرّف فقط)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.DISPLAY_NAME،
Place.Field.ID،
Place.Field.RESOURCE_NAME
iOS:
GMSPlacePropertyPlaceID،
GMSPlacePropertyName
Places Library، وMaps JavaScript API:
id
خدمة الويب:
places.attributions،
places.id،
places.name*،
nextPageToken
* يحتوي الحقل places.name على اسم المورد
للمكان على النحو التالي: places/PLACE_ID. استخدِم places.displayName
للوصول إلى الاسم النصي للمكان.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
0.0 دولار أمريكي لكل (0.00 دولار أمريكي لكل 1,000) |
رمز التخزين التعريفي: البحث بالكتابة (أساسي)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ACCESSIBILITY_OPTIONS،
Place.Field.ADDRESS_COMPONENTS،
Place.Field.ADR_FORMAT_ADDRESS،
Place.Field.BUSINESS_STATUS،
Place.Field.FORMATTED_ADDRESS،
Place.Field.GOOGLE_MAPS_URI،
Place.Field.ICON_BACKGROUND_COLOR،
Place.Field.ICON_MASK_URL،
Place.Field.LOCATION،
Place.Field.PHOTO_METADATAS،
Place.Field.PLUS_CODE،
Place.Field.PRIMARY_TYPE،
Place.Field.PRIMARY_TYPE_DISPLAY_NAME،
Place.Field.SHORT_FORMATTED_ADDRESS،
Place.Field.SUB_DESTINATIONS،
Place.Field.TYPES،
Place.Field.UTC_OFFSET،
Place.Field.VIEWPORT
iOS:
GMSPlacePropertyAddressComponents،
GMSPlacePropertyBusinessStatus،
GMSPlacePropertyFormattedAddress،
GMSPlacePropertyIconBackgroundColor،
GMSPlacePropertyIconImageURL،
GMSPlacePropertyCoordinate،
GMSPlacePropertyPhotos،
GMSPlacePropertyPlusCode،
GMSPlacePropertyTypes،
GMSPlacePropertyUTCOffsetMinutes،
GMSPlacePropertyViewport،
GMSPlacePropertyWheelchairAccessibleEntrance
Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
accessibilityOptions،
addressComponents،
adrFormatAddress،
businessStatus،
displayName،
formattedAddress،
googleMapsUri،
iconBackgroundColor،
location،
photos،
plusCode،
svgIconMaskURI،
types،
utcOffsetMinutes،
viewport
خدمة الويب:
places.accessibilityOptions،
places.addressComponents،
places.adrFormatAddress،
places.businessStatus،
places.containingPlaces،
places.displayName،
places.formattedAddress،
places.googleMapsLinks*،
places.googleMapsUri،
places.iconBackgroundColor،
places.iconMaskBaseUri،
places.location،
places.photos،
places.plusCode،
places.primaryType،
places.primaryTypeDisplayName،
places.pureServiceAreaBusiness،
places.shortFormattedAddress،
places.subDestinations،
places.types،
places.utcOffsetMinutes،
places.viewport
* يُرجى العِلم أنّ الحقل places.googleMapsLinks في مرحلة المعاينة قبل الإصدار العلني
ولا يتم تحصيل أي رسوم، أي أنّ الفوترة ستكون 0 دولار أمريكي مقابل الاستخدام أثناء المعاينة.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: البحث النصي (متقدّم)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.CURRENT_OPENING_HOURS،
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER،
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS،
Place.Field.PRICE_LEVEL،
Place.Field.RATING،
Place.Field.SECONDARY_OPENING_HOURS،
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
iOS:
GMSPlacePropertyCurrentOpeningHours،
GMSPlacePropertySecondaryOpeningHours،
GMSPlacePropertyPhoneNumber،
GMSPlacePropertyPriceLevel،
GMSPlacePropertyRating،
GMSPlacePropertyOpeningHours،
GMSPlacePropertyUserRatingsTotal،
GMSPlacePropertyWebsite
خدمة الويب:
places.currentOpeningHours،
places.currentSecondaryOpeningHours،
places.internationalPhoneNumber،
places.nationalPhoneNumber،
places.priceLevel،
places.priceRange،
places.rating،
places.regularOpeningHours،
places.regularSecondaryOpeningHours،
places.userRatingCount،
places.websiteUri
Places Library، واجهة برمجة التطبيقات JavaScript API في "خرائط Google":
internationalPhoneNumber،
nationalPhoneNumber،
priceLevel،
rating،
regularOpeningHours،
userRatingCount،
websiteUri
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.035 دولار أمريكي لكل (35.00 دولار أمريكي لكل 1,000) |
0.028 دولار أمريكي لكل (28.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: البحث النصي (الخيار المفضّل)
باستخدام قناع حقل أو قائمة حقول في طلب "البحث النصي (جديد)"، يمكنك حصر الجواب على الحقول المحدّدة فقط. يتم تنشيط رمز التخزين التعريفي هذا عند طلب الحقول التالية فقط:
Android:
Place.Field.ALLOWS_DOGS،
Place.Field.CURBSIDE_PICKUP،
Place.Field.DELIVERY،
Place.Field.DINE_IN،
Place.Field.EDITORIAL_SUMMARY،
Place.Field.EV_CHARGE_OPTIONS،
Place.Field.FUEL_OPTIONS،
Place.Field.GOOD_FOR_CHILDREN،
Place.Field.GOOD_FOR_GROUPS،
Place.Field.GOOD_FOR_WATCHING_SPORTS،
Place.Field.LIVE_MUSIC،
Place.Field.MENU_FOR_CHILDREN،
Place.Field.OUTDOOR_SEATING،
Place.Field.PARKING_OPTIONS،
Place.Field.PAYMENT_OPTIONS،
Place.Field.RESERVABLE،
Place.Field.RESTROOM،
Place.Field.REVIEWS،
Place.Field.SERVES_BEER،
Place.Field.SERVES_BREAKFAST،
Place.Field.SERVES_BRUNCH،
Place.Field.SERVES_COCKTAILS،
Place.Field.SERVES_COFFEE،
Place.Field.SERVES_DESSERT،
Place.Field.SERVES_DINNER،
Place.Field.SERVES_LUNCH،
Place.Field.SERVES_VEGETARIAN_FOOD،
Place.Field.SERVES_WINE،
Place.Field.TAKEOUT
iOS:
GMSPlacePropertyCurbsidePickup،
GMSPlacePropertyDelivery،
GMSPlacePropertyDineIn،
GMSPlacePropertyEditorialSummary،
GMSPlacePropertyReservable،
GMSPlacePropertyReviews،
GMSPlacePropertyServesBeer،
GMSPlacePropertyServesBreakfast،
GMSPlacePropertyServesBrunch،
GMSPlacePropertyServesDinner،
GMSPlacePropertyServesLunch،
GMSPlacePropertyServesVegetarianFood،
GMSPlacePropertyServesWine،
GMSPlacePropertyTakeout
Places Library، واجهة برمجة التطبيقات JavaScript في "خرائط 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
خدمة الويب:
places.allowsDogs،
places.curbsidePickup،
places.delivery،
places.dineIn،
places.editorialSummary،
places.evChargeOptions،
places.fuelOptions،
places.goodForChildren،
places.goodForGroups،
places.goodForWatchingSports،
places.liveMusic،
places.menuForChildren،
places.parkingOptions،
places.paymentOptions،
places.outdoorSeating،
places.reservable،
places.restroom،
places.reviews،
places.routingSummaries،*
places.servesBeer،
places.servesBreakfast،
places.servesBrunch،
places.servesCocktails،
places.servesCoffee،
places.servesDessert،
places.servesDinner،
places.servesLunch،
places.servesVegetarianFood،
places.servesWine،
places.takeout
* البحث النصي والبحث عن الأماكن المجاورة فقط
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.040 دولار أمريكي لكل (40.00 دولار أمريكي لكل 1,000) |
0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: صورة مكان
يتم تحصيل رسوم رمز التخزين التعريفي Place Photo مقابل كل طلب يتم إرساله إلى واجهة برمجة التطبيقات.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تضع رموز التخزين التعريفية للمنتجات
تشمل واجهات برمجة التطبيقات في "أماكن Google" Places API، حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل Android، حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل iOS، مكتبة أماكن Google، واجهة برمجة تطبيقات JavaScript للخرائط، Geocoding API، Geolocation API، Time Zone API، Elevation API.
لمحة عن جلسات "الإكمال التلقائي"
تتضمّن جلسة "الإكمال التلقائي" بعض طلبات "الإكمال التلقائي" (لاسترداد اقتراحات بشأن مكان أثناء كتابة المستخدم) وطلبًا واحدًا بحد أقصى من طلبات "تفاصيل الأماكن" (لاسترداد تفاصيل عن المكان الذي اختاره المستخدم). يتم تمرير الرمز المميّز للجلسة نفسه إلى ميزة "الإكمال التلقائي" وإلى طلب "تفاصيل المكان" التالي. تبدأ الجلسة بأول طلب إكمال تلقائي (الذي يحدث عادةً عندما يبدأ المستخدم الكتابة). يتم إجراء مكالمة إلى Places Details عندما يختار المستخدِم أحد اقتراحات الإكمال التلقائي. إذا لم يختار المستخدم أي اقتراح، لن يتم إجراء مكالمة بشأن تفاصيل الأماكن.
بعد اختيار مكان من قِبل المستخدم (أي إجراء مكالمة بشأن تفاصيل الأماكن)، عليك بدء جلسة جديدة باستخدام رمز ترويجي جديد للجلسة.
يمكن إنشاء جلسات الإكمال التلقائي من واجهات برمجة التطبيقات التالية:
- خدمة "الإكمال التلقائي للأماكن" في واجهة برمجة التطبيقات Places API أو خدمة "الإكمال التلقائي للأماكن" في واجهة برمجة التطبيقات JavaScript للخرائط عليك تصميم تطبيقك لتقديم الرموز المميّزة للجلسة (قد تحتاج إلى تغيير الرمز الحالي).
- أداة الإكمال التلقائي في واجهة برمجة تطبيقات JavaScript للخرائط يتم تفعيل ميزة الفوترة المستندة إلى الجلسة تلقائيًا في هذه التطبيقات المصغّرة، بدون الحاجة إلى تغيير أي رمز.
يكون الرمز المميّز للجلسة صالحًا لجلسة مستخدم واحدة، ويجب عدم استخدامه لأكثر من جلسة مستخدم واحدة. في حال إعادة استخدام رمز مميّز للجلسة، تُعتبر الجلسة غير صالحة ويتم تحصيل رسوم من الطلبات كما لو لم يتم تقديم رمز مميّز للجلسة.
يتم تحصيل رسوم طلبات الإكمال التلقائي وطلبات تفاصيل الأماكن باستخدام الجلسات على أساس رموّ تخزين تعريفية مختلفة.
لمحة عن أرقام تعريف المنتجات في "بيانات الأماكن"
رموز التخزين التعريفية الثلاثة لبيانات الأماكن هي: البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي.يتم تنشيط رمز تخزين تعريفي واحد أو أكثر للبيانات في ما يلي:
- Android: كل طلب إلى
fetchPlace()أوfindCurrentPlace() - iOS: كل مكالمة إلى
fetchPlaceFromPlaceID:أوfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields: - خدمة الويب: كل طلب من طلبات "الأماكن" استنادًا إلى الحقول المحدّدة في الطلب
يتم دائمًا تحصيل رسوم رموز التخزين التعريفية للبيانات بالإضافة إلى رمز التخزين التعريفي الأساسي للطلب الذي يؤدي إلى بدء هذه الرموز. على سبيل المثال، سيتم تحصيل رسوم طلب "تفاصيل المكان" الذي يتضمّن حقول "البيانات الأساسية" ضمن كلاً من رمز التخزين التعريفي "البيانات الأساسية" ورمز التخزين التعريفي "تفاصيل المكان".
بالنسبة إلى خدمة الويب، تتيح طلبات البيانات هذه من Places API تحديد حقول البيانات التي سيتم عرضها:
بالنسبة إلى خدمة الويب، لا تسمح طلبات بيانات Places API هذه بتحديد الحقول المعروضة. تُعرِض هذه الطلبات دائمًا جميع بيانات "الأماكن"، مع تحصيل رسوم SKUs الثلاثة لبيانات "الأماكن" بالإضافة إلى الرسوم لكل طلب من طلبات واجهة برمجة التطبيقات:
رمز التخزين التعريفي: البيانات الأساسية
باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان"، يمكنك حصر الجواب بالردّ على الحقول المحدّدة فقط. يتم تضمين الحقول في الفئة أساسي في التكلفة الأساسية لطلب "الأماكن" ولا تؤدي إلى تحصيل أي رسوم إضافية. يتم تنشيط رمز التخزين التعريفي البيانات الأساسية عند طلب أيٍّ من الحقول التالية:
-
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
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| تكلفة طلب ميزة "الأماكن" + 0.00 دولار أمريكي |
تكلفة طلب ميزة "الأماكن" + 0.00 دولار أمريكي |
تكلفة طلب ميزة "الأماكن" + 0.00 دولار أمريكي |
رمز التخزين التعريفي: بيانات جهة الاتصال
باستخدام مَعلمة الحقول في طلب "تفاصيل المكان" أو "العثور على مكان" لخدمات الويب، أو
صفيف من Place.Field لنظامَي التشغيل Android أو iOS، يمكنك
حصر الاستجابة بالحقول المحدّدة فقط. تؤدي الحقول في فئة جهة الاتصال
إلى تحصيل رسوم إضافية. يتم تنشيط رمز التخزين التعريفي 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_numberinternational_phone_numberأوopening_hourscurrent_opening_hoursأوsecondary_opening_hourswebsite
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| تكلفة طلب أماكن + 0.003 دولار أمريكي لكل مكان (+ 3.00 دولار أمريكي لكل 1,000 مكان) |
تكلفة طلب أماكن + 0.0024 دولار أمريكي لكل طلب (+ 2.40 دولار أمريكي لكل 1,000 طلب) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: بيانات الغلاف الجوي
باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان"، يمكنك حصر الاستجابة بالحقول المحدّدة فقط. تؤدي الحقول في فئة الجو إلى تحمّل رسوم إضافية. يتم بدء رمز التخزين التعريفي Atmosphere Data عند طلب أيّ من الحقول التالية:
- Android:
Place.Field.CURBSIDE_PICKUPأوPlace.Field.DELIVERYأوPlace.Field.EDITORIAL_SUMMARYأوPlace.Field.DINE_INأوPlace.Field.PRICE_LEVELأوPlace.Field.RATINGأوPlace.Field.RESERVABLEأوPlace.Field.SERVES_BEERأوPlace.Field.SERVES_BREAKFASTأوPlace.Field.SERVES_BRUNCHأوPlace.Field.SERVES_DINNERأوPlace.Field.SERVES_LUNCHأوPlace.Field.SERVES_VEGETARIAN_FOODأوPlace.Field.SERVES_WINEأوPlace.Field.TAKEOUTأوPlace.Field.USER_RATING_COUNT
- أجهزة iOS:
GMSPlaceFieldPriceLevelوGMSPlaceFieldRatingGMSPlaceFieldUserRatingsTotalوGMSPlaceFieldTakeoutوGMSPlaceFieldDeliveryوGMSPlaceFieldDineInوGMSPlaceFieldCurbsidePickupGMSPlaceFieldReservableوGMSPlaceFieldServesBreakfastوGMSPlaceFieldServesLunchوGMSPlaceFieldServesDinnerوGMSPlaceFieldServesBeerGMSPlaceFieldServesWineأو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: خدمة "إكمال الأماكن تلقائيًا" في Maps JavaScript API
- خدمة الويب: خدمة "الإكمال التلقائي للأماكن" في Places API
يتم أيضًا تحصيل رسوم من المكالمات التي يتم إجراؤها من جلسة إكمال تلقائي غير صالحة (على سبيل المثال، جلسة تعيد استخدام رمز مميز للجلسة)، ويكون رمز التخزين التعريفي لهذه المكالمات هو "إكمال تلقائي - لكل طلب".
قد يتم تحصيل رسوم من طلبات الإكمال التلقائي الواردة من شريحة برمجة التطبيقات JavaScript API في "خرائط Google" لوحدة تحكّم الإكمال التلقائي للأماكن في حال إجراء طلبات من جلسة إكمال تلقائي غير صالحة. قد يحدث ذلك عندما يكتب المستخدم عناوين مختلفة متعددة أو ينسخ عناوين مختلفة أو يلصقها في التطبيق المصغّر ولا يختار دائمًا اقتراحًا للإكمال التلقائي.
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة مقابل جلسة الإكمال التلقائي التي لا تتضمّن طلب "تفاصيل الأماكن" (خلال بضع دقائق من بدء الجلسة).
| نطاق الحجم الشهري (السعر لكل جلسة) |
||
|---|---|---|
| 0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
مثال
إذا أصدر تطبيقك طلبَي الاتصال هذين في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
خدمة ويب
- طلب الإكمال التلقائي للأماكن (input=”par”, session_token: XYZ)
- طلب الإكمال التلقائي للأماكن (input=”paris”, session_token: XYZ)
سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- الإكمال التلقائي بدون تفاصيل الأماكن - لكل جلسة (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
رمز التخزين التعريفي: ميزة الإكمال التلقائي (مضمّنة في "تفاصيل المكان") – لكل جلسة
يتم تحصيل رسوم رمز التخزين التعريفي الإكمال التلقائي (مضمّن في تفاصيل الأماكن) - لكل جلسة مقابل جلسة الإكمال التلقائي التي تتضمّن أيًا مما يلي:
- Android: مكالمة إلى
fetchPlace() - iOS: طلب إلى
fetchPlaceFromPlaceID: - خدمة الويب: طلب تفاصيل مكان
يتوفر طلب الإكمال التلقائي بدون أي رسوم، ويتم تحصيل رسوم طلب "تفاصيل المكان" اللاحق استنادًا إلى أسعار "تفاصيل المكان" العادية.
يؤدي طلب "تفاصيل المكان" إلى إنشاء رموز التخزين التعريفية للبيانات (أساسية، جهة اتصال و/أو جو المكان) ، وذلك استنادًا إلى الحقول المحدّدة في الطلب.
في حال عدم تحديد حقول في طلب "تفاصيل المكان"، يتم تنشيط جميع رموز التخزين التعريفية للبيانات (الأساسية وجهات الاتصال والجو).
يتمّ تحصيل رسوم طلبات إعادة تحميل معرّف تفاصيل الأماكن (الطلبات التي تحدّد حقل place_id فقط)
أثناء جلسة الإكمال التلقائي على أنّها رمز التخزين التعريفي: الإكمال التلقائي
بدون تفاصيل الأماكن – لكلّ جلسة.
| نطاق الحجم الشهري (السعر لكل جلسة) |
||
|---|---|---|
| 0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
مثال
إذا أصدر تطبيقك المكالمات الثلاث التالية في جلسة واحدة:
Android
- findAutocompletePredictions() (.setQuery(”par”), .setSessionToken(XYZ))
- findAutocompletePredictions() (.setQuery(”paris”), .setSessionToken(XYZ))
- fetchPlace() (مع
FetchPlaceRequestبما في ذلك رقم تعريف المكان وحقل ADDRESS)
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:
(بما في ذلك رقم تعريف المكان وحقل
GMSPlaceFieldFormattedAddress)
خدمة ويب
- طلب الإكمال التلقائي للأماكن (input=”par”, session_token: XYZ)
- طلب الإكمال التلقائي للأماكن (input=”paris”, session_token: XYZ)
- تفاصيل الأماكن (place_id, session_token: XYZ, fields:formatted_address)
ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
- ميزة الإكمال التلقائي (مضمّنة في "تفاصيل المكان") - لكل جلسة (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
رمز التخزين التعريفي: ميزة "إكمال الطلب تلقائيًا" لكل طلب
يتم تحصيل رسوم رمز التخزين التعريفي إكمال طلبات البحث تلقائيًا - لكل طلب مقابل كل طلب من أجل:
- JavaScript: تشمل هذه الواجهة
خدمة الإكمال التلقائي للأماكن في Maps JavaScript API (
getQueryPredictions()) واستخدام العنصر المكوّن SearchBox في Maps JavaScript API (يتم توليد طلبات الإكمال التلقائي للطلبات أثناء كتابة المستخدم). - خدمة الويب: خدمة الإكمال التلقائي لطلبات البحث في Places API
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.00283 دولار أمريكي لكل (2.83 دولار أمريكي لكل 1,000) |
0.00227 دولار أمريكي لكل (2.27 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
لا تتوفّر ميزة تحديد الأسعار حسب جلسة الإكمال التلقائي باستخدام ميزة "إكمال الطلب تلقائيًا". يتم تحصيل رسوم عن المكالمات اللاحقة باستخدام "تفاصيل الأماكن" استنادًا إلى الأسعار العادية لميزة "تفاصيل الأماكن".
رمز التخزين التعريفي: تفاصيل المكان
يتم تحصيل رسوم المكالمات التي تشمل تفاصيل عن مكان العمل على النحو التالي:
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
يتم إنشاء رمز التخزين التعريفي تفاصيل المكان من واجهات برمجة التطبيقات التالية:
- Android: حزمة تطوير برامج "الأماكن" لأجهزة Android
(
fetchPlace()) - iOS: حزمة تطوير برامج "الأماكن" لأجهزة iOS
(
fetchPlaceFromPlaceID:) - JavaScript:
خدمة "تفاصيل الأماكن" في Maps JavaScript API (
getDetails) - JavaScript:
تطبيق مصغّر "إكمال تلقائي للأماكن" في Maps JavaScript API (
getPlace) - JavaScript:
أداة "مربّع البحث عن الأماكن" في Maps JavaScript API:
getPlaces()بعد أن يختار المستخدم نتيجة مكان (الرمز: دبوس)، *وليس* طلب بحث (الرمز: مكبّر)، كما هو موضّح هنا:
في نتائج أداة مربّع البحث، بعد كتابة "بيتزا" في مربّع بحث، يُرجى ملاحظة أنّ Pizza Autentico يظهر بجانبه رمز دبوس، ما يشير إلى أنّه هو نتيجة مكان (وليس طلب بحث). - خدمة الويب: خدمة "تفاصيل الأماكن" في Places API
باستخدام واجهة برمجة التطبيقات والخدمات على الويب، يتم تحصيل رسوم رمز التخزين التعريفي لتفاصيل المكان سواء تم تقديم رمز تعريف جلسة أم لا.
يؤدي طلب أو مكالمة بشأن تفاصيل المكان أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات (أساسية و/أو جهة اتصال و/أو جو المكان)، استنادًا إلى الحقول المحدّدة في الطلب أو المكالمة. في حال عدم تحديد حقول لا في طلب أو مكالمة "تفاصيل الأماكن"، يتم تنشيط جميع رموز التخزين التعريفية للبيانات، ويُحصَّل منك رسوم طلب أو مكالمة "تفاصيل الأماكن" بالإضافة إلى تكلفة جميع البيانات.
أمثلة
- يمكنك إجراء أحد هذه المكالمات أو الطلبات:
- الأجهزة الجوّالة: اتصل بالرقم
fetchPlace()على Android أوfetchPlaceFromPlaceID:على iOS، وحدِّد حقلADDRESSفقط. - Web API أو الخدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد حقل العنوان فقط:
getPlaceDetails(fields: formatted_address)
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
- الأجهزة الجوّالة: اتصل بالرقم
- يمكنك إجراء أحد هذه المكالمات أو الطلبات:
- الأجهزة الجوّالة: اتصل بالرقم
fetchPlace()على Android أوfetchPlaceFromPlaceID:على iOS، وحدِّد حقلPHONE_NUMBERفقط. - Web API أو الخدمة: يمكنك تقديم طلب للحصول على تفاصيل المكان وتحديد حقل رقم الهاتف:
getPlaceDetails(fields: formatted_phone_number)
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- الأجهزة الجوّالة: اتصل بالرقم
- يمكنك إجراء أحد هذه المكالمات أو الطلبات:
- الأجهزة الجوّالة: اتصل بالرقم
fetchPlace()على Android أوfetchPlaceFromPlaceID:على iOS، وحدِّد جميع الحقول. - Web API أو خدمة: يمكنك إرسال طلب للحصول على تفاصيل عن مكان معيّن وتحديد جميع الحقول (هذا النوع من
الطلبات هو الإعداد التلقائي في حال عدم تحديد أي حقول):
getPlaceDetails().
- تفاصيل المكان (يبدأ السعر من 0.017 دولار أمريكي لكل جلسة)
- البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)
- الأجهزة الجوّالة: اتصل بالرقم
رمز التخزين التعريفي: تفاصيل المكان - إعادة تحميل المعرّف
استخدِم طلب "تفاصيل المكان" من أجل إعادة تحميل أرقام تعريف الأماكن القديمة. تتوفّر هذه الأنواع من الطلبات بدون أي رسوم.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.00 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
مثال
قدِّم طلبًا للحصول على تفاصيل المكان مع تحديد حقل رقم تعريف المكان فقط:
getPlaceDetails(fields: place_id).
سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند
عرض فاتورتك حسب رمز التخزين التعريفي):
- تفاصيل المكان - إعادة تحميل رقم التعريف (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
رمز التخزين التعريفي: العثور على مكان
يتم تحصيل رسوم من Find Place مقابل طلب البحث عن مكان.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تُنشئ طلبات "العثور على مكان" أيضًا رموز التخزين التعريفية للبيانات (أساسية و/أو جهة اتصال و/أو جو)، استنادًا إلى الحقول المحدّدة في الطلب. مثل طلبات تفاصيل الأماكن، يمكنك استخدام مَعلمة fields في طلب البحث عن مكان لحصر الردّ على الحقول المحدّدة فقط. يتم تحصيل رسوم منك مقابل طلب "العثور على مكان" بالإضافة إلى البيانات المطلوبة. تلقائيًا، إذا تم طلب حقول NO، يتم عرض رقم تعريف المكان فقط، وبالتالي لا يتم تحصيل أي رسوم إضافية مقابل البيانات.
أمثلة
- يمكنك تقديم طلب "العثور على مكان" وتحديد حقل العنوان فقط:
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 دولار أمريكي | 0.00 دولار أمريكي | 0.00 دولار أمريكي |
مثال
يمكنك تقديم طلب "العثور على مكان" وتحديد حقل place_id فقط: FindPlace(fields: place_id).
سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند
عرض فاتورتك حسب رمز التخزين التعريفي):
- العثور على مكان: رقم التعريف فقط (يتم تحصيل رسوم بقيمة 0.00 دولار أمريكي)
رمز التخزين التعريفي: العثور على المكان الحالي
يتم تحصيل رسوم منك مقابل استخدام ميزة العثور على المكان الحالي عند إجراء مكالمات إلى findCurrentPlace() (Android)
أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.030 دولار أمريكي لكل (30.00 دولار أمريكي لكل 1,000) |
0.024 دولار أمريكي لكل (24.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تؤدي المكالمات إلى findCurrentPlace() (Android) أو
findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS)
أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات (Basic و/أوContact و/أو
Atmosphere)، استنادًا إلى الحقول المحدّدة في المكالمة.
حدِّد حقول البيانات لتقتصر الاستجابة على هذه الحقول فقط. يتم تحصيل رسوم منك مقابل مكالمة "العثور على مكانك الجغرافي الحالي" بالإضافة إلى البيانات المطلوبة.
أمثلة
- يمكنك الاتصال بـ
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 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: مكان – البحث في الأماكن القريبة
يتم تحصيل رسوم البحث عن الأماكن المجاورة مقابل الطلبات المرسَلة إلى
خدمة البحث عن الأماكن المجاورة في Maps JavaScript API
(nearbySearch())، أو إلى
خدمة البحث عن الأماكن المجاورة في Places API.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تعرض طلبات "البحث عن الأماكن المجاورة" قائمة بالأماكن، ولكن لا تتيح تحديد الحقول التي يتم عرضها. تعرِض طلبات "البحث عن الأماكن القريبة" مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث عن الأماكن القريبة بدءًا من 0.032 دولار أمريكي لكل طلب، بالإضافة إلى جميع رموز التخزين التعريفية لأنواع البيانات (البيانات الأساسية، بيانات الاتصال، وبيانات الغلاف الجوي).
مثال
عندما تطلب إجراء بحث بالقرب منك، مثل NearbySearch (San Francisco, 100 meters)
ستظهر لك رموز التخزين التعريفية هذه في فاتورتك (عند
عرض فاتورتك حسب رمز التخزين التعريفي):
- مكان: "بحث في الجوار" (يبدأ السعر من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: مكان - بحث نصي
يتم تحصيل رسوم البحث النصي عن الأماكن مقابل الطلبات المرسَلة إلى
خدمة البحث النصي عن الأماكن في Maps JavaScript API
(textSearch())، أو إلى
خدمة البحث النصي في Places API.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.032 دولار أمريكي لكل (32.00 دولار أمريكي لكل 1,000) |
0.0256 دولار أمريكي لكل (25.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
تعرِض طلبات البحث النصي قائمة بالأماكن، ولكن لا تتيح تحديد الحقول التي يتم عرضها. تعرض طلبات "البحث النصي" مجموعة فرعية من حقول البيانات المتوافقة. يتم تحصيل رسوم منك مقابل طلب البحث النصي بقيمة تبدأ من 0.032 ريال سعودي لكل طلب، بالإضافة إلى جميع رمزَي التخزين التعريفيَين لنوع البيانات (البيانات الأساسية وبيانات الاتصال وبيانات الغلاف الجوي).
يتم أيضًا إنشاء رمز التخزين التعريفي للبحث عن الأماكن باستخدام نص من خلال الرمز المبرمَج
لوحدة SearchBox الخاصة بـ "واجهة برمجة تطبيقات JavaScript لخرائط Google": getPlaces()
بعد أن يختار المستخدم طلب بحث عن مكان (الرمز: مكبّر)، وليس
نتيجة (الرمز: دبوس)، كما هو موضّح هنا:
مثال
يمكنك تقديم طلب بحث نصي، مثل TextSearch(123 Main Street). في فاتورتك،
ستظهر لك رموز التخزين التعريفية هذه (عند
عرض فاتورتك حسب رمز التخزين التعريفي):
- المكان: البحث النصي (يبدأ السعر من 0.032 دولار أمريكي لكل مكالمة)
- البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
- بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
- بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)
رمز التخزين التعريفي: صورة مكان
يتم تحصيل رسوم رمز التخزين التعريفي صورة مكان مقابل ما يلي:
- Android: المكالمات إلى
fetchPhoto() - iOS: طلبات الاتصال
loadPlacePhoto: - JavaScript: إلى Places Library،
خدمة "صور الأماكن" في واجهة برمجة تطبيقات JavaScript لخرائط Google عند طلب البيانات من عناوين URL التي يعرضها
PlacePhoto.getUrl()لتحميل بيانات وحدات البكسل للصورة - خدمة الويب: طلبات إلى Places API Place خدمة Photos API
بالنسبة إلى خدمة JavaScript، لا يؤدي استدعاء الطريقة PlacePhoto.getUrl()
إلى الفوترة إلى أن يتم استخدام عنوان URL فعليًا للحصول على بيانات وحدة البكسل.
| نطاق عدد المكالمات الشهرية (السعر لكل مكالمة) |
||
|---|---|---|
| 0.007 دولار أمريكي لكل (7.00 دولار أمريكي لكل 1,000) |
0.0056 دولار أمريكي لكل (5.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الترميز الجغرافي
يتم تحصيل رسوم رمز التخزين التعريفي ترميز المواقع الجغرافية مقابل الطلبات المرسَلة إلى خدمة ترميز المواقع الجغرافية في واجهة برمجة التطبيقات JavaScript لخرائط Google
أو إلى Geocoding API.
في JavaScript، تبدأ الطريقة
Geocoder.geocode() الطلب إلى خدمة ترميز المواقع الجغرافية.
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الموقع الجغرافي
يتم تحصيل رسوم رمز التخزين التعريفي الموقع الجغرافي مقابل الطلبات المرسَلة إلى Geolocation API.
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: Map Tiles API: 2D Map Tiles
طلب إلى Map Tiles API لاسترداد خرائط الطرق أو خرائط الأقمار الصناعية أو خرائط التضاريس يُرجى العلم أنّه لا يتم تحصيل رسوم مقابل طلبات الحصول على معلومات Session Token وViewport.
| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001 وأكثر | |||
| 0.0006 دولار أمريكي لكل (0.60 دولار أمريكي لكل 1,000) |
0.00048 دولار أمريكي لكل (0.48 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي: Map Tiles API: مربّعات في "التجوّل الافتراضي"
طلب موجَّه إلى Map Tiles API لاسترداد مربّعات "التجوّل الافتراضي" أو الصور المصغّرة لميزة "التجوّل الافتراضي" أو معرّفات PanoID لميزة "التجوّل الافتراضي" يُرجى العلم أنّه لا يتم تحصيل رسوم مقابل طلبات الحصول على Session Token و"البيانات الوصفية لميزة التجوّل الافتراضي".
| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0 - 1,000,000 | 1,000,001 - 5,000,000 | 5,000,001 وأكثر | |||
| 0.002 دولار أمريكي لكل (2.00 دولار أمريكي لكل 1,000) |
0.0016 دولار أمريكي لكل (1.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي: Map Tiles API: Photorealistic 3D Tiles
طلب موجَّه إلى Map Tiles API لاسترداد "الشرائح الأساسية" الثلاثية الأبعاد
| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0.006 دولار أمريكي لكل (6.00 دولار أمريكي لكل 1,000) |
0.0051 دولار أمريكي لكل (5.10 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي: المنطقة الزمنية
يتم تحصيل رسوم رمز التخزين التعريفي المنطقة الزمنية مقابل الطلبات المرسَلة إلى Time Zone API.
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الارتفاع
يتم تحصيل رسوم رمز التخزين التعريفي Elevation مقابل الطلبات المرسَلة إلى Maps JavaScript API لخدمات Elevation أو إلى Elevation API.
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: التحقّق من العنوان
طلب إلى validateAddress (باستخدام واجهة برمجة التطبيقات REST) وValidateAddress (باستخدام واجهة برمجة التطبيقات gRPC) من Address Validation API
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.017 دولار أمريكي لكل (17.00 دولار أمريكي لكل 1,000) |
0.0136 دولار أمريكي لكل (13.60 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رمز التخزين التعريفي: الخيار المفضّل لإثبات صحة العنوان
تعمل واجهة برمجة التطبيقات Address Validation Preferred مع نقطة نهاية Autocomplete (New) في Places API عند استخدامها مع الجلسات التي تنتهي بمحاولة طلب بيانات من Address Validation API. على وجه التحديد، تندرج ضمن نموذج الأسعار هذا الجلسات التي تستخدِم ميزة "الإكمال التلقائي (جديد)" وتنتهي إما بطلب validateAddress (REST) أو ValidateAddress (gRPC).
لمعرفة تفاصيل عن الأسعار واستخدام جلسات "الإكمال التلقائي (جديد)" مع Places API، يُرجى الاطّلاع على الأدلة التالية في مستندات Places API:
عند استخدام الخيار "التحقّق من صحة العنوان هو الخيار المفضّل" في نهاية جلسة "الإكمال التلقائي (جديد)"، يتم تحصيل الرسوم منك على النحو التالي:
| نطاق الحجم الشهري (السعر لكل طلب) |
||
|---|---|---|
| 0.025 دولار أمريكي لكل (25.00 دولار أمريكي لكل 1,000) |
0.020 دولار أمريكي لكل (20.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة |
رموز التخزين التعريفية للمنتجات في البيئة
تشمل واجهات برمجة التطبيقات في "البيئة" ما يلي: Air Quality API ، Pollen API، و Solar API.
رمز التخزين التعريفي: جودة الهواء
ينطبق رمز التخزين التعريفي هذا على نقاط النهاية والطُرق التالية:
| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
0.004 دولار أمريكي لكل (4.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي: حبوب اللقاح
ينطبق رمز التخزين التعريفي هذا على نقاط النهاية أو الطرق التالية:
| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.008 دولار أمريكي لكل (8.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي: Solar Building Insights
طلب موجَّه إلى buildingInsights
| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0.01 دولار أمريكي لكل (10.00 دولار أمريكي لكل 1,000) |
0.005 دولار أمريكي لكل (5.00 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي: طبقات بيانات الطاقة الشمسية
طلب dataLayers
إنّ الوصول إلى عناوين URL متعددة للصور من الطلب نفسه لا يؤدي إلى إنشاء طلبات بحث إضافية يتم تحصيل رسومها.| نطاق الحجم الشهري (السعر لكل طلب) |
|||||
|---|---|---|---|---|---|
| 0.075 دولار أمريكي لكل (75.00 دولار أمريكي لكل 1,000) |
0.0375 دولار أمريكي لكل (37.50 دولار أمريكي لكل 1,000) |
التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة | |||
رمز التخزين التعريفي للتنقّل
تشمل حِزم تطوير البرامج (SDK) للتنقّل ما يلي: حزمة تطوير البرامج للتنقّل على أجهزة Android و حزمة تطوير البرامج للتنقّل على أجهزة iOS.
رمز التخزين التعريفي: طلب التنقّل
يتمّ فوترة كلّ وجهة يتمّ طلبها باستخدام حزمة تطوير البرامج (SDK) لميزة التنقّل على أنّها وحدة طلب تنقّل رمز تخزين تعريفي. يتم تحديد سعر وحدة رمز التخزين التعريفي حسب إجمالي عدد المكالمات الشهرية لرمز التخزين التعريفي:
| نطاق الحجم الشهري (السعر لكل وجهة) |
||
|---|---|---|
| من 1 إلى 1,000 | من 1,001 إلى 4,200,000 | أكثر من 4,200,000 |
| بدون رسوم | 0.05 دولار أمريكي | 0.0395 دولار أمريكي |
طُرق طلب المسار
يمكن تقديم طلبات إنشاء المسارات إلى حزمة Navigation SDK من خلال استدعاء الطرق التالية:
Android
- setDestination (وجهة نقطة الطريق)
- setDestination (وجهة نقطة الطريق، خيارات RoutingOptions)
- setDestination (وجهة نقطة الطريق، RoutingOptions routingOptions، DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations)
- setDestinations (قائمة وجهات<Waypoint>، خيارات RoutingOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions)
- setDestinations (List<Waypoint> destinations, RoutingOptions routingOptions, DisplayOptions displayOptions)
- setDestinations (List<Waypoint> destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions)
- simulateLocationsAlongNewRoute(List<Waypoint> waypoints, RoutingOptions routingOptions, SimulationOptions simulationOptions)
- [مُسنَد] setDestinations (قائمة وجهات<Waypoint>، سلسلة routeToken)
iOS
يُرجى العِلم أنّ طلب إجراء طريقة واحدًا يمكن أن يحتوي على ما يصل إلى 25 وجهة، ويتم احتساب تكلفة كل طلب من خلال ضرب عدد الوجهات في السعر لكل وحدة رمز تخزين تعريفي.