anilead.io/Blog/Tutorial
Tutorial8 min قراءة

Google Places API for Lead Generation: The Complete Setup Tutorial

Step-by-step guide: How to use Google Places API to find B2B leads in Germany, Austria and Switzerland — for free.

Andreas Indorf
Andreas Indorf

Gründer · anilead.io · 28 فبراير 2026

Google Places API for Lead Generation: The Complete Setup Tutorial

تُعد واجهة Google Places API من أقوى مصادر البيانات لتوليد العملاء المحتملين في سوق منطقة DACH: فخرائط Google، بما تضمه وفق بيانات Google نفسها من أكثر من 200 مليون مكان وشركة، هي دليل الشركات الأكثر اكتمالًا في العالم، وتمنحكم Places API وصولًا رسميًا وبرمجيًا إليه. في هذا الدليل التعليمي تجهزون كل شيء خطوة بخطوة — من مشروع السحابة، مرورًا بالاختيار بين Text Search وNearby Search، وصولًا إلى أقنعة الحقول ونموذج التسعير الحالي (حتى يوليو 2026).

لماذا تُعد Google Places أفضل مصدر بيانات لعملاء B2B المحتملين؟

توفر Google Places API بيانات شركات أحدث وأكثر اكتمالًا من أي اشتراك في قاعدة بيانات، لأن الشركات تعتني بملفاتها على الخرائط بنفسها وتُدخل Google التغييرات باستمرار. وتحصلون لكل شركة يُعثر عليها، بشكل منظم، على:

  • اسم الشركة وفئة القطاع
  • العنوان وإحداثيات GPS
  • رقم الهاتف ورابط الموقع الإلكتروني
  • ساعات العمل والتقييمات
  • الصور والأوصاف

والتغطية ممتازة تحديدًا للشركات المتوسطة في منطقة DACH: فعمليًا كل منشأة ذات حضور مادي مدرجة — من مصنّع الآلات إلى مكتب الاستشارات الضريبية. مهم: الاستخدام عبر الواجهة الرسمية يختلف جذريًا عن كشط واجهة الخرائط الذي يخالف شروط استخدام Google. المزيد عن ذلك في مقال كشط خرائط Google — ما هو القانوني في ألمانيا.

الخطوة 1: كيف تعدّون مشروع Google Cloud؟

تحتاجون لاستخدام Places API إلى مشروع Google Cloud مع حساب فوترة مسجل — فحتى لو اكتفيتم بالحصة المجانية، تشترط Google وجود وسيلة دفع مسجلة. ويستغرق الإعداد نحو 15 دقيقة:

  1. انتقلوا إلى console.cloud.google.com وسجّلوا الدخول بحساب Google
  2. أنشئوا عبر قائمة اختيار المشاريع أعلى اليسار مشروعًا جديدًا، باسم "lead-generation" مثلًا
  3. أعدّوا تحت الفوترة حساب فوترة بوسيلة دفع واربطوه بالمشروع
  4. أنشئوا اختياريًا تحت الميزانيات والتنبيهات ميزانية بعتبة إنذار — فتصلكم رسالة بريد إلكتروني قبل نشوء التكاليف

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

الخطوة 2: كيف تفعّلون Places API وتؤمّنونها؟

‏Places API (New) هي الجيل الحالي من الواجهة والخيار الصحيح للمشاريع الجديدة — أما Places API الكلاسيكية فتُعد قديمة (Legacy). التفعيل والتأمين في أربع خطوات:

  1. افتحوا APIs & Services → Library، وابحثوا عن "Places API (New)" وانقروا على تفعيل
  2. أنشئوا تحت APIs & Services → Credentials مفتاح API جديدًا
  3. قيّدوا المفتاح تحت API restrictions على Places API (New) — فلا يستطيع مفتاح مسرّب استخدام خدمات Google أخرى على حسابكم
  4. ضعوا تحت Application restrictions قيدًا على عنوان IP الخاص بخادمكم إذا كانت الاستعلامات تجري من بنية تحتية ثابتة

وتعاملوا مع المفتاح كما تتعاملون مع كلمة مرور: لا تُدرجوه في مستودعات الشيفرة، بل خزّنوه كمتغير بيئة.

Text Search أم Nearby Search — أي طريقة تناسب قوائم العملاء المحتملين؟

‏Text Search هي دائمًا تقريبًا الخيار الصحيح لتوليد العملاء المحتملين، لأنها تفهم مصطلحات بحث حرة مثل "استشارات ضريبية برلين"؛ أما Nearby Search فتجد أماكن من نوع معين في محيط إحداثيات محددة. الفروق باختصار:

  • Text Search: تقبل استعلامات بلغة طبيعية من القطاع مع المنطقة ("شركات برمجيات ميونخ"، "هندسة ميكانيكية شركات متوسطة شفابن"). ويعود لكل استعلام حتى 20 نتيجة، وعبر رمز الصفحات التالية (nextPageToken) حتى 60 نتيجة إجمالًا — ووفق التوثيق الرسمي لـ Text Search تتوقف عند 60 نتيجة
  • Nearby Search: تتطلب نقطة مركز (إحداثيات) ونصف قطر وأنواع أماكن مثل "electrician" أو "lawyer". قوية إذا أردتم مسح منطقة بشكل منهجي، مثل جميع منشآت الحرف في محيط 20 كيلومترًا حول مدينة

وفي الممارسة تجمعون بين الاثنتين: Text Search لبناء القوائم حسب القطاع، وNearby Search لتغطية المناطق الكثيفة كاملة على شكل مربعات عندما يقيّدكم حد الـ 60 نتيجة في Text Search. كما تتجاوزون حد الـ 60 في Text Search بتقسيم المنطقة إلى عدة استعلامات أكثر تحديدًا — فبدلًا من "مزودو خدمات تقنية المعلومات بافاريا" تستخدمون "مزودو خدمات تقنية المعلومات نورنبرغ" ثم "مزودو خدمات تقنية المعلومات أوغسبورغ" وهكذا.

كم تكلف Google Places API؟ (حتى يوليو 2026)

لواجهة Google Places API منذ 1 مارس 2025 نموذج تسعير جديد: فقد أُلغي رصيد الـ 200 دولار الشهري السابق واستُبدل بحصص شهرية مجانية لكل فئة SKU — ‏10.000 استدعاء لاستعلامات Essentials، و5.000 لاستعلامات Pro، و1.000 لاستعلامات Enterprise، كما توثّق Google في الأسئلة الشائعة الرسمية للفوترة. وتحدد الحقول التي تطلبونها في كل استعلام الفئة التي تُحتسب:

فئة SKUالحصة المجانية شهريًاالحقول النموذجيةسعر Text Search (بعد الحصة المجانية)
Essentials (IDs Only)10.000 استدعاءمعرّفات الأماكن فقط32 دولارًا أمريكيًا لكل 1.000 استدعاء
Pro5.000 استدعاءالاسم والعنوان والفئة والإحداثيات32 دولارًا أمريكيًا لكل 1.000 استدعاء
Enterprise1.000 استدعاءإضافةً: الموقع الإلكتروني ورقم الهاتف وساعات العمل والتقييم35 دولارًا أمريكيًا لكل 1.000 استدعاء
Enterprise + Atmosphere1.000 استدعاءإضافةً: نصوص المراجعات وسمات التجهيزاتأعلى مستوى، وغير ضروري لقوائم العملاء المحتملين

لقوائم العملاء المحتملين تحتاجون إلى الموقع الإلكتروني ورقم الهاتف — أي مستوى Enterprise. وبذلك تكون الحسبة كالتالي: 1.000 استدعاء Enterprise مجاني شهريًا مضروبة في ما يصل إلى 20 نتيجة لكل استدعاء تعطي ما يصل إلى 20.000 سجل شركة شهريًا مجانًا. وبعد ذلك تكلف 1.000 استدعاء إضافي (حتى 20.000 شركة إضافية) 35 دولارًا أمريكيًا. وتُدرج قائمة أسعار Google الرسمية الأسعار الدقيقة شاملة خصومات الكميات؛ أما المقالات الأقدم التي ما زالت تحسب برصيد الـ 200 دولار فقد تجاوزها الزمن منذ مارس 2025.

كيف تخفض أقنعة الحقول تكاليف الواجهة لديكم؟

قناع الحقول (FieldMask) هو قائمة حقول الاستجابة التي تطلبونها في كل استعلام — وهو ما يحدد السعر: إذ تحتسب Google كل استعلام وفق أعلى فئة SKU طلبتم منها ولو حقلًا واحدًا فقط. ومن يطلب عن غير قصد حقلًا من فئة Atmosphere مثل المراجعات، يدفع عن الاستعلام كاملًا السعر الأعلى.

