حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمكتبة Android Utility

اختيار النظام الأساسي: Android iOS

هل تبحث عن الميزات المتقدمة لإضافتها إلى خرائطك؟ إن Maps SDK for Android Utility Library هي مكتبة مفتوحة المصدر للصفوف مفيدة. يحتوي مستودع GitHub على فئات برامج الخدمات والتطبيقات التجريبية التي توضّح استخدام كل صف.

في هذا الفيديو، يناقش "كريس برودفوت" مكتبة الأدوات، مع التركيز على فك ترميز الخطوط المتعددة وهندسة التصميم الكرتوني ورموز الفقاعات.

إعداد سريع

لتثبيت"حزمة تطوير البرامج" (SDK) لخدمة"خرائط Google"لمكتبة Android Utility، اتّبِع دليل الإعداد.

المرافق

خريطة باستخدام طبقة GeoJSON

استيراد GeoJSON إلى خريطتك

يمكنك تخزين الميزات بتنسيق GeoJSON واستخدام هذه الأداة لعرضها كطبقة على الخريطة. يمكنك طلب addLayer() لإضافة بيانات GeoJSON إلى الخريطة. يمكنك أيضًا إضافة ميزات فردية من خلال استدعاء addFeature()، مع تمرير كائن GeoJsonFeature.

ولمعرفة التفاصيل، يمكنك الاطّلاع على المستندات حول "خرائط Google " Android GeoJSON Utility.

خريطة باستخدام طبقة KML

استيراد KML إلى خريطتك

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

للاطّلاع على التفاصيل، يُرجى الاطّلاع على الوثائق بخصوص أداة KML لجهاز Android في "خرائط Google".

خريطة مع خريطة التمثيل اللوني

إضافة خرائط التمثيل اللوني إلى خريطتك

تسهّل خرائط التمثيل اللوني على المشاهدين فهم توزيع نقاط البيانات وكثافتها النسبية على الخريطة. بدلاً من وضع محدّد موقع في كل موقع جغرافي، تستخدم خرائط التمثيل اللوني اللون والشكل لتمثيل توزيع البيانات. يمكنك إنشاء HeatmapTileProvider، مع تمرير مجموعة من العناصر LatLng التي تمثل نقاط اهتمام على الخريطة. بعد ذلك، يمكنك إنشاء TileOverlay جديدة، وتمريرها إلى مزوّد مربّع خريطة التمثيل اللوني، وإضافة تراكب البطاقة إلى الخريطة.

للاطّلاع على التفاصيل، يُرجى الاطّلاع على الوثائق عن "أداة إدارة خريطة Android"في"خرائط Google".

خريطة تحتوي على رموز فقاعات

تخصيص العلامات من خلال رموز الفقاعة التفسيرية

يمكنك إضافة IconGenerator لعرض مقتطفات من المعلومات حول علاماتك. وتوفّر هذه الأداة طريقة تجعل رموز العلامات تشبه إلى حد ما نوافذ المعلومات، بحيث يمكن أن تحتوي العلامة نفسها على نص ومحتوى آخر. والميزة هي أنّه يمكنك إبقاء أكثر من علامة واحدة مفتوحة في الوقت نفسه، في حين يمكن فتح نافذة معلومات واحدة فقط في كل مرة. يمكنك أيضًا تغيير نمط العلامات، وتغيير اتجاه العلامة و/أو المحتوى، وتغيير صورة الخلفية للعلامة/التصحيح بتسعة.

خريطة تحتوي على علامات مجمّعة

إدارة مجموعات العلامات

يساعدك ClusterManager في إدارة علامات متعددة على مستويات تكبير/تصغير مختلفة. وهذا يعني أنّه يمكنك وضع عدد كبير من العلامات على الخريطة بدون صعوبة قراءة الخريطة. وعندما يشاهد المستخدم الخريطة عند مستوى تكبير/تصغير مرتفع، تظهر العلامات الفردية على الخريطة. عند تصغير المستخدم إلى مستوى تكبير/تصغير أقل، تتجمع العلامات معًا في مجموعات، لتسهيل عرض الخريطة.

للاطّلاع على التفاصيل، يُرجى الاطّلاع على الوثائق حول أداة تجميع علامات Android في "خرائط Google ".

خريطة بطبقات متعددة

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

يمكنك عرض ميزات من GeoJSON وKML والمجموعات، فضلاً عن العلامات الخاصة بك والخطوط المتعددة والمضلعات، كل ذلك على الخريطة نفسها. يمكن أيضًا جعل هذه الطبقات تفاعلية أيضًا من خلال إضافة أداة معالجة النقرات إلى كل طبقة. ما عليك سوى إنشاء مثيلات MarkerManager وGroundOverlayManager وPolygonManager وPolylineManager وتمريرها إلى تركيبات GeoJsonLayer وKmlLayer وClusterManager عند إعدادها. يمكنك بعد ذلك استخدام الصفوف Manager أعلاه مباشرةً لإضافة العلامات الخاصة بك والخطوط المتعددة والمضلعات إلى الخريطة.

للاطّلاع على التفاصيل، راجِع المستندات في العرض التوضيحي لطبقات متعددة من Android في "خرائط Google".

خريطة تحتوي على خط متعدد مشفّر

ترميز الخطوط المتعددة وفك ترميزها

يكون PolyUtil مفيدًا لتحويل الخطوط المتعددة والمضلعات المشفرة إلى إحداثيات خطوط الطول والعرض، والعكس صحيح.

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

يمكنك استخدام PolyUtil في حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لمكتبة Android Utility لترميز تسلسل إحداثيات خطوط الطول/العرض ('LatLngs') في سلسلة مسار مشفّرة، وفك ترميز سلسلة مسار مشفّرة في تسلسل LatLng. سيضمن هذا إمكانية التشغيل التفاعلي مع خدمات الويب في واجهات برمجة التطبيقات في "خرائط Google".

المسافة المحسوبة بين نقطتين على خريطة

احسب المسافات والمساحات والعناوين من خلال هندسة الكرات

باستخدام المرافق الهندسية الكروية في SphericalUtil، يمكنك حساب المسافات والمساحات والعناوين استنادًا إلى خطوط العرض والطول. في ما يلي بعض الطرق المتاحة في الأداة:

  • computeDistanceBetween() – تعرض المسافة، بالمتر، بين إحداثيات خط الطول/خط العرض.
  • computeHeading() – تعرض الحامل، بدرجات، بين إحداثيات خط الطول/خط العرض.
  • computeArea() – تعرض المنطقة بالمتر المربّع، ضمن مسار مغلق على الأرض.
  • interpolate(): تعرض إحداثيات خط الطول/نقطة النقطة التي تقع في جزء معيّن من المسافة بين نقطتَين معيّنتَين. يمكنك استخدام هذا المفتاح لتحريك علامة بين نقطتين مثلاً.

راجِع المستندات المرجعية للاطّلاع على قائمة كاملة بالطرق في الأداة.