النقل إلى تفاصيل المكان (جديد)

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

تتيح حزمة تطوير برامج الأماكن لأجهزة Android استخدام تفاصيل المكان (الإصدار القديم). إذا كنت على دراية بحزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل Android (الإصدار القديم)، سيتم إجراء التغييرات التالية على تفاصيل المكان (الإصدار الجديد):

  • يستخدم نموذج أسعار جديدًا. للاطّلاع على معلومات الأسعار الخاصة بجميع واجهات برمجة التطبيقات، يُرجى الرجوع إلى Places SDK لنظام التشغيل Android (إصدار جديد).

  • يجب تهيئة تطبيقك من خلال استدعاء الطريقة Places.initializeWithNewPlacesApiEnabled(). لمزيد من المعلومات حول اختيار خدمة Places API، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud.

  • يجب إخفاء الحقل. يجب تحديد الحقول التي تريد عرضها في الرد. لا توجد قائمة تلقائية بالحقول التي يتم عرضها. إذا حذفت هذه القائمة، ستعرض الطرق رسالة خطأ.

توضّح الأقسام التالية تغييرات إضافية.

الوصول إلى أنواع أماكن جديدة

يمكن أن يتضمّن كل مكان قيمة نوع واحدة أو أكثر مرتبطة به. يضيف الإصدار 3.3.0 والإصدارات الأحدث من Places SDK for Android العديد من قيم الأنواع الجديدة. للاطّلاع على القائمة الكاملة، راجِع أنواع الأماكن الموسّعة.

تعرض الطريقة Place.getPlaceTypes() قيم النوع كقائمة من قيم السلسلة. تعتمد القيم المعروضة على إصدار حزمة تطوير البرامج (SDK) الخاصة بـ "أماكن Google" لنظام التشغيل Android:

  • حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل Android (جديدة): تعرض السلاسل المحدّدة في الجدول "أ" والجدول "ب" الواردَين في أنواع الأماكن (جديدة)، بما في ذلك جميع أنواع الأماكن المضافة في الإصدار 3.3.0.

  • حزمة تطوير البرامج للأماكن في Android: تعرض القيم التعدادية المحدّدة بواسطة Place.Types، والتي لا تتضمّن الأنواع الجديدة التي تمت إضافتها في الإصدار 3.3.0 والإصدارات الأحدث.

الوصول إلى مراجعات الأماكن

تضيف حزمة تطوير البرامج (SDK) الجديدة الخاصة بخدمة Places API لنظام التشغيل Android الفئة Review، التي تحتوي على مراجعة لمكان. يمكن أن يحتوي العنصر Place على ما يصل إلى خمس مراجعات.

يمكن أن يحتوي الصف Review أيضًا على معلومات تحديد المصدر ومعلومات تحديد مؤلف المحتوى. إذا عرضت المراجعة في تطبيقك، يجب أيضًا عرض أي معلومات مصدر أو معلومات عن المؤلف. لمزيد من المعلومات، يُرجى الاطّلاع على عرض مراجعة.

لمزيد من المعلومات، يُرجى الاطّلاع على المستندات المتعلقة بالمراجع.

رمز لغة اسم المكان الذي يمكن الوصول إليه

في حزمة تطوير البرامج (SDK) القديمة الخاصة بـ Places API لنظام التشغيل Android، تعرض الطريقة Place.getName() سلسلة نصية تحتوي على اسم مكان. لتعبئة الكائن Place باسم المكان، يجب تضمين Place.Field.DISPLAY_NAME في قائمة الحقول الخاصة بطلب تفاصيل المكان.

يحتوي العنصر Place الآن على رمز اللغة لسلسلة الاسم. لإضافة رمز اللغة إلى الكائن Place، عليك اتّباع الخطوات التالية:

  1. أدرِج Place.Field.DISPLAY_NAME في قائمة الحقول الخاصة بالطلب. تضبط هذه القيمة الردّ لتضمين كل من اسم المكان ورمز اللغة في الكائن Place.

  2. اتّصِل على PlacesClient.fetchPlace(). لا يتيح PlacesClient.findCurrentPlace() استخدام حقل رمز اللغة.

  3. استخدِم طريقة Place.getNameLanguageCode() للوصول إلى حقل رمز اللغة في عنصر Place.

ضبط رمز المنطقة

تضيف حزمة تطوير البرامج (SDK) الجديدة الخاصة بـ "الأماكن في Android" مَعلمة طلب رمز المنطقة إلى "تفاصيل المكان". يتم استخدام رمز المنطقة لتنسيق الاستجابة، ويتم تحديده كقيمة رمز CLDR مكوّن من حرفَين. يمكن أن يكون لهذه المَعلمة أيضًا تأثير متحيز على نتائج البحث. لا توجد قيمة تلقائية. يجب تفعيل حزمة SDK الجديدة لضبط رمز المنطقة.

إذا كان اسم البلد في حقل العنوان في الرد يتطابق مع رمز المنطقة، سيتم حذف رمز البلد من العنوان.

تتطابق معظم رموز CLDR مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، نطاق المستوى الأعلى لرمز البلد في المملكة المتحدة هو "uk" (.co.uk)، بينما رمز ISO 3166-1 هو "gb" (وهو يشير تقنيًا إلى "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.

مثال على الطلب

للاطّلاع على مثال كامل، راجِع تفاصيل المكان (الإصدار الجديد).