لذا يسري على البحث عن العملاء المحتملين بكفاءة في التكلفة ما يلي:

  • اطلبوا فقط ما تحتاجونه فعلًا — لقوائم العملاء المحتملين عادةً: places.displayName وplaces.formattedAddress وplaces.nationalPhoneNumber وplaces.websiteUri وplaces.types
  • استغنوا عن حقول التقييمات والمراجعات إذا لم تكونوا تحللونها — فهي ترفع الاستعلام إلى الفئة الأغلى
  • افصلوا حالات الاستخدام: فلتحليلات المناطق البحتة يكفي مستوى Pro دون موقع إلكتروني وهاتف، مع الحصة المجانية الأكبر البالغة 5.000

وتمررون قناع الحقول كترويسة HTTP باسم X-Goog-FieldMask مع مسارات حقول مفصولة بفواصل. وبدون قناع حقول لا تجيب Places API (New) عن أي استعلام أصلًا — وهو ما يضطركم، عن حق، إلى حسم مسألة التكلفة قبل أول استعلام.

كيف تصيغون استعلامات البحث استراتيجيًا؟

تعتمد جودة عملائكم المحتملين مباشرة على جودة استعلامات بحثكم — فالواجهة لا تجد إلا ما تسألون عنه. وقد أثبتت أربع استراتيجيات جدواها:

  • القطاع + المدينة: "مزودو خدمات تقنية المعلومات فرانكفورت" — المعيار لبناء القوائم
  • القطاع + المنطقة: "هندسة ميكانيكية بافاريا" — أوسع، لكنه مقيد بحد الـ 60 نتيجة؛ والأفضل تقسيمه إلى مدن
  • موجه بالمشكلة: "استشارات ضريبية للشركات المتوسطة" — يجد الموردين الذين يقدمون أنفسهم بهذا الشكل
  • متخصص في نيش: "وكالة تجارة إلكترونية دوسلدورف" — نتائج أقل، لكن بنسبة إصابة أعلى عند التأهيل

وباستخدام نموذج لغوي مثل Claude يمكنكم توليد عشرات صيغ استعلامات البحث تلقائيًا من وصف منتجكم — مرادفات مختلفة ومسميات قطاعات وتركيبات أماكن لن تدونوها يدويًا بشكل كامل أبدًا. وهكذا يعمل anilead.io تمامًا: فمن وصف عملائكم المستهدفين تنشأ تلقائيًا 8 إلى 12 استعلام بحث في كل دورة.

كيف تنتقلون من الموقع الإلكتروني إلى عنوان البريد الإلكتروني؟

توفر Places API رابط الموقع الإلكتروني لكن لا عنوان بريد إلكتروني — والإثراء هو الخطوة الثانية في خط الإمداد. ويتولى زاحف الويب ذلك تلقائيًا:

  1. زوروا كل موقع يُعثر عليه برمجيًا
  2. افحصوا الصفحات المعتادة ‎/kontakt و‎/impressum و‎/ueber-uns بحثًا عن أنماط البريد الإلكتروني — إذ يضمن واجب بيانات الناشر (Impressum — الصفحة الإلزامية لبيانات مشغّل الموقع في ألمانيا) أن كل موقع تجاري تقريبًا يذكر عنوانًا
  3. ميّزوا العناوين العامة (info@‎ وkontakt@‎) عن الشخصية وأعطوا الأولوية للأخيرة
  4. تحققوا من العناوين تقنيًا قبل إدخالها في نظام إدارة علاقات العملاء

تنبيه قانوني: عنوان البريد الإلكتروني المستخرج ليس إذنًا برسائل البريد الدعائية. فبموجب المادة § 7 الفقرة 2 من قانون مكافحة المنافسة غير العادلة الألماني (UWG) يخضع الإعلان عبر البريد الإلكتروني مبدئيًا لشرط الموافقة، حتى في B2B — فخططوا للاتصال الأول عبر الهاتف (عند وجود موافقة مفترضة) أو البريد الورقي أو LinkedIn واحصلوا هناك على الموافقة على البريد الإلكتروني. هذا المقال لا يغني عن الاستشارة القانونية.

هل استخدام Places API لتوليد العملاء المحتملين مسموح؟

‏Places API هي المسار الذي حددته Google رسميًا لاستخدام بيانات الخرائط برمجيًا — بخلاف كشط واجهة الخرائط الذي يخالف شروط الاستخدام. ومع ذلك عليكم مراعاة مستويين: قواعد منصة Google (مثل أحكام تخزين المحتوى ونسبته إلى مصدره، علمًا بأن معرّفات الأماكن يجوز تخزينها دائمًا) والقانون الألماني عند الاستخدام اللاحق للبيانات. ولأن الأمر يتعلق ببيانات تجارية متاحة للاطلاع العام، يمكن إسناد المعالجة إلى المصلحة المشروعة (المادة Art. 6 الفقرة 1 حرف f من اللائحة الأوروبية العامة لحماية البيانات GDPR — المعروفة في ألمانيا باسم DSGVO)، إذا وثّقتم موازنة المصالح وطبقتم حقوق أصحاب البيانات. وتجدون التقييم المفصل مع التمييز عن الكشط في مقال كشط خرائط Google — ما هو القانوني في ألمانيا.

