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