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

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

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

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

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

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