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

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

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

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

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

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

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

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

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

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

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

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

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

إنشاء خطوط متعدّدة متدرّجة

يمكنك تحديد تدرج من خلال تحديد عددَين صحيحَين من 32 بت من نوع alpha-red-green-blue (ARGB) لتحديد لونَي بداية الخط ونهايته. يمكنك ضبط هذه السمة في عنصر خيارات الشكل من خلال استدعاء 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'