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

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

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

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

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

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

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

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

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

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

  • الخطوط المتعددة الألوان تضبط القطاعات المتعددة الألوان على ألوان مختلفة.
  • تؤدي الخطوط المتعددة المتدرجة إلى تلوين متعدد الخطوط باستخدام تدرج لونين.
  • تنشئ الخطوط المتعددة المختومة نمطًا متعدد الخطوط باستخدام صور نقطية متكرّرة.

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

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

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))
)

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)));

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

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

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()
            )
        )
)

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())));

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

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

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)
)

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));

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

إذا كنت تستخدم مكتبة أدوات واجهة برمجة تطبيقات 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 يتضمن نماذج من التطبيقات التي توضح استخدام الإصدار 3.1.0 من حزمة تطوير البرامج (SDK) التجريبية لخرائط Android.