مقدمة
تتيح لك Places API البحث عن معلومات حول مجموعة متنوعة من أنواع الأماكن واستردادها باستخدام سلسلة نصية أو حسب القرب. Places API (الإصدار القديم) هو الإصدار القديم من 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 (New) على توحيد الاستجابة، وبالتالي تعرض جميع واجهات برمجة التطبيقات هذه البيانات نفسها الخاصة بمكان معيّن.
أنواع الأماكن الموسَّعة
يمكن أن يتضمّن ردّ واجهة برمجة التطبيقات الآن النوع الأساسي لمكان معيّن. يمكن أن يتضمّن كل مكان قيمة نوع واحدة يتم تحديدها كنوع أساسي للمكان، كما هو موضّح في الجدول أ.
تتضمّن واجهة برمجة التطبيقات الجديدة أيضًا عدة أنواع جديدة. يمكنك استخدام هذه الأنواع الجديدة والأنواع الحالية في عملية بحث باستخدام "البحث في الأماكن القريبة (جديد)" و"البحث النصي (جديد)". يتم تضمين الأنواع الجديدة كلها في الجدول أ.
بيانات الأماكن الديناميكية
تتيح Places API (New) بيانات استجابة ديناميكية، مثل مدى توفّر محطة شحن للمركبات الكهربائية أو أحدث أسعار الوقود في محطة وقود. استخدِم حقول الردود هذه لإنشاء تجارب ديناميكية للمستخدمين.