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