نظرة عامة على نقل البيانات

المطوّرون المقيمون في المنطقة الاقتصادية الأوروبية (EEA)

يسلّط هذا الدليل الضوء على الاختلافات الرئيسية بين خدمة "الأماكن" القديمة وفئة Place الجديدة. توفر الترقية إلى فئة Place مزايا كبيرة، بما في ذلك تحسين الأداء ونموذج تسعير جديد . للاستفادة إلى أقصى حدّ من خدمة "الأماكن" والتأكّد من أنّ تطبيقاتك محدّثة، يُرجى الاطّلاع على التغييرات الموضّحة في هذا الدليل.

أفضل الممارسات المتعلّقة بالفواتير لنقل البيانات

تنطبق هذه الإرشادات إذا كان استخدامك لواجهة برمجة التطبيقات مرتفعًا بما يكفي للانتقال إلى مستوى التسعير الثاني. عند نقل البيانات إلى إصدار أحدث من واجهة برمجة التطبيقات، يتم أيضًا تحصيل رسوم منك مقابل رمز تخزين تعريفي مختلف. لتجنُّب زيادة التكاليف خلال شهر الانتقال، ننصحك بالتبديل إلى واجهات برمجة التطبيقات الجديدة في مرحلة الإنتاج في أقرب وقت ممكن من بداية الشهر. سيضمن لك ذلك الوصول إلى مستويات التسعير الشهرية الأكثر فعالية من حيث التكلفة خلال شهر نقل البيانات. للحصول على معلومات حول مستويات التسعير، يُرجى الاطّلاع على صفحة الأسعار والأسئلة الشائعة حول الأسعار.

تفعيل واجهة برمجة التطبيقات Places API

تعتمد فئة Place على خدمة Places API. لاستخدام ميزات فئة Place الجديدة، يجب أولاً تفعيل Places API (الجديدة) في مشروع Google Cloud. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة البدء.

التغييرات العامة

يسرد الجدول التالي بعض الاختلافات الرئيسية بين PlacesService و Place:

PlacesService (قديمة) Place (جديدة)
تتطلّب الطرق استخدام ردّ نداء للتعامل مع عنصر النتائج و google.maps.places.PlacesServiceStatus ردّ. تستخدم Promises وتعمل بشكل غير متزامن.
تتطلّب الطرق إجراء عملية تحقّق من PlacesServiceStatus. لا تتطلّب عملية تحقّق من الحالة، ويمكن استخدام معالجة الأخطاء العادية.
يتم تنسيق حقول بيانات المكان باستخدام تنسيق snake case. يتم تنسيقحقول بيانات المكان باستخدام تنسيق camel case.
تقتصر على مجموعة ثابتة من أنواع الأماكن وحقول بيانات المكان. توفّر مجموعة موسّعة من أنواع الأماكن التي يتم تعديلها بانتظام place types وحقول place data fields.

التغييرات الخاصة بواجهة برمجة التطبيقات

توفّر فئة Place واجهة برمجة تطبيقات لاستخدام مكتبة "الأماكن"، وتتوافق مع أنماط الاستخدام الحديثة، مثل Promises. تعرض فئة Place حقول بيانات المكان وأنواع الأماكن نفسها التي تعرضها خدمة "الأماكن" القديمة، وتتضمّن العديد من القيم الجديدة لحقول بيانات المكان وأنواع الأماكن.

يوضّح هذا الجدول كيفية ربط ميزات خدمة "الأماكن" بميزات فئة Place:

خدمة "الأماكن" (قديمة) فئة Place (جديدة)
حقول بيانات المكان حقول بيانات فئة Place
أنواع الأماكن أنواع الأماكن
PlacesService.findPlaceFromQuery() Place.searchByText()
PlacesService.findPlaceFromPhoneNumber() Place.searchByText()
PlacesService.textSearch() Place.searchByText()
PlacesService.nearbySearch() Place.searchNearby()
PlacesService.getDetails() Place.fetchFields()
Places.AutocompletionRequest Places.AutocompleteRequest
Places.AutocompletePrediction Places.PlacePrediction
Autocomplete فئة PlaceAutocompleteElement فئة
SearchBox فئة ---

تحميل مكتبة "الأماكن"

تعتمد طريقة تحميل تطبيقك لمكتبة "الأماكن" على أداة تحميل التمهيد قيد الاستخدام. إذا كان تطبيقك يستخدم استيراد المكتبة الديناميكي، يمكنك تحميل المكتبات المطلوبة في وقت التشغيل باستخدام عامل التشغيل await لاستدعاء importLibrary()، كما هو موضّح هنا:

const { Place } = await google.maps.importLibrary("places");

إذا كان تطبيقك يستخدم علامة تحميل النص البرمجي المباشر، اطلب مكتبة places في النص البرمجي لأداة التحميل:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&libraries=places&callback=initMap">
</script>

مزيد من المعلومات حول تحميل Maps JavaScript API

يحتوي هذا القسم على الأدلة التالية لمساعدتك في نقل بيانات تطبيقاتك لاستخدام أحدث إصدار من Places API: