استخدام حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" للإصدار التجريبي من الإصدار 3.1.0 (Android)

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

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

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

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

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

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

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

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

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

  • الخطوط المتعددة الألوان تعيين أجزاء الخطوط المتعددة إلى ألوان مختلفة.
  • خطوط متدرجة لتلوين الخط المتعدد باستخدام تدرج لونين.
  • الخطوط المتعددة المختومة تحدد نمط الخطوط المتعددة باستخدام الصور النقطية المتكررة.

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

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

لغة Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

      

Kotlin


val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

      

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

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

لغة Java


Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

      

Kotlin


val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

      

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

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

لغة Java


StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

      

Kotlin


val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

      

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

إذا كنت تستخدم مكتبة أدوات واجهة برمجة تطبيقات Android لخرائط Google، فستحتاج أيضًا إلى تحديث تبعيات مشروعك لاستبدال الإصدار الحالي بالإصدار المتوافق مع الإصدار التجريبي من خلال تنفيذ ما يلي:

  1. استورد مكتبة الأدوات المتوافقة المتوافقة مع الإصدار التجريبي في ملف 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 نماذج تطبيقات توضّح استخدام الإصدار التجريبي من "حِزمة تطوير البرامج" (SDK) للخرائط بالإصدار v3.1.0 لنظام التشغيل Android.