تتوافق حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android مع تفاصيل الأماكن الحالية. إذا كنت على دراية بحزمة تطوير البرامج (SDK) الحالية لنظام التشغيل Android من Places، يُجري الإصدار الجديد من تفاصيل الأماكن التغييرات التالية:
يستخدم نموذج أسعار جديدًا. للحصول على معلومات حول أسعار جميع واجهات برمجة التطبيقات، يُرجى الاطّلاع على حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Places (جديد).
يجب بدء تشغيل تطبيقك من خلال استدعاء الأسلوب
Places.initializeWithNewPlacesApiEnabled(). لمزيد من المعلومات عن اختيار خدمة Places API، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.يجب استخدام ميزة إخفاء الحقول. يجب تحديد الحقول التي تريد عرضها في الاستجابة. لا تتوفّر قائمة تلقائية بالحقول المعروضة. في حال حذف هذه القائمة، ستعرض الطرق خطأ.
توضِّح الأقسام التالية التغييرات الإضافية.
الوصول إلى أنواع أماكن جديدة
يمكن أن يكون لكل مكان قيمة type واحدة أو أكثر مرتبطة به. يضيف الإصدار 3.3.0 من "حزمة تطوير البرامج (SDK) لأماكن Google" لنظام التشغيل Android والإصدارات الأحدث العديد من القيم الجديدة لأنواع المواقع الجغرافية. للاطّلاع على القائمة الكاملة، يُرجى الاطّلاع على أنواع الأماكن الموسّعة.
تُعيد الطريقة
Place.getPlaceTypes()
قيم النوع كقائمة من قيم السلاسل. القيم المعروضة
تعتمد على إصدار حزمة Places SDK لنظام التشغيل Android:
حزمة SDK لأماكن Google لنظام التشغيل Android (جديد): تعرض السلاسل المحدّدة في جدولَي A وB اللذَين يظهران في أنواع الأماكن (جديد)، بما في ذلك كل أنواع الأماكن المُضافة في الإصدار 3.3.0.
حزمة SDK لتطبيق "الأماكن" لنظام التشغيل Android: تعرض هذه الحزمة القوائم المحدّدة من قِبل
Place.Types، والتي لا تتضمّن الأنواع الجديدة التي تمت إضافتها في الإصدار 3.3.0 والإصدارات الأحدث.
الوصول إلى مراجعات الأماكن
تضيف حزمة تطوير البرامج (SDK) لأماكن Android (الإصدار الجديد) فئة
Review
التي تحتوي على مراجعة لمكان. يمكن أن يحتوي العنصر Place على ما يصل إلى
خمس مراجعات.
يمكن أن تحتوي فئة Review أيضًا على مصدر وإشارة إلى المؤلف. إذا
عرضت المراجعة في تطبيقك، يجب أيضًا عرض أي مصدر
أو مصدر المؤلف. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة عرض مراجعة.
لمزيد من المعلومات، يُرجى الاطّلاع على المستندات المتعلّقة بموضوع الإحالات.
الوصول إلى رمز لغة اسم المكان
تُعرِض الطريقة
Place.getName()
الحالية سلسلة نصية تحتوي على اسم مكان. لملء عنصر
Place باسم المكان، يجب تضمين
Place.Field.DISPLAY_NAME في قائمة الحقول لطلب تفاصيل المكان.
يحتوي عنصر Place الآن على رمز اللغة لسلسلة الاسم. لتحميل رمز اللغة في عنصر Place، عليك إجراء ما يلي:
أدرِج
Place.Field.DISPLAY_NAMEفي قائمة حقول الطلب. تعمل هذه القيمة على ضبط الاستجابة لتضمين اسم المكان ورمز اللغة في عنصرPlace.يُرجى الاتصال بالرقم
PlacesClient.fetchPlace(). لا يتيحPlacesClient.findCurrentPlace()حقل رمز اللغة.استخدِم الطريقة
Place.getNameLanguageCode()للوصول إلى حقل رمز اللغة في عنصرPlace.
ضبط رمز المنطقة
تضيف حزمة تطوير البرامج (SDK) لتطبيق "الأماكن" لنظام التشغيل Android (الإصدار الجديد) مَعلمة طلب رمز المنطقة إلى تفاصيل الأماكن. يُستخدَم رمز المنطقة لتنسيق الردّ، ويتم تحديده على أنّه قيمة رمز CLDR مكوّن من حرفَين. يمكن أن تؤثر هذه المَعلمة أيضًا في نتائج البحث. ليس هناك قيمة تلقائية. يجب تفعيل حزمة SDK الجديدة لضبط رمز المنطقة.
إذا كان اسم البلد في حقل العنوان في الاستجابة يتطابق مع رمز المنطقة، يتم حذف رمز البلد من العنوان.
تتطابق معظم رموز CLDR مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو "uk" (.co.uk)، بينما رمزه وفقًا لمعيار ISO 3166-1 هو "gb" (من الناحية الفنية للكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.
مثال على الطلب
للحصول على مثال كامل، اطّلِع على تفاصيل المكان (جديد).