تراكب صور علي الأرض

تراكب الأرض هو صورة يتم تثبيتها على الخريطة. يحتوي التراكب الأرضي على ما يلي المواقع:

الموضع

هناك طريقتان لتحديد موضع تراكب الأرض:

• استخدام موقع جغرافي: يجب تقديم صورة لطبقة الأرض، أو صورة LatLng الذي سيتم تثبيت علامة ارتساء عليه وعرض التراكب (بالأمتار). تشير رسالة الأشكال البيانية وهو بشكل افتراضي 50% من أعلى الصورة و50% من يسار . ويمكن تغيير هذه الإعدادات. يمكنك اختياريًا تقديم ارتفاع التراكب (في متر). في حال عدم توفير ارتفاع التراكب، سيتم تلقائيًا بشكل صحيح للحفاظ على نِسب الصورة.
• استخدام حدود: يجب توفير سمة LatLngBounds ستحتوي على الصورة.

يجب عليك تحديد موضع تراكب الأرض قبل إضافته إلى الخريطة، وبخلاف ذلك، سيتم طرح IllegalArgumentException عند تطبيق تراكب الأرض تمت إضافته إلى الخريطة. علاوة على ذلك، يجب تحديد الوظيفة باستخدام أحد هذه في الكائن GroundOverlayOptions؛ وإلا سيتم طرح IllegalStateException عند التحديد باستخدام طريقة ثانية.

صورة

الصورة (كصورة BitmapDescriptor) التي سيتم استخدامها لهذا التراكب. ستكون الصورة وقياسها لتناسب الوضع المقدم. يجب تحديد صورة قبل إضافة الأرض تراكب إلى الخريطة؛ وإذا لم يكن، سيتم طرح IllegalArgumentException عندما يكون تمت إضافته إلى الخريطة.

الاتجاه

مقدار تدوير الصورة في اتجاه عقارب الساعة. يمثل وسط سيكون تدوير الصورة ارتساء الصورة. وهذا أمر اختياري والقيمة الافتراضية هي 0، أي محاذاة الصورة بحيث تكون لأعلى باتجاه الشمال.

zIndex

الترتيب الذي يتم به رسم هذا التراكب الأرضي بالنسبة إلى التراكبات الأخرى (بما في ذلك Polyline وTileOverlay، ولكن ليس Marker). تراكب مع يتم رسم مؤشر zIndex الأكبر حجمًا على التراكبات ذات قيم zIndexs الأصغر. ترتيب التراكبات مع قيمة zIndex نفسها عشوائية. هذا اختياري وقيمة zIndex التلقائية هي 0.

الشفافية

شفافية تراكب الأرض في النطاق [0..1] حيث تعني 0 يكون التراكب معتمًا ويعني 1 أن التراكب شفاف بالكامل. إذا تم تحديد الصورة النقطية شفافة جزئيًا بالفعل، فسيتم قياس شفافية كل بكسل وفقًا لذلك (على سبيل المثال، إذا كانت قيمة ألفا للبكسل في الصورة النقطية 200 تحديد شفافية تراكب الأرض على أنها 0.25، فسيتم عرض البكسل على الشاشة بقيمة ألفا 150). تعتبر مواصفات هذه الخاصية اختيارية قيمة الشفافية التلقائية هي 0 (قيمة فارغة).

مستوى الرؤية

تشير إلى ما إذا كان تراكب الأرض مرئيًا أو غير مرئي، بمعنى ما إذا كان مرسومًا على الخريطة. لا يتم رسم تراكب أرضي غير مرئي، ولكنه يحتفظ بجميع خصائصه الأخرى. هذا اختياري، ومستوى الرؤية التلقائي هو true، أي مرئي.

إمكانية النقر

إذا كنت تريد التعامل مع الأحداث التي تم تنشيطها عندما ينقر المستخدم على سطح الأرض، اضبط هذا على true. ويمكنك تغيير هذه القيمة في أي وقت. والقيمة التلقائية هي false. في حال ضبط هذه السمة على true، سيتلقّى تطبيقك إشعارات على تم تسجيل GoogleMap.OnGroundOverlayClickListener حتى setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener).

العلامة

عنصر Object مرتبط بطبقة الأرض. على سبيل المثال، بإمكان Object ستحتوي على بيانات حول ما يمثله تراكب الأرض. وهذا أسهل من تخزين فصل Map<GroundOverlay, Object>. كمثال آخر، يمكنك ربط رقم تعريف String بما يتوافق مع رقم التعريف من مجموعة بيانات. حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android قراءة أو كتابة هذه الخاصية.

يجب استدعاء الطُرق في هذه الفئة في سلسلة واجهة مستخدم Android. وإذا لم يكن كذلك، سيتم طرح IllegalStateException في وقت التشغيل.

مثال

GoogleMap map = ...; // get a map.
 BitmapDescriptor imageDescriptor = ...; // get an image.
 LatLngBounds bounds = ...; // get a bounds
 // Adds a ground overlay with 50% transparency.
 GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
     .image(imageDescriptor)
     .positionFromBounds(bounds)
     .transparency(0.5));