الخدمات الرئيسية المتاحة مع Places API (جديد)
توفر واجهة برمجة تطبيقات Google Places عدة طرق (نقاط نهاية) للبحث عن تفاصيل الموقع والحصول عليها، وكل منها مصممة لسيناريو محدد:
| خدمة | التطبيق الرئيسي | مثال للمشروع |
| الإكمال التلقائي | اقتراح أسماء الأماكن أو عمليات البحث أثناء قيام المستخدم بالكتابة. | حقل البحث عن العنوان في تطبيق توصيل الطعام. |
| البحث النصي | البحث عن الأماكن استنادًا إلى سلسلة نصية عامة. | ابحث عن نص مثل: "أفضل المطاعم الإيطالية في شيراز". |
| البحث عن الأماكن القريبة | ابحث عن الأماكن بناءً على القرب من نقطة محددة ونوع المكان. | عرض جميع "محطات الوقود" أو "المقاهي" ضمن دائرة نصف قطرها 5 كم من المستخدم. |
| تفاصيل المكان | احصل على معلومات كاملة وشاملة حول مكان ما بناءً على معرفه الفريد (معرف المكان). | إظهار العنوان الكامل للمطعم ورقم الهاتف والتقييمات وساعات العمل والمراجعات. |
| صور المكان | يمكنك الوصول إلى ملايين الصور عالية الجودة المخزنة للأماكن. | عرض معرض صور لفندق أو مركز تسوق في تطبيق السفر. |
مشاريع وحلول نموذجية (حالات الاستخدام)
تتيح لك واجهة برمجة التطبيقات هذه تنفيذ مجموعة واسعة من الإمكانيات المستندة إلى الموقع:
- التجارة الإلكترونية والتوصيل: تمكين الميزة إكمال تلقائي دقيق للعناوين للمستخدمين عند تقديم طلب أو إضافة عنوان جديد (باستخدام الإكمال التلقائي وتفاصيل المكان).
- السفر والسياحة: إنشاء دليل محلي نقاط الاهتمام القريبة (البحث القريب) يعرض الفنادق أو المعالم السياحية ويقدم تفاصيلها الكاملة (تفاصيل المكان).
- تطبيقات الشبكات المحلية: مساعدة المستخدمين على “"تحقق في"” ممارسة الأعمال التجارية في الشركات القريبة.
- البحث عن وكالة وخدمات: عرض موقع جميع فروع سلسلة المتاجر أو محلات الإصلاح المعتمدة على الخريطة وتوفير معلومات الاتصال الخاصة بهم.
- تحسين البيانات: إثراء قاعدة البيانات الداخلية للشركة ببيانات موحدة (مثل معرف المكان والعنوان الدقيق) من Google.
المشاريع الناجحة وتطبيقات المستخدم
تستخدم معظم التطبيقات والمواقع التي تحتاج إلى التفاعل مع الخرائط والمواقع هذه الخدمة. أي منصة توفر حقل بحث ذكي عن العناوين، أو تقترح أماكن قريبة، أو تعرض تفاصيل الشركة، من المرجح أنها تستخدم واجهة برمجة تطبيقات الأماكن.
- خدمات سيارات الأجرة عبر الإنترنت (مثل Uber/Lyft): استخدم الإكمال التلقائي لإدخال الأصل والوجهة بسرعة ودقة.
- منصات حجز السفر (مثل Expedia وBooking.com): عرض معلومات شاملة عن الفنادق والمعالم السياحية.
- تطبيقات توصيل الطعام والمتاجر عبر الإنترنت: تأكيد عنوان التسليم واقتراح المتاجر القريبة.
عينة الكود (مثال البحث القريب)
للبحث عن الأماكن القريبة (البحث القريب) إلى نقطة معينة، يمكنك استخدام طلب HTTP بسيط (على الرغم من أنه يوصى باستخدام مكتبات عملاء Google للغات المختلفة).
الهيكل العام لطلب البحث القريب (واجهة برمجة تطبيقات خدمة الويب):
https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&type=restaurant&key=YOUR_API_KEYشرح المعلمات:
- موقع: الإحداثيات الجغرافية لمركز البحث (خطوط العرض والطول).
- نصف القطر: نصف قطر البحث بالأمتار (في هذا المثال 500 متر).
- يكتب: نوع الموقع المطلوب (على سبيل المثال
مطعم). - مفتاح: مفتاح API الخاص بك.
هيكل التكلفة والتسعير
منصة خرائط جوجل من نموذج الدفع حسب الاستخدام ويترتب على ذلك أنه بناءً على وحدة حفظ المخزون (SKU) أو يتم حساب نوع الطلب.
| نوع الطلب (SKU) | هيكل التكلفة | النقطة الرئيسية |
| طلبات الإكمال التلقائي | بناءً على عدد الطلبات | كلما زاد عدد الطلبات، كلما انخفضت التكلفة لكل 1000 طلب. |
| تفاصيل المكان | بناءً على تلقي تفاصيل مكان مع معرف المكان | إنها أكثر تكلفة من البحث البسيط لأنها تؤدي إلى استرجاع المزيد من البيانات. |
| البحث النصي/القريب | بناءً على عدد عمليات البحث | تختلف الأسعار حسب SKU (Essentials أو Pro). |
- رصيد شهري مجاني: تحدد Google مبلغًا معينًا كل شهر بشكل افتراضي. ميزة المكالمات المجانية يُوفر للمستخدمين رصيدًا بقيمة 200 دولار أمريكي لكل وحدة تخزين (يحل هذا محل الرصيد السابق بقيمة 200 دولار أمريكي). في حالات الكميات المنخفضة أو التطوير، غالبًا ما يكون هذا الرصيد كافيًا.
- نقطة مهمة في التكلفة: لتقليل تكاليف البحث، استخدم دائمًا إخفاء الحقل استخدم. أي في الطلبات
تفاصيل المكانأويبحث، الحقول فقط (يحبمقاس,عنوان منسقاطلب ما تحتاج إليه حقًا.
لمزيد من المعلومات حول التنفيذ والبرمجة، يمكنك مشاهدة الفيديو أدناه. يُقدّم هذا الفيديو مقدمةً للإصدار الجديد من واجهة برمجة تطبيقات الأماكن، والذي يُمكن أن يُساعدك على فهم أحدث التغييرات والتحديثات.
للحصول على API_Key، يمكنك الاتصال بالدعم. شركة التجارة المستدامة الإيرانية قم بزيارة أو الحصول على المشورة عبر الهاتف.



