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