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