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

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

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

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

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

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

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

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

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

لمعرفة التفاصيل، يُرجى الاطّلاع على المستندات على أداة خريطة التمثيل اللوني لأجهزة Android في "خرائط 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) الخاصة بـ "خرائط Google" لـ Android Utility Library من أجل ترميز تسلسل لإحداثيات خطوط الطول والعرض ("LatLngs") في سلسلة مسار مشفَّر، وفك ترميز سلسلة مسار مرمّز إلى تسلسل من خطوط الطول والعرض. سيضمن ذلك إمكانية التشغيل التفاعلي مع خدمات الويب لواجهات برمجة التطبيقات لخرائط Google.

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

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

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

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

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

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

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