تسعير Google Maps Platform

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

لكل رمز تخزين تعريفي مُدرَج، ستظهر لك المعلومات التالية:

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

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

جدول المنتجات أو رموز التخزين التعريفية في "منصة Google للتسويق"

المنتجرموز التخزين التعريفية
الاتجاهات رمز التخزين التعريفي: الاتجاهات، رمز التخزين التعريفي: الاتجاهات المتقدّمة
Distance Matrix رمز التخزين التعريفي: Distance Matrix، رمز التخزين التعريفي: Distance Matrix Advanced
الارتفاع رمز التخزين التعريفي: الارتفاع
الترميز الجغرافي رمز التخزين التعريفي: الترميز الجغرافي
الموقع الجغرافي رمز التخزين التعريفي: الموقع الجغرافي
Map Tiles API رمز التخزين التعريفي: مربّعات الخريطة ثنائية الأبعاد، رمز التخزين التعريفي: مربّعات "التجوّل الافتراضي"، رمز التخزين التعريفي: مربّعات ثلاثية الأبعاد لصور واقعية
Maps Embed رمز التخزين التعريفي: التضمين، رمز التخزين التعريفي: التضمين المتقدّم
Maps JavaScript API رمز التخزين التعريفي: "خرائط Google" الديناميكية، رمز التخزين التعريفي: "التجوّل الافتراضي" الديناميكي
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android رمز التخزين التعريفي: خرائط ديناميكية أصلية للأجهزة الجوّالة، رمز التخزين التعريفي: التجوّل الافتراضي الديناميكي، رمز التخزين التعريفي: الخرائط الديناميكية
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS رمز التخزين التعريفي: خرائط ديناميكية أصلية للأجهزة الجوّالة، رمز التخزين التعريفي: التجوّل الافتراضي الديناميكي، رمز التخزين التعريفي: الخرائط الديناميكية
Maps Static رمز التخزين التعريفي: خرائط ثابتة
Maps Aerial View API رمز التخزين التعريفي: Aerial View API
حزمة تطوير البرامج للتنقّل على أجهزة Android طلب التنقّل
حزمة تطوير البرامج للتنقّل على أجهزة iOS طلب التنقّل
‫Places API (جديدة) SKU: طلبات الإكمال التلقائي، SKU: استخدام جلسة الإكمال التلقائي، SKU: تفاصيل المكان (المعرّفات فقط)، SKU: تفاصيل المكان (الموقع الجغرافي فقط)، SKU: تفاصيل المكان (أساسية)، SKU: تفاصيل المكان (متقدّمة)، SKU: تفاصيل المكان (المفضّلة)، SKU: البحث عن الأماكن المجاورة (أساسي)، SKU: البحث عن الأماكن المجاورة (متقدّم)، SKU: البحث عن الأماكن المجاورة (المفضّل)، SKU: البحث النصي (المعرّف فقط)، SKU: البحث النصي (أساسي)، SKU: البحث النصي (متقدّم)، SKU: البحث النصي (المفضّل)، SKU: صورة المكان
واجهة برمجة تطبيقات الأماكن رمز التخزين التعريفي: طلب التحقّق من العنوان، رمز التخزين التعريفي: الخيار المفضّل للتحقّق من العنوان، رمز التخزين التعريفي: بيانات الغلاف الجوي، رمز التخزين التعريفي: الإكمال التلقائي - لكل طلب، رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل الأماكن) - لكل جلسة، رمز التخزين التعريفي: الإكمال التلقائي (بدون تفاصيل الأماكن) - لكل جلسة، رمز التخزين التعريفي: البيانات الأساسية، رمز التخزين التعريفي: بيانات الاتّصال، رمز التخزين التعريفي: العثور على مكان، رمز التخزين التعريفي: العثور على مكان - رقم التعريف فقط، رمز التخزين التعريفي: الأماكن - البحث عن الأماكن المجاورة، رمز التخزين التعريفي: الأماكن - البحث النصي، رمز التخزين التعريفي - تفاصيل الأماكن، رمز التخزين التعريفي - تفاصيل الأماكن - إعادة تحميل رقم التعريف، رمز التخزين التعريفي: صورة الأماكن، ورمز التخزين التعريفي: الإكمال التلقائي للطلبات - لكل طلب
حزمة تطوير برامج الأماكن لأجهزة Android رمز التخزين التعريفي: بيانات الغلاف الجوي ورمز التخزين التعريفي: الإكمال التلقائي لكل طلب، رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل الأماكن) لكل جلسة، رمز التخزين التعريفي: الإكمال التلقائي (بدون تفاصيل الأماكن) لكل جلسة، رمز التخزين التعريفي: البيانات الأساسية ورمز التخزين التعريفي: بيانات الاتصال، رمز التخزين التعريفي: العثور على المكان الحالي ورمز التخزين التعريفي: صورة المكان
حزمة تطوير برامج الأماكن لأجهزة iOS رمز التخزين التعريفي: بيانات الغلاف الجوي ورمز التخزين التعريفي: الإكمال التلقائي لكل طلب، رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) لكل جلسة، رمز التخزين التعريفي: الإكمال التلقائي (بدون تفاصيل المكان) لكل جلسة، رمز التخزين التعريفي: البيانات الأساسية ورمز التخزين التعريفي: بيانات الاتصال، رمز التخزين التعريفي: العثور على المكان الحالي ورمز التخزين التعريفي: صورة المكان
الطرق رمز التخزين التعريفي: الطرق - أقرب طريق، رمز التخزين التعريفي: الطرق - المسار الذي تم سلوكه، رمز التخزين التعريفي: الطرق - حدود السرعة
تحسين المسار رمز التخزين التعريفي: تحسين المسار: توجيه مركبة واحدة، رمز التخزين التعريفي: تحسين المسار: توجيه أسطول المركبات
المسارات رمز التخزين التعريفي: المسارات: احتساب المسارات - المستوى الأساسي، رمز التخزين التعريفي: المسارات: احتساب المسارات - المستوى المتقدّم، رمز التخزين التعريفي: المسارات: احتساب المسارات - المستوى المفضّل، رمز التخزين التعريفي: المسارات: احتساب مصفوفة المسارات - المستوى الأساسي، رمز التخزين التعريفي: المسارات: احتساب مصفوفة المسارات - المستوى المتقدّم، رمز التخزين التعريفي: المسارات: احتساب مصفوفة المسارات - المستوى المفضّل
التجوّل الافتراضي رمز التخزين التعريفي: Street View Static API
المنطقة الزمنية رمز التخزين التعريفي: المنطقة الزمنية
جودة الهواء رمز التخزين التعريفي: استخدام أداة "جودة الهواء"
لقَاح رمز التخزين التعريفي: Pollen
الطاقة الشمسية رمز التخزين التعريفي: Solar API Building Insights، رمز التخزين التعريفي: Solar API Data Layers

