تتيح حزمة تطوير برامج "الأماكن" لأجهزة Android استخدام تفاصيل الأماكن الحالية. إذا كنت على دراية بحزمة Places SDK الحالية لنظام التشغيل Android، يُجري الإصدار الجديد من تفاصيل الأماكن التغييرات التالية:
يستخدم نموذج أسعار جديدًا. للحصول على معلومات حول أسعار جميع واجهات برمجة التطبيقات، يُرجى الاطّلاع على حزمة SDK لتطبيق "الأماكن" لنظام التشغيل Android (جديد).
يجب بدء تشغيل تطبيقك من خلال استدعاء الأسلوب
Places.initializeWithNewPlacesApiEnabled(). لمزيد من المعلومات عن اختيار خدمة Places API، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.يجب إخفاء الحقول. يجب تحديد الحقول التي تريد عرضها في الاستجابة. لا تتوفّر قائمة تلقائية بالحقول المعروضة. في حال حذف هذه القائمة، ستعرض الطرق خطأ.
توضِّح الأقسام التالية تغييرات إضافية.
الوصول إلى أنواع أماكن جديدة
يمكن أن يكون لكل مكان قيمة type واحدة أو أكثر مرتبطة به. يضيف الإصدار 3.3.0 من "حزمة تطوير البرامج (SDK) لأماكن Google" لنظام التشغيل Android والإصدارات الأحدث العديد من القيم الجديدة لأنواع المواقع الجغرافية. للحصول على القائمة الكاملة، اطّلِع على أنواع الأماكن الموسّعة.
تُرجِع الطريقة
Place.getPlaceTypes()
قيم النوع كقائمة من قيم السلاسل. تعتمد القيم المعروضة
على إصدار حزمة تطوير برامج "الأماكن" لأجهزة Android:
حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل Android (جديد): تعرض السلاسل المحدّدة في جدولَي "أ" و"ب" اللذَين يظهران في أنواع الأماكن (جديد)، بما في ذلك كل أنواع الأماكن المُضافة في الإصدار 3.3.0.
حزمة تطوير برامج "الأماكن" لأجهزة Android: تعرض هذه الحزمة القوائم المحدّدة من قِبل
Place.Types، والتي لا تتضمّن الأنواع الجديدة التي تمت إضافتها في الإصدار 3.3.0 والإصدارات الأحدث.
الوصول إلى مراجعات الأماكن
تضيف حزمة تطوير برامج "الأماكن" لنظام التشغيل 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.
ضبط رمز المنطقة
تضيف حزمة تطوير برامج "الأماكن" لنظام التشغيل Android (الإصدار الجديد) مَعلمة طلب رمز المنطقة إلى تفاصيل المكان. يتم استخدام رمز المنطقة لتنسيق الاستجابة، ويتم تحديده على أنّه قيمة رمز CLDR مكوّن من حرفَين. يمكن أن تؤثر هذه المَعلمة أيضًا في نتائج البحث. ليس هناك قيمة تلقائية. يجب تفعيل حزمة تطوير البرامج (SDK) الجديدة لضبط رمز المنطقة.
إذا كان اسم البلد في حقل العنوان في الاستجابة يتطابق مع رمز المنطقة، يتم حذف رمز البلد من العنوان.
تتطابق معظم رموز CLDR مع رموز ISO 3166-1، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو "uk" (.co.uk)، بينما رمزه وفقًا لمعيار ISO 3166-1 هو "gb" (من الناحية الفنية للكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.
مثال على الطلب
للحصول على مثال كامل، يُرجى الاطّلاع على تفاصيل المكان (جديد).