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