رموز التخزين التعريفية للمنتجات في "خرائط Google"

تشمل واجهات برمجة التطبيقات في "خرائط Google": حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android، حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS، واجهة برمجة التطبيقات JavaScript API لتطبيق "خرائط Google"، واجهة برمجة التطبيقات Static API لتطبيق "خرائط Google"، واجهة برمجة التطبيقات Static API لميزة "التجوّل الافتراضي"، واجهة برمجة التطبيقات Embed API لتطبيق "خرائط Google".

رمز التخزين التعريفي: خرائط ثابتة أصلية للأجهزة الجوّالة

يتضمّن عنصرًا من خرائط Google في الوضع البسيط، لم يتم تحميله بمعرّف خريطة، في تطبيق جوّال يستخدم حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android.

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

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

رمز التخزين التعريفي: خرائط ديناميكية مدمجة مع المحتوى للأجهزة الجوّالة

عنصر من "خرائط Google" لم يتم تحميله باستخدام معرّف خريطة، في تطبيق متوافق مع حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS

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

يتم تحميل خريطة واحدة لكل عملية إنشاء لعنصر خريطة Google في تطبيق متوافق مع حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS:

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

SKU: تضمين وSKU: تضمين متقدّم

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

رمز التخزين التعريفي: الخرائط الثابتة

طلب موجَّه إلى Maps Static API

