Java Android Overlay Android Mapview

كيفية استخدام ItemizedOverlay و OverlayItem بكفاءة في Android Beta 0.9

إذا كنت مطورًا يعمل مع Android، فقد تواجه تحديات عند محاولة تنفيذ ميزات ItemizedOverlay و OverlayItem في تطبيقات الخرائط الخاصة بك، وخاصة في Android Beta 0.9. يهدف هذا المقال إلى استكشاف مشكلة شائعة في هذا السياق وتقديم حل مفصل سيساعدك على تشغيل تلك العلامات على الخريطة بسلاسة.

المشكلة

عند محاولة استخدام ItemizedOverlay لإنشاء علامات على خريطتك (مماثلة لتلك التي تُرى في خرائط جوجل)، قد تكون قد لاحظت أن العلامات لا تظهر كما هو متوقع. إليك السيناريو الذي قد تكون مألوفًا به:

  • لقد قمت بإعداد صف MyItemizedOverlay الذي يمتد من ItemizedOverlay.
  • عندما تحاول إضافة هذا التراكب إلى MapView الخاص بك، لا تظهر أي علامات على الرغم من استخراج OverlayItems بنجاح.

إليك مقتطف من التعليمات البرمجية التي قد تستخدمها لإضافة التراكب:

private void addItemizedOverlay() {
  Resources r = getResources();
  MapView mapView = (MapView)findViewById(R.id.mymapview);
  List<Overlay> overlays = mapView.getOverlays();

  MyItemizedOverlay markers = new MyItemizedOverlay(r.getDrawable(R.drawable.icon));
  overlays.add(markers);

  OverlayItem oi = markers.getItem(0);
  markers.setFocus(oi);
  mapView.postInvalidate();
}

تعريف الصف

يمكن تعريف صف MyItemizedOverlay الخاص بك كما يلي:

public class MyItemizedOverlay extends ItemizedOverlay<OverlayItem> {
  public MyItemizedOverlay(Drawable defaultMarker) {
    super(defaultMarker);
    populate();
  }

  @Override
  protected OverlayItem createItem(int index) {
    Double lat = (index + 37.422006) * 1E6;
    Double lng = -122.084095 * 1E6;
    GeoPoint point = new GeoPoint(lat.intValue(), lng.intValue());

    OverlayItem oi = new OverlayItem(point, "Marker", "Marker Text");
    return oi;
  }

  @Override
  public int size() {
    return 5;
  } 
}

الحل: تعيين الحدود لدرافتك

تتواجد المشكلة الرئيسية غالبًا في عدم وجود حدود محددة للـ Drawable المرتبطة بعلاماتك. إليك كيفية حل ذلك:

الخطوة 1: تعيين حدود الدرافت

قبل إضافة ItemizedOverlay الخاص بك، تأكد من تحديد الحدود لدرافتك. هذا مهم للغاية لأن طريقة draw للدرافت تعتمد على هذه الحدود لتظهر بشكل صحيح على القماش. إليك كيفية القيام بذلك:

Drawable defaultMarker = r.getDrawable(R.drawable.icon);

// تعيين الحدود لدرافتك
defaultMarker.setBounds(0, 0, defaultMarker.getIntrinsicWidth(),
    defaultMarker.getIntrinsicHeight());

MyItemizedOverlay markers = new MyItemizedOverlay(defaultMarker);
overlays.add(markers);

لماذا تعتبر الحدود مهمة؟

  • آلية الريندرينغ: تُرسم العلامات من خلال الطريقة Drawable.draw(Canvas)، التي تتطلب تحديد الحدود لتعرف الدرافت أين تظهر نفسها على القماش.
  • الرؤية: بدون حدود صحيحة، قد لا تظهر علاماتك على الخريطة، مما يؤدي إلى الارتباك أثناء عملية التطوير.

موارد إضافية

للمزيد من الإشارات والمشي على الدرب بالتفصيل، يمكنك الاطلاع على الموارد التالية:

الخاتمة

من خلال تعيين الحدود لدرافتك بشكل صحيح، يجب أن تجد أن ItemizedOverlay يعمل كما هو مقصود، مما يعرض العلامات على خريطتك. هذا الإصلاح ضروري للمطورين الذين يواجهون مشكلات مشابهة في Android Beta 0.9، مما يضمن تجربة تطوير أكثر سلاسة أثناء تنفيذ ميزات الخرائط في تطبيقاتك.

إذا كان لديك أي أسئلة إضافية أو كنت ترغب في مشاركة تجاربك مع تنفيذ ItemizedOverlay، فلا تتردد في التعليق أدناه!