أنشئ مفتاح API
أنشئ بيانات اعتماد في مساحة عمل API الخاصة بك واحتفظ بها في التهيئة السرية لخادمك أو عميلك. يستخدم REST وMCP حصة API نفسها.
افتح مفاتيح APIG Maps Crawl للمطورين
ابحث عن الأنشطة التجارية واقرأ المراجعات العامة وتصفّح صور ومقاطع فيديو الأماكن. ابنِ باستخدام REST API متزامنة أو امنح مساعد الذكاء الاصطناعي الخاص بك وصولًا عبر MCP.
JSON منظم
النتائج في الاستجابة نفسها
REST + MCP
استخدم تطبيقك أو عميل الذكاء الاصطناعي
حصة API واحدة
مشتركة بين طلبات API وMCP
اختر بياناتك
ابدأ بالبحث عن نشاط تجاري، ثم استخدم معرّف ميزة المكان لطلب المراجعات أو عناصر المعرض. لكل 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 الخاص بك من جانب الخادم؛ استخدم مفتاح عدم تكرار جديدًا للعمل الجديد واحتفظ به لإعادة محاولة غير مُغيَّرة.
{
"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 القياسي
أنشئ بيانات اعتماد في مساحة عمل API الخاصة بك واحتفظ بها في التهيئة السرية لخادمك أو عميلك. يستخدم REST وMCP حصة API نفسها.
افتح مفاتيح APIابحث بكلمة رئيسية وموقع. للمراجعات والصور، وفّر معرّف ميزة خرائط Google الذي لديك بالفعل أو اقرأ place.dataId من نتيجة بحث.
اتبع دليل البدء السريععالج الصفحة المُرجعة في تطبيقك. اتبع قواعد ترقيم صفحات نقطة النهاية، وافحص الحقول المفقودة، واحتفظ بمفتاح عدم التكرار للطلب لإعادة المحاولة.
افهم ترقيم الصفحاتابنِ شيئًا مفيدًا
استخدم السجلات المُرجعة كمدخلات لأبحاثك وتقاريرك وسير عملك الداخلي.
ابحث في فئة وموقع، ثم نظّم أسماء الأنشطة التجارية وعناوينها ومواقعها الإلكترونية وأرقام هواتفها وتقييماتها المتاحة في تطبيقك.
اطّلع على المراجعات العامة لمكان ما لدراسة ملاحظات العملاء. اختر ترتيب فرز ثابتًا وتابع الصفحات المتاحة لتحليلك.
استرجع روابط الصور والفيديو المتاحة لمكان ما. احتفظ برابط المعرض المصدر مع السجلات حتى يتمكن فريقك من فحص السياق الأصلي.
وكيلك، متصل
اتصل بخادم MCP للحصول على أدوات قابلة للاكتشاف، أو ثبّت مهارة الوكيل للحصول على تعليمات سير عمل قابلة لإعادة الاستخدام وبديل REST.
مهمة مثال لوكيلك المتصل
«ابحث عن صفحة واحدة من المقاهي في سياتل. أرجِع الأسماء والمواقع الإلكترونية والتقييمات المتاحة، وأشِر إلى البيانات المفقودة.»
تستخدم الطلبات حصة API الخاصة بك. مع بيانات اعتماد تجريبية، تكون النتائج محاكاة.
خطط لتكاملك
كل صفحة فعلية ناجحة، بما في ذلك صفحة فارغة، تستخدم طلب API واحدًا. يتشارك REST وMCP خطة API الخاصة بك؛ أما حصص Online والإضافة فمنفصلة.
ابدأ بصفحة واحدة، وتحقق من الحقول المُرجعة، واضبط مهلة عميل مناسبة لنقطة النهاية. لإعادة المحاولة، أعد استخدام Idempotency-Key نفسها مع نص طلب غير مُغيَّر.
تؤثر حدود الخطة وحدود المعدل وتوفر المصدر والإثراء على الطلبات الفعلية. تُرجع بيانات الاعتماد التجريبية تركيبات محاكاة دون استهلاك حصتك الفعلية.
استخدم صفحات نقاط النهاية للاطلاع على حدود الطلب وحقول النتائج. تعرض صفحة الأسعار الطلبات المضمّنة حاليًا وأسعار التجاوز المدفوعة.
يوفر G Maps Crawl واجهات API للبحث عن الأنشطة التجارية ومراجعات الأماكن العامة وصور/معارض الأماكن. يُرجع البحث سجلات الأنشطة التجارية؛ بينما تستخدم Reviews وPhotos معرّف ميزة خرائط Google لإرجاع صفحة واحدة لمكان محدد.
نعم. تستخدم واجهات API طلبات HTTP وJSON، لذا يمكنك استدعاؤها باستخدام Python أو JavaScript أو cURL أو أي عميل HTTP آخر. تتضمن كل صفحة API أمثلة على الطلبات ونموذج استجابة.
تُرجع واجهات API العامة Search وReviews وPhotos صيغة JSON في الاستجابة نفسها. لا تتطلب استطلاع المهام أو إعداد webhook. اتبع إرشادات المهلة وإعادة المحاولة لنقطة النهاية.
يتيح REST لتطبيقك استدعاء نقطة نهاية مباشرة. يجعل MCP الأدوات متاحة لعميل ذكاء اصطناعي متوافق. توفر مهارة الوكيل تعليمات سير العمل ونصوصًا مساعدة. تتطلب طلبات REST وMCP بيانات اعتماد API وتستخدم حصة API الخاصة بك.
استخدم معرّف ميزة خرائط Google لديك بالفعل، أو انسخ place.dataId من سجل مطابق في مصفوفة data.businesses في Search API. مرّر تلك القيمة كـ fid إلى Reviews API أو Photos API.
لا. تعتمد الحقول المُرجعة على المصدر والعملية المحددة. افحص القيم المفقودة وطوابع الملاحظة الزمنية المتاحة قبل استخدام البيانات. قد تحتوي الاستجابة الناجحة على صفحة فارغة.
انتقل إلى الخطوة التالية
أنشئ مفتاح API، وابدأ بطلب واحد، واستكشف البيانات التي يمكن لتطبيقك استخدامها.