واجهة برمجة تطبيقات الأماكن هي خدمة تعرض معلومات عن الأماكن باستخدام طلبات HTTP. يتم تحديد الأماكن داخل واجهة برمجة التطبيقات هذه على أنها مؤسسات أو مواقع جغرافية أو نقاط اهتمام بارزة.
إضافة واجهة برمجة التطبيقات
تتوفر طلبات الأماكن التالية:
- تعرض ميزة البحث عن المكان قائمة بالأماكن استنادًا إلى الموقع الجغرافي للمستخدم أو سلسلة البحث الخاصة به.
- تعرض تفاصيل المكان معلومات أكثر تفصيلاً عن مكان محدّد، بما في ذلك مراجعات المستخدمين.
- تتيح ميزة صور المكان الوصول إلى الملايين من الصور المتعلقة بالمكان المخزنة في قاعدة بيانات الأماكن على Google.
- تملأ ميزة الإكمال التلقائي للمكان اسم المكان و/أو عنوانه أثناء كتابة المستخدمين.
- يوفّر الإكمال التلقائي لطلب البحث خدمة يتم فيها توقّع طلب البحث لعمليات البحث الجغرافية المستندة إلى النص، مع عرض طلبات البحث المقترَحة أثناء كتابة المستخدمين.
ويتم الوصول إلى كل خدمة من الخدمات كطلب HTTP، ويتم عرض إما استجابة JSON أو XML. يجب أن تستخدم جميع الطلبات إلى خدمة "الأماكن" بروتوكول https:// ، مع تضمين مفتاح واجهة برمجة تطبيقات.
تستخدم واجهة برمجة تطبيقات الأماكن معرّف مكان لتعريف مكان بشكل فريد. للحصول على تفاصيل عن تنسيق هذا المعرّف واستخدامه على مستوى واجهة برمجة تطبيقات الأماكن وواجهة برمجة التطبيقات الأخرى، يمكنك الاطّلاع على مستندات أرقام تعريف الأماكن.
السياسات والأحكام
يجب أن تتقيّد جميع التطبيقات التي تستخدم خدمة Places API أو خدمة الإكمال التلقائي للأماكن بالمتطلبات الموضّحة في سياسات واجهة برمجة تطبيقات الأماكن وبنود خدمة "منصة خرائط Google". تشارك واجهة برمجة تطبيقات الأماكن وميزة الإكمال التلقائي للأماكن من Google حصة الاستخدام كما هو موضح في وثائق استخدام واجهة برمجة تطبيقات الأماكن والفوترة.
للحصول على معلومات الحصة والأسعار حول واجهة برمجة تطبيقات الأماكن وخدمة الإكمال التلقائي للأماكن، راجع مستندات استخدام واجهة برمجة تطبيقات الأماكن والفوترة.