أسعار Google Places API: الحقول والتكلفة في 2026

تعتمد تكلفة Google Places API على نقطة النهاية، وعلى أعلى SKU تشغله الحقول التي تطلبها، وعلى حجم الاستخدام الشهري. قد ينقل حقل واحد مرتفع السعر الطلب كله إلى مستوى أغلى. لذلك لا يكفي عد الطلبات وحده لبناء ميزانية دقيقة.

راجعنا الأسعار العالمية وتصنيف الحقول في وثائق Google الرسمية يوم 13 أغسطس 2026. يمكن أن تتغير الأسعار، وقد تختلف بعض الشروط حسب المنطقة. تحقق من جدول أسعار Google Maps Platform قبل اعتماد أي ميزانية أو إطلاق حمل كبير.

ما الذي يحدد الفاتورة؟

تقيس Google الاستخدام بأحداث قابلة للفوترة. تعرض الأسعار بالدولار الأمريكي لكل 1,000 حدث. يصل النظام إلى سعر الطلب عبر ثلاث خطوات:

1. تحدد نقطة النهاية عائلة SKU الممكنة.
2. يحدد أغلى حقل في قناع الاستجابة مستوى الطلب كله.
3. يحدد مجموع أحداث هذا SKU خلال الشهر الحد المجاني وشريحة الحجم.

تعيد Place Details معلومات عن مكان معروف، ولهذا تحتاج إلى place ID. تبحث Text Search عن أماكن تطابق عبارة مكتوبة. تبحث Nearby Search في محيط موقع جغرافي. قد ينتمي الحقل نفسه إلى مستوى مختلف عند استخدامه مع نقطة نهاية أخرى.

لهذا لا تتساوى عمليتا Text Search لمجرد أن كل واحدة منهما طلب HTTP واحد. طلب المعرفات فقط ليس مثل طلب الاسم والهاتف والموقع الإلكتروني والتقييم والمراجعات.

الأسعار العالمية في 13 أغسطس 2026

تعرض الجداول التالية السعر في أول شريحة مدفوعة حتى 100,000 حدث شهري. السعر هو تكلفة 1,000 حدث بعد طرح الحد الشهري المجاني.

Place Details (New)

SKU	الحد المجاني الشهري	السعر لكل 1,000 بعد الحد
Essentials (IDs Only)	غير محدود	$0
Essentials	10,000	$5
Pro	5,000	$17
Enterprise	1,000	$20
Enterprise + Atmosphere	1,000	$25

Text Search (New)

SKU	الحد المجاني الشهري	السعر لكل 1,000 بعد الحد
Essentials (IDs Only)	غير محدود	$0
Pro	5,000	$32
Enterprise	1,000	$35
Enterprise + Atmosphere	1,000	$40

Nearby Search (New)

SKU	الحد المجاني الشهري	السعر لكل 1,000 بعد الحد
Pro	5,000	$32
Enterprise	1,000	$35
Enterprise + Atmosphere	1,000	$40

تجمع Google كل شهر الاستخدام الخاضع للفوترة عبر المشاريع المرتبطة بحساب الفوترة نفسه. لا تفترض أن إنشاء مشروع جديد يمنحك حدا مجانيا جديدا. بعد تجاوز 100,000 حدث شهري تدخل شرائح أخرى بأسعار مختلفة لكل ألف. استخدم كل الشرائح في الجدول الرسمي عند تقدير مشروع كبير.

أعلى حقل هو الذي يحاسب الطلب

يبين جدول حقول Places الرسمي مستوى SKU لكل خاصية في Place Details وText Search وNearby Search. راجع صف الحقل قبل إضافته إلى استجابة الإنتاج.

توضح الأمثلة التالية الفكرة:

• يمكن أن يبقى id وname ضمن IDs Only في Place Details وText Search. لا يعني name هنا اسم النشاط الظاهر للإنسان. إنه اسم المورد على صورة places/PLACE_ID.
• يأتي اسم المكان المقروء من displayName. يشغل هذا الحقل مستوى Pro في Text Search وNearby Search.
• يشغل formattedAddress مستوى Pro أيضا في هاتين الخدمتين. أما في Place Details فيقع ضمن Essentials.
• تشغل الحقول nationalPhoneNumber وinternationalPhoneNumber وwebsiteUri وrating وuserRatingCount مستوى Enterprise.
• يشغل الحقل reviews مستوى Enterprise + Atmosphere.

افترض أن طلب Text Search يحتوي على places.id وplaces.displayName وplaces.rating. يقع المعرف في مستوى منخفض، والاسم الظاهر في Pro، والتقييم في Enterprise. يحاسب الطلب كله بوصفه Text Search Enterprise لأن التقييم هو الحقل الأعلى.

إذا لم تعرض واجهتك التقييم، يمكنك إزالة rating وقد يبقى الطلب في Pro. وإذا احتجت إلى المعرفات فقط، فقد تستخدم Text Search Essentials (IDs Only). لا تحذف حقلا ضروريا إذا كنت ستطلق طلبا ثانيا للحصول عليه. احسب تكلفة رحلة المستخدم كاملة.

كتابة قناع حقول واضح

تتطلب Places API (New) قناع استجابة في Place Details وText Search وNearby Search. يمكنك تمريره في ترويسة X-Goog-FieldMask. تشرح Google صيغة المسارات في دليل اختيار حقول الاستجابة.

تعيد Text Search وNearby Search مصفوفة تحت places. يمكن كتابة قناع للمعرفات فقط هكذا:

X-Goog-FieldMask: places.id,places.name

