![](https://developers.google.cn/static/maps/images/landing/hero_places_api.png?authuser=8&%3Bhl=ar&hl=ar)
واجهة برمجة تطبيقات الأماكن
احصل على بيانات الموقع الجغرافي لأكثر من 200 مليون مكان، وأضِف إلى تطبيقاتك تفاصيل الأماكن وعمليات البحث والإكمال التلقائي.
البدء
بدء عملية الإنشاء باستخدام واجهة برمجة تطبيقات الأماكن.
بدء استخدام "منصة خرائط Google"
يمكنك إنشاء حساب وإنشاء مفتاح واجهة برمجة التطبيقات وبدء عملية الإنشاء.
اختيار إصدار واجهة برمجة التطبيقات
تدعم الأماكن إصدارين من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات الأماكن وواجهة برمجة تطبيقات الأماكن (جديدة)، وهي الإصدار الجيل التالي من واجهات برمجة التطبيقات. تعرّف على كيفية اختيار الإصدار المناسب لك.
مزيد من المعلومات عن معرّفات الأماكن
تحدد معرّفات الأماكن المكان بشكل فريد في قاعدة بيانات أماكن Google وفي خرائط Google.
إجراء أول طلب بحث نصي (جديد)
عرض معلومات مكان استنادًا إلى إدخال النص، مثل الاسم أو العنوان أو رقم الهاتف
مكتبة الأماكن في واجهة برمجة تطبيقات JavaScript للخرائط
إضافة وظيفة البحث عن الأماكن والإكمال التلقائي إلى تطبيقاتك، مما يتيح للمستخدمين العثور على أماكن استنادًا إلى طلب بحث نصي أو رقم هاتف.
مزيد من المعلومات عن رموز الأماكن
طلب وعرض رموز لأنواع مختلفة من الأماكن.
ميزات واجهة برمجة تطبيقات الأماكن (جديدة)
التعرّف على الميزات الأساسية لواجهة برمجة تطبيقات الأماكن (جديدة).
البحث عن قرب (جديد)
البحث عن أنواع أماكن متطابقة ضمن المنطقة المحدّدة.
البحث النصي (جديد)
ابحث عن معلومات المكان استنادًا إلى سلسلة بحث نصية.
تفاصيل المكان (جديد)
الحصول على تفاصيل حول منشأة أو نقطة اهتمام معينة.
صور المكان (جديدة)
إضافة صور عالية الجودة للأماكن إلى تطبيقك
إكمال تلقائي (جديد)
يمكنك الحصول على توقعات الأماكن وتوقعات طلبات البحث استجابةً لسلسلة إدخال.
ميزات واجهة برمجة تطبيقات الأماكن
التعرّف على الميزات الأساسية لواجهة برمجة تطبيقات الأماكن.
بحث الأماكن
ابحث عن معلومات الأماكن حول المنشآت ونقاط الاهتمام البارزة والمواقع الجغرافية.
تفاصيل المكان
الحصول على تفاصيل حول منشأة أو نقطة اهتمام معينة.
صور المكان
إضافة صور عالية الجودة للأماكن إلى تطبيقك
الإكمال التلقائي للأماكن
إضافة وظيفة الإكمال التلقائي للكتابة المسبقة إلى تطبيقك (البحث حسب اسم المكان أو العنوان أو رمز Plus Codes).
الإكمال التلقائي لطلب البحث
إضافة تنبؤات طلبات البحث الجغرافية السريعة إلى تطبيقك (البحث حسب طلب البحث النصي، على سبيل المثال "مطعم بيتزا بالقرب مني").
أمثلة على التطبيقات
يمكنك تشغيل نماذج الرموز المباشرة على جهازك المحلي وأماكن معالجة الرموز المفضلة باستخدام واجهة برمجة تطبيقات JavaScript للخرائط.
البحث عن الأماكن
يمكنك استخدام طريقة
findPlaceFromQuery()
لتحديد مكان، وإضافة علامة إلى الخريطة.
تفاصيل المكان
استخدم الطريقة
getDetails()
لاسترداد تفاصيل المكان لمكان معين.
تقسيم النتائج على صفحات في بحث الأماكن
جلب صفحات إضافية من نتائج البحث عن الأماكن.
ميزة "الإكمال التلقائي" للأماكن
عرض توقعات الأماكن استجابةً لعمليات البحث عن النصوص.
نموذج عنوان مكان الإكمال التلقائي
التقِط عناصر العنوان المحددة لمكان ما، واستخدمها لملء نموذج عنوان.
ميزة الإكمال التلقائي للبحث عن فنادق
عرض جميع الفنادق في مكان محدد على الخريطة، مع تفاصيل عند النقر لكل فندق.
المساعدة والدعم
الحصول على المساعدة. تقديم المساعدة الانضمام إلى المنتدى
Stack Overflow
الحصول على المساعدة. تقديم المساعدة إنشاء خلفيات لـ "خرائط Google"
أداة تتبّع المشاكل
الإبلاغ عن خطأ أو فتح طلب ميزة
حالة النظام الأساسي
تعرَّف على حوادث المنصّة وانقطاع الخدمة.
الدعم
يمكنك الحصول على مساعدة من فريق "منصة خرائط Google".