استخدام حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android الإصدار 3.1.0 التجريبي

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

  • تخصيص "خرائط Google"
  • التعامل مع تصادم العلامات
  • تخصيص الخطوط المتعددة

يوضّح لك هذا الدليل كيفية استخدام الميزات الجديدة.

تخصيص "الخرائط" (إصدار تجريبي)

يوفّر تصميم الخرائط المستنِد إلى السحابة الإلكترونية مجموعة متنوّعة من الأدوات والميزات التي تتيح لك تخصيص طريقة تصميم خرائطك وإدارتها بسهولة أكبر. بدلاً من تصميم خريطتك في الرمز البرمجي باستخدام واجهات برمجة التطبيقات ومجموعات تطوير البرامج (SDK) في "خرائط Google"، يمكنك إدارة و تصميم خرائطك في Google Cloud Console. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على تخصيص "خرائط Android".

معالجة تصادم العلامات (إصدار تجريبي)

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

تخصيص الخطوط المتعددة (إصدار تجريبي)

تتوفّر الآن عدة طرق جديدة لتخصيص مظهر الخطوط المتعددة:

  • الخطوط المتعددة الملوّنة: تضبط أجزاء الخطوط المتعددة ألوانًا مختلفة.
  • الخطوط المتعددة المتدرجة: تُلوّن خطًا متعددًا باستخدام تدرج لوني من لونَين.
  • الخطوط المتعددة المُختمة: تنشئ نمطًا لخط متعدد باستخدام ملفات رسومات نقطية متكررة.

إنشاء خط متعدد الخطوط متعدد الألوان

يمكنك استخدام الفواصل لتلوين أجزاء من الخط المتعدّد بشكلٍ فردي، وذلك عن طريق إنشاء عناصر StyleSpan وإضافتها إلى PolylineOptions باستخدام الطريقتَين addSpan() أو addSpans(). سيحدّد كل عنصر في الصفيف تلقائيًا لون القطعة المستقيمة المقابلة.

إنشاء خط متعدد الأضلاع متدرّج

يمكنك تحديد مخطط متدرّج من خلال تحديد عددَين صحيحَين من النوع ARGB (أحمر وأخضر وأزرق وشفافية) بسعة 32 بت لتحديد ألوان بداية العنصر ونهايته. اضبط هذه السمة على عنصر خيارات الشكل من خلال استدعاء PolylineOptions.addSpan().

إنشاء خط متعدد مُختم

يمكنك ضبط مظهر الخط المتعدّد على نسيج ملفّ رسومات نقطية متكرّر. لتنفيذ هذا، أنشئ StampStyle من TextureStyle، ثم اضبط هذه السمة على عنصر خيارات الشكل من خلال استدعاء PolylineOptions.addSpan().

استيراد مكتبة الخدمات المتوافقة مع الإصدار التجريبي

إذا كنت تستخدِم مكتبة أدوات Google Maps Android API، عليك أيضًا تعديل التبعيات في مشروعك لاستبدال الإصدار الحالي بالإصدار المتوافق مع الإصدار التجريبي من خلال اتّباع الخطوات التالية:

  1. استورِد مكتبة util المتوافقة مع الإصدار التجريبي في ملف build.gradle: 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. عليك إزالة ما يلي من build.gradle لإزالة مكتبة الأدوات غير المتوافقة مع الإصدار التجريبي: 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

تشغيل العيّنات

يتضمّن مستودع "عيّنات Google" على GitHub عيّنات من التطبيقات التي توضّح استخدام الإصدار التجريبي 3.1.0 من حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android.