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