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