الخلاصة: خط الإمداد الكامل

توفر Google Places بيانات الشركات، وزاحف المواقع عناوين البريد الإلكتروني، وتقييم الذكاء الاصطناعي ترتيب الأولويات، وينقل التصدير كل شيء إلى نظام إدارة علاقات العملاء — هذه الخطوات الأربع تشكل خط إمداد عملاء محتملين متكاملًا لا تكلفكم بياناته الخام سنتًا واحدًا ضمن حصة الواجهة المجانية. ويشرح دليل أتمتة مبيعات B2B كيفية تكامل حزمة الأتمتة بأكملها؛ ويبين مقال توليد عملاء B2B المحتملين مجانًا مصادر البيانات المجانية الأخرى التي تستحق العناء كتكملة.

ولمن لا يريد بناء خط الإمداد بنفسه: anilead.io برنامج لتوليد عملاء B2B المحتملين لسوق منطقة DACH، يعثر على الشركات عبر Google Places، ويستخرج عناوين البريد الإلكتروني، ويقيّم كل عميل محتمل باستخدام Claude AI. ولا حاجة لمفتاح Google API خاص — فالبحث يجري عبر البنية التحتية لـ anilead.io، ومعالجة البيانات على خوادم في الاتحاد الأوروبي بفرانكفورت. تتضمن خطة Free ‏50 رصيد عملاء محتملين شهريًا، دون بطاقة ائتمان.

أسئلة شائعة حول Google Places API لتوليد العملاء المحتملين

هل ما زال رصيد الـ 200 دولار لمنصة Google Maps موجودًا؟

لا. ألغت Google الرصيد الشهري البالغ 200 دولار اعتبارًا من 1 مارس 2025 واستبدلته بحصص شهرية مجانية لكل فئة SKU: ‏10.000 استدعاء لاستعلامات Essentials، و5.000 لاستعلامات Pro، و1.000 لاستعلامات Enterprise (حتى يوليو 2026). ولاستعلامات العملاء المحتملين الشاملة للموقع الإلكتروني ورقم الهاتف تسري حصة Enterprise البالغة 1.000 استدعاء شهريًا.

كم عدد العملاء المحتملين الذين أحصل عليهم ضمن الحصة المجانية؟

حتى 20.000 سجل شركة شهريًا: 1.000 استدعاء Enterprise مجاني مضروبة في ما يصل إلى 20 نتيجة لكل استعلام Text Search. وإذا استغنيتم عن الموقع الإلكتروني ورقم الهاتف، تسري حصة Pro البالغة 5.000 استدعاء — حتى 100.000 سجل أساسي. وعنق الزجاجة العملي نادرًا ما يكون الواجهة، بل القدرة على التأهيل والتواصل.

هل أحتاج إلى معرفة برمجية لاستخدام Places API؟

للاستخدام المباشر نعم — تحتاجون إلى مشروع سحابة ومفتاح API وسكربت يرسل الاستعلامات ويعالج الاستجابات؛ وبمعرفة أساسية بلغة Python أو JavaScript يمكن إنجاز ذلك في ظهيرة واحدة. أما دون برمجة فتستخدمون أداة مثل anilead.io التي تتضمن بحث Places واستخراج البريد الإلكتروني وتقييم الذكاء الاصطناعي جاهزة، ولا تشترط مفتاح API خاصًا.

هل توفر Places API عناوين بريد إلكتروني أيضًا؟

لا، عناوين البريد الإلكتروني ليست حقلًا في Places API — فهي توفر ضمن ما توفره الاسم والعنوان ورقم الهاتف ورابط الموقع الإلكتروني. وتحصلون على عنوان البريد الإلكتروني في الخطوة الثانية، حيث يزور زاحف موقع الشركة ويحلل صفحات الاتصال وبيانات الناشر. وراعوا عند التواصل المادة § 7 من قانون UWG: فرسائل البريد الدعائية تشترط مبدئيًا موافقة.

هل أنت مستعد للعثور على أول عملائك المحتملين؟

ابدأ مجانًا — 50 عميل محتمل/شهر إلى الأبد. لا حاجة لبطاقة ائتمانية.

ابدأ مجانًا الآن

مقالات ذات صلة