توفّر Places API (الجديدة) أداءً محسّنًا ووظائف إضافية مقارنةً بـ Places API (القديمة). يمكنك استخدام هذا الدليل لفهم الاختلافات الرئيسية بين إصدارَي Places API، بالإضافة إلى كيفية التعامل مع التغييرات اللازمة. لمزيد من التفاصيل حول ميزات Places API (الجديدة) الأخرى، يُرجى الاطّلاع على نظرة عامة على المنتج.
الميزات الرئيسية التي تمت إضافتها إلى Places API (الإصدار الجديد)
يتناول هذا القسم الميزات الرئيسية التي تمت إضافتها إلى Places API (الإصدار الجديد).
تم تنفيذها على منصة Google Cloud العادية
يتم تنفيذ Places API (الجديدة) على البنية الأساسية للخدمة
على Google Cloud يوفّر هذا التنفيذ منصة أكثر أمانًا وموثوقية مع خيارات أمان محسّنة مثل OAuth. يوفّر تصميم واجهة برمجة التطبيقات العادي هذا مستوى من الاتساق في جميع واجهات برمجة التطبيقات التي تحسّن كفاءة التطوير باستخدام Places API (الإصدار الجديد).
تحسين الأداء
توفّر واجهة برمجة التطبيقات Places API (الجديدة) أداءً محسّنًا، ما يجعلها جديرة بالاهتمام لاستبدال التطبيقات التي تستخدم واجهة برمجة التطبيقات Places API الحالية.
أسعار مبسّطة
تم تبسيط الأسعار في Places API (الإصدار الجديد) بحيث لا تدفع إلا مقابل البيانات التي تستخدمها. يتم تنفيذ التسعير المبسّط باستخدام قناع حقل.
باستخدام ميزات "تفاصيل المكان (جديدة)" و"البحث في الجوار (جديدة)" و"البحث النصي (جديدة)"، يمكنك استخدام قناع الحقل للتحكّم في قائمة الحقول التي يتم عرضها في الاستجابة. بعد ذلك، يتم تحصيل رسوم منك مقابل البيانات المطلوبة فقط. يُعدّ استخدام قناع الحقل من الممارسات الجيدة في التصميم لضمان عدم طلب بيانات غير ضرورية، ما يساعد في تجنُّب وقت المعالجة غير الضروري ورسوم الفوترة.
بيانات استجابة متّسقة لمكان معيّن
باستخدام واجهات برمجة التطبيقات القديمة، عرضت واجهات برمجة التطبيقات Place Details (القديمة) وNearby Search (القديمة) وText Search (القديمة) بيانات استجابة مختلفة لمكان معيّن. تعمل واجهة برمجة التطبيقات Places API (الجديدة) على توحيد الاستجابة، بحيث تعرض جميع واجهات برمجة التطبيقات هذه البيانات نفسها لمكان معيّن.
أنواع الأماكن الموسّعة
يمكن أن يتضمّن الردّ من واجهة برمجة التطبيقات الآن النوع الأساسي للمكان. يمكن أن يكون لكل مكان قيمة نوع واحدة يتم تحديدها على أنّها النوع الأساسي للمكان، كما هو موضّح في الجدول "أ".
تتضمّن واجهة برمجة التطبيقات الجديدة أيضًا عدة أنواع جديدة. يمكنك استخدام هذه الأنواع الجديدة والأنواع الحالية في عملية بحث باستخدام "البحث في الجوار (الجديد)" و"البحث النصي (الجديد)". يتم تضمين جميع الأنواع الجديدة في الجدول أ.
بيانات الأماكن الديناميكية
تتيح واجهة Places API (الجديدة) استخدام بيانات الاستجابة الديناميكية، مثل مدى توفّر محطة شحن للمركبات الكهربائية أو أحدث أسعار الوقود في محطة وقود. استخدِم حقول الردود هذه لإنشاء تجارب مستخدم ديناميكية.