G Maps Crawl للمطورين

بيانات خرائط Google.
مدمجة في سير عملك.

ابحث عن الأنشطة التجارية واقرأ المراجعات العامة وتصفّح صور ومقاطع فيديو الأماكن. ابنِ باستخدام REST API متزامنة أو امنح مساعد الذكاء الاصطناعي الخاص بك وصولًا عبر MCP.

JSON منظم

النتائج في الاستجابة نفسها

REST + MCP

استخدم تطبيقك أو عميل الذكاء الاصطناعي

حصة API واحدة

مشتركة بين طلبات API وMCP

اختر بياناتك

واجهة API لكل خطوة من بحثك

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

طلب API الأول الخاص بك

انتقل من طلب إلى بيانات منظمة

استخدم مفتاح API في ترويسة Authorization. استكشف تنسيقات الطلب أدناه، ثم اتبع دليل البدء السريع لإجراء أول استدعاء لك.

أمثلة على الطلبات

للاطلاع على العقد الكامل، راجع وثائق API.

curl https://gmapscrawl.com/api/v1/search \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seattle-coffee-search-001" \
  -d '{"q":"coffee shops in Seattle","page":1,"extra":false}'

استجابة فارغة توضيحية. يُرجع البحث الفعلي الأنشطة التجارية المتاحة. احتفظ بمفتاح API الخاص بك من جانب الخادم؛ استخدم مفتاح عدم تكرار جديدًا للعمل الجديد واحتفظ به لإعادة محاولة غير مُغيَّرة.

الاستجابة

JSON توضيحي
{
  "data": {
    "total": 0,
    "params": {
      "q": "coffee shops in Seattle",
      "page": 1,
      "hl": "en",
      "extra": false
    },
    "businesses": []
  },
  "request_id": "req_example",
  "schema_version": "2026-09-22"
}

تُرجع API صيغة JSON في الاستجابة نفسها. بعد انتهاء المهلة، أعد المحاولة بالنص نفسه دون تغيير مع Idempotency-Key ذاتها. تُرجع بيانات الاعتماد التجريبية بيانات محاكاة دون استخدام حصتك الفعلية.

ابنِ باستخدام HTTP القياسي

تكامل صغير. سير عمل بيانات مفيد.

01

أنشئ مفتاح API

أنشئ بيانات اعتماد في مساحة عمل API الخاصة بك واحتفظ بها في التهيئة السرية لخادمك أو عميلك. يستخدم REST وMCP حصة API نفسها.

افتح مفاتيح API
02

اختر API

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

اتبع دليل البدء السريع
03

اقرأ استجابة JSON

عالج الصفحة المُرجعة في تطبيقك. اتبع قواعد ترقيم صفحات نقطة النهاية، وافحص الحقول المفقودة، واحتفظ بمفتاح عدم التكرار للطلب لإعادة المحاولة.

افهم ترقيم الصفحات

ابنِ شيئًا مفيدًا

أدخل بيانات الخرائط في تطبيقك

استخدم السجلات المُرجعة كمدخلات لأبحاثك وتقاريرك وسير عملك الداخلي.

01

أبحاث الأنشطة التجارية المحلية

ابحث في فئة وموقع، ثم نظّم أسماء الأنشطة التجارية وعناوينها ومواقعها الإلكترونية وأرقام هواتفها وتقييماتها المتاحة في تطبيقك.

02

تحليل المراجعات

اطّلع على المراجعات العامة لمكان ما لدراسة ملاحظات العملاء. اختر ترتيب فرز ثابتًا وتابع الصفحات المتاحة لتحليلك.

03

أبحاث معرض الأماكن

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

وكيلك، متصل

استخدم البيانات نفسها عبر عميل الذكاء الاصطناعي الخاص بك.

اتصل بخادم MCP للحصول على أدوات قابلة للاكتشاف، أو ثبّت مهارة الوكيل للحصول على تعليمات سير عمل قابلة لإعادة الاستخدام وبديل REST.

مهمة مثال لوكيلك المتصل

«ابحث عن صفحة واحدة من المقاهي في سياتل. أرجِع الأسماء والمواقع الإلكترونية والتقييمات المتاحة، وأشِر إلى البيانات المفقودة.»

تستخدم الطلبات حصة API الخاصة بك. مع بيانات اعتماد تجريبية، تكون النتائج محاكاة.

خطط لتكاملك

افهم الاستخدام قبل التوسع

كل صفحة فعلية ناجحة، بما في ذلك صفحة فارغة، تستخدم طلب API واحدًا. يتشارك REST وMCP خطة API الخاصة بك؛ أما حصص Online والإضافة فمنفصلة.

اجعل الطلبات قابلة للتنبؤ

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

تؤثر حدود الخطة وحدود المعدل وتوفر المصدر والإثراء على الطلبات الفعلية. تُرجع بيانات الاعتماد التجريبية تركيبات محاكاة دون استهلاك حصتك الفعلية.

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

الأسئلة الشائعة

ما واجهات API لخرائط Google المتاحة؟

يوفر G Maps Crawl واجهات API للبحث عن الأنشطة التجارية ومراجعات الأماكن العامة وصور/معارض الأماكن. يُرجع البحث سجلات الأنشطة التجارية؛ بينما تستخدم Reviews وPhotos معرّف ميزة خرائط Google لإرجاع صفحة واحدة لمكان محدد.

هل يمكنني استخدام Python أو JavaScript؟

نعم. تستخدم واجهات API طلبات HTTP وJSON، لذا يمكنك استدعاؤها باستخدام Python أو JavaScript أو cURL أو أي عميل HTTP آخر. تتضمن كل صفحة API أمثلة على الطلبات ونموذج استجابة.

هل أحتاج إلى استطلاع نتيجة مهمة؟

تُرجع واجهات API العامة Search وReviews وPhotos صيغة JSON في الاستجابة نفسها. لا تتطلب استطلاع المهام أو إعداد webhook. اتبع إرشادات المهلة وإعادة المحاولة لنقطة النهاية.

كيف تعمل API وMCP ومهارة الوكيل معًا؟

يتيح REST لتطبيقك استدعاء نقطة نهاية مباشرة. يجعل MCP الأدوات متاحة لعميل ذكاء اصطناعي متوافق. توفر مهارة الوكيل تعليمات سير العمل ونصوصًا مساعدة. تتطلب طلبات REST وMCP بيانات اعتماد API وتستخدم حصة API الخاصة بك.

أين أحصل على معرّف ميزة للمراجعات والصور؟

استخدم معرّف ميزة خرائط Google لديك بالفعل، أو انسخ place.dataId من سجل مطابق في مصفوفة data.businesses في Search API. مرّر تلك القيمة كـ fid إلى Reviews API أو Photos API.

هل كل حقل مضمون التوفر؟

لا. تعتمد الحقول المُرجعة على المصدر والعملية المحددة. افحص القيم المفقودة وطوابع الملاحظة الزمنية المتاحة قبل استخدام البيانات. قد تحتوي الاستجابة الناجحة على صفحة فارغة.

انتقل إلى الخطوة التالية

ابنِ أول سير عمل لبيانات خرائط Google.

أنشئ مفتاح API، وابدأ بطلب واحد، واستكشف البيانات التي يمكن لتطبيقك استخدامها.