"خرائط Google" لمكتبة Android Utility

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

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

للاطّلاع على تفاصيل، راجِع المستندات على أداة GeoJSON المساعدة في "خرائط Google" لنظام التشغيل Android.

استيراد ملف KML إلى الخريطة

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

للاطّلاع على تفاصيل، راجِع المستندات على أداة KML لنظام التشغيل Android في "خرائط Google".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يُرجى الرجوع إلى الوثائق المرجعية للحصول على قائمة كاملة بالطرق في الأداة.

تحقَّق مما إذا كان أحد المواقع الجغرافية متاحًا في ميزة "التجوّل الافتراضي".

توفّر الفئة StreetViewUtil وظيفة تتيح التحقق مما إذا كان الموقع الجغرافي متاحًا في ميزة "التجوّل الافتراضي". يمكنك تجنب الأخطاء عند إضافة بانوراما التجوّل الافتراضي إلى تطبيق Android من خلال استدعاء أداة البيانات الوصفية هذه وإضافة بانوراما التجوّل الافتراضي فقط إذا كانت الاستجابة OK.

لمعرفة التفاصيل، يُرجى الاطّلاع على المستندات في أداة البيانات الوصفية لميزة "التجوّل الافتراضي" على GitHub.