نطاق الحجم الشهري
(السعر لكل تحميل خريطة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.002 دولار أمريكي لكل
(2.00 دولار أمريكي لكل 1,000)		 ‫0.0016 دولار أمريكي لكل
(1.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

تطبيق يعرض خريطة تم تحميلها باستخدام معرّف خريطة أو بدونه باستخدام واجهة برمجة تطبيقات JavaScript للخرائط، أو خريطة تم تحميلها باستخدام معرّف خريطة وباستخدام إما حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS

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

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

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

يتم الآن تحصيل رسوم منفصلة مقابل تحميل الخرائط والصور البانورامية في "التجوّل الافتراضي". يتم تحصيل رسوم مقابل كل طلب يتم إرساله إلى Street View Static API بهدف تضمين بانوراما ثابتة (غير تفاعلية) في "التجوّل الافتراضي". لا يتم تحصيل رسوم مقابل استخدام نقطة نهاية البيانات الوصفية لصور "التجوّل الافتراضي".

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

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

يتم الآن تحصيل رسوم منفصلة مقابل تحميل الخرائط والصور البانورامية في "التجوّل الافتراضي". يتم تحصيل رسوم منك مقابل كلّ إنشاء لعنصر بانوراما في تطبيق Maps JavaScript API أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS.

نطاق الحجم الشهري
(السعر لكل بانوراما)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.014 دولار أمريكي لكل
(14.00 دولار أمريكي لكل 1,000)		 ‫0.0112 دولار أمريكي لكل
(11.20 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

تحدث عملية إنشاء مثيل لكائن بانوراما:

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

طلب موجَّه إلى Aerial View API يعرض عنوان URL لفيديو من الجو

نطاق الحجم الشهري
(السعر لكل طلب lookupVideo ناجح)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: مسار الاتجاهات المتقدّم

طلب موجَّه إلى خدمة "الاتجاهات" في واجهة برمجة التطبيقات JavaScript API لخرائط Google أو Directions API يستخدم معلومات عدد الزيارات وأكثر من 10 نقاط اتّجاه و/أو تحسين نقاط الالتفاف و/أو عوامل تعديل الموقع الجغرافي

نطاق الحجم الشهري
(السعر لكل طلب بحث)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.008 دولار أمريكي لكل
(8.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم لميزة "الاتجاهات" مقابل طلبات خدمة 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|...
  • أكثر من 10 نقاط طريق (بين 11 و25)
  • تحسين نقاط التوقف يتم ضبط المَعلمة optimize على true لنقاط التوقف. على سبيل المثال، 
    &waypoints=optimize:true|San Francisco|Mountain View|...
  • معدّلات المواقع الجغرافية: عند استخدام مُعدِّلات الموقع الجغرافي التالية للإشارة إلى كيفية اقتراب السائقين من موقع جغرافي معيّن:
    • side_of_road
    • heading

رمز التخزين التعريفي: Distance Matrix

طلب موجَّه إلى Distance Matrix API أو خدمة Distance Matrix في واجهة برمجة التطبيقات JavaScript لخرائط Google (يستبعد الطلبات التي تؤدي إلى رمز التخزين التعريفي للفوترة في Distance Matrix Advanced).

نطاق الحجم الشهري
(السعر لكل عنصر)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 على الوقت الحالي أو وقت في المستقبل. لا يمكن أن يكون في الماضي.
  • معدّلات المواقع الجغرافية: عند استخدام مُعدِّلات الموقع الجغرافي التالية للإشارة إلى كيفية اقتراب السائقين من موقع جغرافي معيّن:
    • side_of_road
    • heading

رمز التخزين التعريفي: الطرق - المسار الذي تمّ قطعه

طلب إلى خدمة المحاذاة إلى الطرق في Roads API

نطاق الحجم الشهري
(السعر لكل طلب بحث)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.008 دولار أمريكي لكل
(8.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

طلب إلى خدمة Nearest Roads في Roads API

نطاق الحجم الشهري
(السعر لكل طلب بحث)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.008 دولار أمريكي لكل
(8.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: الطرق - حدود السرعة

طلب إلى خدمة Speed Limits في Roads API
نطاق الحجم الشهري
(السعر لكل عنصر)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.02 دولار أمريكي لكل
(20.00 دولار أمريكي لكل 1,000)		 ‫0.016 دولار أمريكي لكل
(16.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

طلب حساب المسارات

نطاق الحجم الشهري
السعر لكل طلب بحث
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: المسارات: احتساب المسارات - متقدم

طلب للحصول على مسارات حسابية تستخدِم ميزات متقدّمة

نطاق الحجم الشهري
السعر لكل طلب بحث
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.008 دولار أمريكي لكل
(8.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

  • من 11 إلى 25 نقطة مسار وسيطة
  • المسار الأمثل المراعي لحركة المرور تتوافق خيارات التوجيه هذه مع ضبط سمة routingPreference في الطلب على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL.
  • معدّلات المواقع الجغرافية: عند استخدام الخيارات التالية للإشارة إلى كيفية اقترارب السائقين من موقع جغرافي معيّن:

رمز التخزين التعريفي: المسارات: مسارات الحوسبة - المفضّلة

طلب لتحديد مسارات الحساب التي تستخدِم الميزات المفضّلة

نطاق الحجم الشهري
السعر لكل طلب بحث
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.015 دولار أمريكي لكل
(15.00 دولار أمريكي لكل 1,000)		 ‫0.012 دولار أمريكي لكل
(12.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

يتم تحصيل رسوم رمز التخزين التعريفي المفضّل مقابل طلب Compute Routes الذي يستخدم واحدة أو أكثر من الميزات التالية:

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

طلب للقيام بحساب مصفوفة المسارات

نطاق الحجم الشهري
السعر لكل عنصر
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

طلب لحساب مصفوفة المسارات يستخدِم ميزات متقدّمة

نطاق الحجم الشهري
السعر لكل عنصر
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.008 دولار أمريكي لكل
(8.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

يتم تحصيل رسوم رمز التخزين التعريفي المتقدّم مقابل طلب Compute Route Matrix يستخدم واحدة أو أكثر من الميزات التالية:

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

رمز التخزين التعريفي: المسارات: حساب مصفوفة المسارات - المفضّلة

طلب لحساب مصفوفة المسارات باستخدام الميزات المفضّلة

نطاق الحجم الشهري
السعر لكل عنصر
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.015 دولار أمريكي لكل
(15.00 دولار أمريكي لكل 1,000)		 ‫0.012 دولار أمريكي لكل
(12.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

يتم تحصيل رسوم رمز التخزين التعريفي المفضّل مقابل طلب Compute Route Matrix يستخدم واحدة أو أكثر من الميزات التالية:

رمز التخزين التعريفي: تحسين المسار: توجيه مركبة واحدة

طلب موجَّه إلى Route Optimization API يحدِّد مركبة واحدة بالضبط

نطاق الحجم الشهري
(السعر لكل شحنة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.01 دولار أمريكي لكل
(10.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: تحسين المسار: توجيه الأسطول

طلب موجَّه إلى Route Optimization API يحدِّد أكثر من مركبة واحدة

نطاق الحجم الشهري
(السعر لكل شحنة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.03 دولار أمريكي لكل
(30.00 دولار أمريكي لكل 1,000)		 ‫0.014 دولار أمريكي لكل
(14.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رموز التخزين التعريفية للمنتجات في "الأماكن" (الإصدار الجديد)

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

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

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

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

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

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

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

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

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

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

يتم تحصيل الرسوم أيضًا في حال استخدام الرموز المميّزة للجلسات وتنفيذ أيّ مما يلي:

  • يمكنك إنهاء الجلسات من خلال طلب واحد إلى "تفاصيل المكان" (جديد) يطلب أي حقول محدّدة من خلال رمز التخزين التعريفي: تفاصيل المكان (الموقع الجغرافي فقط).
    • يتم تحصيل رسوم كل طلب من طلبات "الإكمال التلقائي (جديد)"، بما يصل إلى 12 طلبًا، باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
    • يتمّ تحصيل رسوم كلّ طلب لاحق من طلبات "الإكمال التلقائي" (جديد) باستخدام رمز التخزين التعريفي: استخدام جلسة "الإكمال التلقائي".
  • يمكنك التخلي عن الجلسة أو إنهائها من خلال إجراء مكالمة إلى رمز التخزين التعريفي: تفاصيل المكان (أرقام التعريف فقط). بعد ذلك، يتمّ تحصيل رسوم منك مقابل كلّ طلبات "الإكمال التلقائي (جديد)" باستخدام رمز التخزين التعريفي: طلبات الإكمال التلقائي.
نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1,000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

يتم تحصيل رسوم رمز التخزين التعريفي هذا في السيناريوهات التالية:

  • تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى SKU: تفاصيل المكان (الموقع الجغرافي فقط):

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

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

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

  • تم إنهاء جلسة الإكمال التلقائي من خلال طلب إلى SKU: Address Validation Preferred.

لمزيد من المعلومات، يُرجى الاطّلاع على الميزة التلقائية (الجديدة) وأسعار الجلسات.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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، وMaps JavaScript API: id
photos

iOS: GMSPlacePropertyPlaceID
GMSPlacePropertyPhotos

خدمة الويب: attributions
id
name*
photos

* يحتوي الحقل name على اسم المورد في الشكل: places/PLACE_ID. استخدِم displayName للوصول إلى الاسم النصي للمكان.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 لتطبيق "خرائط Google": accessibilityOptions
businessStatus
displayName
googleMapsUri
iconBackgroundColor
primaryTypeDisplayName
svgIconMaskURI
types
utcOffsetMinutes

iOS: GMSPlacePropertyBusinessStatus
GMSPlacePropertyIconBackgroundColor
GMSPlacePropertyIconImageURL
GMSPlacePropertyName
GMSPlacePropertyUTCOffsetMinutes
GMSPlacePropertyWheelchairAccessibleEntrance

خدمة الويب: accessibilityOptions
businessStatus
containingPlaces
displayName
googleMapsLinks*
googleMapsUri
iconBackgroundColor
iconMaskBaseUri
primaryType
primaryTypeDisplayName
pureServiceAreaBusiness
subDestinations
utcOffsetMinutes

* يُرجى العِلم أنّ الحقل googleMapsLinks في مرحلة معاينة الإصدار العلني ولا يتم تحصيل أي رسوم، أي أنّ الفوترة هي 0 دولار أمريكي مقابل الاستخدام أثناء مرحلة المعاينة.

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

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
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 لتطبيق "خرائط 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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 لتطبيق "خرائط Google": internationalPhoneNumber
nationalPhoneNumber
priceLevel
rating
regularOpeningHours
userRatingCount
websiteUri

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.040 دولار أمريكي لكل
(40.00 دولار أمريكي لكل 1,000)		 ‫0.032 دولار أمريكي لكل
(32.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 Details.

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

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

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

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

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

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

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

  • 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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب ميزة "الأماكن"
+ 0.00 دولار أمريكي		 تكلفة طلب ميزة "الأماكن"
+ 0.00 دولار أمريكي		 تكلفة طلب ميزة "الأماكن"
+ 0.00 دولار أمريكي

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

باستخدام مَعلمة fields في طلب "تفاصيل المكان" أو "العثور على مكان" لخدمات الويب، أو صفيف من 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_number international_phone_number أو opening_hours current_opening_hours أو secondary_opening_hours website
نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب أماكن
+ 0.003 دولار أمريكي لكل مكان
(+ 3.00 دولار أمريكي لكل 1,000 مكان)		 تكلفة طلب أماكن
+ 0.0024 دولار أمريكي لكل طلب
(+ 2.40 دولار أمريكي لكل 1,000 طلب)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

باستخدام مَعلمة 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 وGMSPlaceFieldRating GMSPlaceFieldUserRatingsTotal وGMSPlaceFieldTakeout وGMSPlaceFieldDelivery وGMSPlaceFieldDineIn وGMSPlaceFieldCurbsidePickup GMSPlaceFieldReservable وGMSPlaceFieldServesBreakfast وGMSPlaceFieldServesLunch وGMSPlaceFieldServesDinner وGMSPlaceFieldServesBeer GMSPlaceFieldServesWine أو GMSPlaceFieldServesBrunch أو GMSPlaceFieldServesVegetarianFood
  • JavaScript: راجِع الحقول (تفاصيل المكان).
  • خدمة ويب: curbside_pickup أو delivery أو dine_in أو editorial_summary أو price_level أو rating أو reservable أو reviews أو serves_beer أو serves_breakfast أو serves_brunch أو serves_dinner أو serves_lunch أو serves_vegetarian_food أو serves_wine أو takeout أو user_ratings_total
نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
تكلفة طلب أماكن
+ 0.005 دولار أمريكي لكل مكان
(+ 5.00 دولار أمريكي لكل 1,000 مكان)		 تكلفة طلب أماكن
+ 0.004 دولار أمريكي لكل طلب
(+ 4.00 دولار أمريكي لكل 1,000 طلب)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

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

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1,000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

نطاق الحجم الشهري
(السعر لكل جلسة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.017 دولار أمريكي لكل
(17.00 دولار أمريكي لكل 1,000)		 ‫0.0136 دولار أمريكي لكل
(13.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

مثال

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

Android

iOS

خدمة ويب

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

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

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

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

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

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

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

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

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

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

مثال

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

Android

iOS

خدمة ويب

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

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

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

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

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.00283 دولار أمريكي لكل
(2.83 دولار أمريكي لكل 1,000)		 ‫0.00227 دولار أمريكي لكل
(2.27 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

يتم تحصيل رسوم المكالمات إلى "تفاصيل الأماكن" على النحو التالي:

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.017 دولار أمريكي لكل
(17.00 دولار أمريكي لكل 1,000)		 ‫0.0136 دولار أمريكي لكل
(13.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

أمثلة

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

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

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

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

مثال

قدِّم طلبًا للحصول على تفاصيل المكان مع تحديد حقل رقم تعريف المكان فقط: getPlaceDetails(fields: place_id). سيظهر لك رمز التخزين التعريفي هذا في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):

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

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

يتم تحصيل رسوم من البحث عن مكان مقابل طلب البحث عن مكان.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.017 دولار أمريكي لكل
(17.00 دولار أمريكي لكل 1,000)		 ‫0.0136 دولار أمريكي لكل
(13.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

أمثلة

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

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

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

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

مثال

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

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

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

يتم تحصيل رسوم منك مقابل استخدام ميزة العثور على المكان الحالي عند إجراء مكالمات إلى findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS).

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.030 دولار أمريكي لكل
(30.00 دولار أمريكي لكل 1,000)		 ‫0.024 دولار أمريكي لكل
(24.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

تؤدي المكالمات إلى findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) أيضًا إلى إنشاء رموز التخزين التعريفية للبيانات (Basic و/أو Contact و/أو Atmosphere)، استنادًا إلى الحقول المحدّدة في المكالمة. حدِّد حقول البيانات لتقتصر الاستجابة على هذه الحقول فقط. يتم تحصيل رسوم منك مقابل مكالمة "العثور على مكانك الجغرافي الحالي" بالإضافة إلى البيانات المطلوبة.

أمثلة

  1. يمكنك الاتصال بـ findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد حقل ADDRESS فقط. ستظهر لك رموز التخزين التعريفية التالية في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • العثور على المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
    • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
  2. يمكنك الاتصال بـ findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد الحقل PHONE_NUMBER. ستظهر لك رموز التخزين التعريفية التالية في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • العثور على المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
  3. يمكنك الاتصال بـ findCurrentPlace() (Android) أو findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (iOS) وتحديد الحقول من جميع حِزم أنواع البيانات الثلاثة. ستظهر لك رموز التخزين التعريفية التالية في فاتورتك (عند عرض فاتورتك حسب رمز التخزين التعريفي):
    • العثور على المكان الحالي (السعر يبدأ من 0.030 دولار أمريكي لكل طلب)
    • البيانات الأساسية (يتم تحصيل رسوم قدرها 0.00 دولار أمريكي)
    • بيانات الاتصال (يبدأ السعر من 0.003 دولار أمريكي لكل طلب)
    • بيانات الغلاف الجوي (يبدأ السعر من 0.005 دولار أمريكي لكل طلب)

يتم تحصيل رسوم من الأماكن - البحث عن الأماكن القريبة مقابل الطلبات المرسَلة إلى خدمة البحث عن الأماكن القريبة في Maps JavaScript API (nearbySearch())، أو إلى خدمة البحث عن الأماكن القريبة في Places API.

نطاق عدد المكالمات الشهرية
(السعر لكل مكالمة)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.032 دولار أمريكي لكل
(32.00 دولار أمريكي لكل 1,000)		 ‫0.0256 دولار أمريكي لكل
(25.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

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

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

مثال

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

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

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

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

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

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

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

يتم تحصيل رسوم رمز التخزين التعريفي ترميز المواقع الجغرافية مقابل الطلبات المرسَلة إلى خدمة ترميز المواقع الجغرافية في واجهة برمجة التطبيقات JavaScript لخرائط Google أو إلى Geocoding API. في JavaScript، تبدأ الطريقة Geocoder.geocode() الطلب إلى خدمة ترميز المواقع الجغرافية.

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم تحصيل رسوم رمز التخزين التعريفي الموقع الجغرافي مقابل الطلبات المرسَلة إلى Geolocation API.

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫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 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.006 دولار أمريكي لكل
(6.00 دولار أمريكي لكل 1,000)		 ‫0.0051 دولار أمريكي لكل
(5.10 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: المنطقة الزمنية

يتم تحصيل رسوم رمز التخزين التعريفي المنطقة الزمنية مقابل الطلبات المرسَلة إلى Time Zone API.

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

يتم تحصيل رسوم رمز التخزين التعريفي Elevation مقابل الطلبات المرسَلة إلى Maps JavaScript API لخدمات Elevation أو إلى Elevation API.

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.005 دولار أمريكي لكل
(5.00 دولار أمريكي لكل 1,000)		 ‫0.004 دولار أمريكي لكل
(4.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: طلب إثبات صحة العنوان

طلب إلى validateAddress (باستخدام واجهة برمجة التطبيقات REST) وValidateAddress (باستخدام واجهة برمجة التطبيقات gRPC) من Address Validation API

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.017 دولار أمريكي لكل
(17.00 دولار أمريكي لكل 1,000)		 ‫0.0136 دولار أمريكي لكل
(13.60 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رمز التخزين التعريفي: الخيار المفضّل لإثبات صحة العنوان

تعمل واجهة برمجة التطبيقات Address Validation Preferred مع نقطة نهاية الإكمال التلقائي (جديد) في Places API عند استخدامها مع الجلسات التي تنتهي بمحاولة إرسال طلب إلى Address Validation API. على وجه التحديد، تندرج ضمن نموذج الأسعار هذا الجلسات التي تستخدِم ميزة "الإكمال التلقائي (جديد)" وتنتهي إما بطلب validateAddress (REST) أو ValidateAddress (gRPC).

لمعرفة تفاصيل عن الأسعار واستخدام جلسات "الإكمال التلقائي (جديد)" مع Places API، يُرجى الاطّلاع على الأدلة التالية في مستندات Places API:

عند استخدام الخيار "التحقّق من صحة العنوان هو الخيار المفضّل" في نهاية جلسة "الإكمال التلقائي (جديد)"، يتم تحصيل الرسوم منك على النحو التالي:

نطاق الحجم الشهري
(السعر لكل طلب)
0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
‫0.025 دولار أمريكي لكل
(25.00 دولار أمريكي لكل 1,000)		 ‫0.020 دولار أمريكي لكل
(20.00 دولار أمريكي لكل 1,000)		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

رموز التخزين التعريفية للمنتجات في البيئة

تشمل واجهات برمجة التطبيقات في "البيئة" ما يلي: Air Quality API ، Pollen API، و Solar API.

رمز التخزين التعريفي: استخدام جودة الهواء

ينطبق رمز التخزين التعريفي هذا على نقاط النهاية والطُرق التالية:

  • currentConditions
  • السجلّ (لكل صفحة)
  • heatmapTiles
  • التوقّعات (لكل صفحة)

    • نطاق الحجم الشهري
    (السعر لكل طلب)
    0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
    ‫0.005 دولار أمريكي لكل
    (5.00 دولار أمريكي لكل 1,000)    		 ‫0.004 دولار أمريكي لكل
    (4.00 دولار أمريكي لكل 1,000)    		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

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

    ينطبق رمز التخزين التعريفي هذا على نقاط النهاية أو الطرق التالية:

  • التوقّعات
  • heatmapTiles

    • نطاق الحجم الشهري
    (السعر لكل طلب)
    0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
    ‫0.01 دولار أمريكي لكل
    (10.00 دولار أمريكي لكل 1,000)    		 ‫0.008 دولار أمريكي لكل
    (8.00 دولار أمريكي لكل 1,000)    		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

    رمز التخزين التعريفي: Solar API Building Insights

    طلب موجَّه إلى buildingInsights

    نطاق الحجم الشهري
    (السعر لكل طلب)
    0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
    ‫0.01 دولار أمريكي لكل
    (10.00 دولار أمريكي لكل 1,000)    		 ‫0.005 دولار أمريكي لكل
    (5.00 دولار أمريكي لكل 1,000)    		 التواصل مع فريق المبيعات لمعرفة أسعار الكميات الكبيرة

    رمز التخزين التعريفي: طبقات بيانات Solar API

    طلب لشدَّدdataLayers

    إنّ الوصول إلى عناوين URL متعددة للصور من الطلب نفسه لا يؤدي إلى إنشاء طلبات بحث إضافية يتم تحصيل رسومها.
    نطاق الحجم الشهري
    (السعر لكل طلب)
    0 إلى 100,000 من 100,001 إلى 500,000 أكثر من 500,000
    ‫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

    iOS

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