قد تحتاج شاشة نتائج بسيطة إلى اسم مقروء وعنوان:

X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress

يصل هذا القناع إلى Pro في Text Search وNearby Search. عند إضافة الهاتف والموقع الإلكتروني، ينتقل الطلب إلى Enterprise:

X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress,places.nationalPhoneNumber,places.websiteUri

تعيد Place Details كائن Place واحدا. لذلك لا تبدأ مساراتها بالمقطع places.:

X-Goog-FieldMask: id,displayName,formattedAddress

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

معادلة بسيطة وأربعة أمثلة

عندما يبقى الاستخدام ضمن أول شريحة مدفوعة، استخدم المعادلة التالية:

التكلفة التقديرية = (أحداث الشهر - الحد المجاني) / 1,000 × سعر SKU

لا يمكن أن تكون النتيجة أقل من صفر. تفترض الأمثلة عدم وجود استخدام آخر لنفس SKU خلال الشهر.

10,000 حدث Text Search Pro

أول 5,000 حدث مجانية. يتبقى 5,000 حدث مدفوع.

(10,000 - 5,000) × $32 / 1,000 = $160

10,000 حدث Text Search Enterprise

الحد المجاني في Enterprise هو 1,000 حدث. يتبقى 9,000 حدث مدفوع.

(10,000 - 1,000) × $35 / 1,000 = $315

عدد الأحداث متساو في المثالين، لكن الحقول الأعلى تضيف 155 دولارا إلى التكلفة الشهرية التقديرية.

50,000 حدث Text Search Pro

(50,000 - 5,000) × $32 / 1,000 = $1,440

50,000 حدث Text Search Enterprise

(50,000 - 1,000) × $35 / 1,000 = $1,715

هذه حسابات توضيحية وليست وعدا بقيمة الفاتورة. قد يستخدم التطبيق Text Search لاكتشاف الأماكن، ثم يستخدم Place Details لجلب معلومات النتائج التي اختارها المستخدم. لكل خدمة SKU مستقل. كما تغير المحاولات المكررة والاختبارات والتحديثات المجدولة ومشاريع الحساب الأخرى المجموع النهائي.

بناء تقدير شهري واقعي

ابدأ بمسار المستخدم، لا بسطر السعر. يجب أن تعرف عدد الطلبات التي تنتج عن كل خطوة.

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

اتبع هذه الخطوات:

1. اكتب كل نقطة نهاية من Places في المسار.
2. سجل قناع الحقول الدقيق لكل نقطة.
3. حدد أعلى SKU في كل قناع.
4. قدر أحداث الشهر، بما فيها المهام الخلفية وإعادة المحاولة.
5. اطرح الحد المجاني لكل SKU مرة واحدة فقط.
6. طبق كل شرائح الحجم إذا تجاوز الاستخدام 100,000 حدث.
7. أنشئ ميزانية وتنبيهات في Cloud Billing.
8. قارن أول فاتورة بالتقدير وعدل افتراضاتك.

راجع القناع عندما تضيف ميزة. قد يبدو عرض التقييم في بطاقة البحث تغييرا بصريا صغيرا. لكن حقل rating يستطيع نقل كل طلبات تلك البطاقة من Pro إلى Enterprise.

Places API أم أداة تصدير بيانات؟

تناسب Places API البحث الحي وأدوات العثور على الفروع ومعلومات المكان داخل تطبيق. تمنح المطور تحكما دقيقا واتصالا مباشرا بخدمات Google. يحتاج الفريق إلى إدارة المفاتيح والحصص والأقنعة والفوترة وشروط Google التي تنطبق على المشروع.

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

إذا كنت ما زلت تصمم العملية، اقرأ دليل الحصول على بيانات Google Maps. وللعمل في جدول، راجع تصدير بيانات Google Maps إلى Excel. أما نماذج أسعار الأدوات المتخصصة فتجدها في مقارنة أسعار أدوات Google Maps scraper.

أسئلة شائعة

كيف تعمل أسعار Google Places API؟

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

هل Google Places API مجانية؟

توجد حدود مجانية في بعض المستويات. يوم 13 أغسطس 2026 كان الحد المجاني غير محدود في IDs Only لخدمتي Place Details وText Search. أما المستويات الأخرى المذكورة فكانت تمنح 1,000 أو 5,000 أو 10,000 حدث.

هل يغير قناع الحقول سعر الطلب؟

نعم. قد يرفع الهاتف والموقع الإلكتروني والتقييم وعدد التقييمات الطلب إلى Enterprise. وقد ترفعه المراجعات إلى Enterprise + Atmosphere. يحاسب الحقل الأعلى الطلب كله.

لماذا يجب تجنب النجمة في قناع الحقول؟

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

كم تبلغ تكلفة 10,000 حدث من Text Search Pro؟

مع 5,000 حدث مجاني وسعر 32 دولارا لكل ألف، تكون التكلفة التقديرية 160 دولارا. لا يشمل الحساب استخداما شهريا آخر لنفس SKU.

هل Place Details أرخص من Text Search؟

هي أرخص في عدة مستويات، لكنها تتطلب place ID وتعيد مكانا واحدا. تكتشف Text Search الأماكن المرشحة. قد يستخدم النظام الخدمتين.

متى أستخدم أداة تصدير بدلا من Places API؟

فكر فيها لقائمة بلا برمجة حسب الفئة والمنطقة أو لتحليل جدول بيانات. استخدم Places API لميزات التطبيق الحية. قارن الحقول والشروط وعدد الطلبات والتكلفة الكاملة.

اختبر حجما صغيرا أولا

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