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