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