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

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

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

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

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

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